Enable-EntraDirectoryRole

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Ativa um papel de diretório existente no Microsoft Entra ID.

Sintaxe

Default (Predefinição) 

Enable-EntraDirectoryRole

    [-RoleTemplateId <String>]
    [<CommonParameters>]

Descrição

O Enable-EntraDirectoryRole cmdlet ativa um papel de diretório existente no Microsoft Entra ID.

Os Administradores da Empresa e os papéis padrão do diretório de utilizadores (Utilizador, Utilizador Convidado e Utilizador Convidado Restrito) são ativados por defeito. Para aceder e atribuir membros a outros papéis de diretório, deve primeiro ativá-los usando o respetivo ID do modelo de função de diretório.

Em cenários delegados, o utilizador iniciado deve ter um papel Microsoft Entra suportado ou um papel personalizado com as permissões necessárias. Os papéis mínimos exigidos para esta operação são:

  • Administrador de Função Privilegiada

Exemplos

Exemplo 1: Ativar um papel de diretório

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$guestRole = Get-EntraDirectoryRoleTemplate | Where-Object {$_.DisplayName -eq 'Guest Inviter'}
Enable-EntraDirectoryRole -RoleTemplateId $guestRole.Id

DeletedDateTime Id                                   Description                                      DisplayName   RoleTemplateId
--------------- --                                   -----------                                      -----------   --------------
                b5baa59b-86ab-4053-ac3a-0396116d1924 Guest Inviter has access to invite guest users.  Guest Inviter 92ed04bf-c94a-4b82-9729-b799a7a4c178

O exemplo mostra como ativar o papel de diretório.

Podes usar Get-EntraDirectoryRoleTemplate para ativar um papel específico de diretório.

  • RoleTemplateId o parâmetro especifica o ID do modelo de função a ativar.

Parâmetros

-RoleTemplateId

O ID do modelo de Função para ativar.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto: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