Partilhar via


Enable-AzureADDirectoryRole

Ativa uma função de diretório existente no Azure Ative Directory.

Sintaxe

Default (Predefinição)

Enable-AzureADDirectoryRole
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [-RoleTemplateId <String>]
    [<CommonParameters>]

Description

O cmdlet Enable-AzureADDirectoryRole ativa uma função de diretório existente no Azure Ative Directory.

Exemplos

Exemplo 1: Habilitar uma função de diretório

# Retrieve the Template Role object for the Guest Inviter role
$InviterRole = Get-AzureADDirectoryRoleTemplate | Where-Object {$_.DisplayName -eq "Guest Inviter"}

# Inspect the $Inviter variable to make sure we found the correct template role
$InviterRole

ObjectId                             DisplayName   Description
--------                             -----------   -----------
95e79109-95c0-4d8e-aee3-d01accf2d47b Guest Inviter Guest Inviter has access to invite guest users.

# Enable the Inviter Role
Enable-AzureADDirectoryRole -RoleTemplateId $InviterRole.ObjectId

ObjectId                             DisplayName   Description
--------                             -----------   -----------
03618579-3c16-4765-9539-86d9163ee3d9 Guest Inviter Guest Inviter has access to invite guest users.

O primeiro comando obtém uma função de convidado que tem o nome de exibição Guest Inviter usando o cmdlet Get-AzureADDirectoryRoleTemplate (./Get-AzureADDirectoryRoleTemplate.md). O comando armazena Guest Inviter na variável $InviterRole.

O segundo comando exibe o conteúdo de $InviterRole.

O comando final habilita a função de diretório no $InviterRole.

Parâmetros

-InformationAction

Especifica como esse cmdlet responde a um evento de informação. Os valores aceitáveis para este parâmetro são:

  • Continuar
  • Ignorar
  • Pergunte
  • Continuar em Silêncio
  • Parar
  • Suspender

Propriedades dos parâmetros

Tipo:ActionPreference
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Infa

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InformationVariable

Especifica uma variável na qual armazenar uma mensagem de evento de informação.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RoleTemplateId

A ID do modelo de Função a ser habilitada

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Notas

Consulte o guia de migração de Enable-AzureADDirectoryRole para o Microsoft Graph PowerShell.