Add-EntraDirectoryRoleMember

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

Adiciona um membro a uma função de diretório.

Sintaxe

Default (Default) 

Add-EntraDirectoryRoleMember

    -DirectoryRoleId <String>
    -MemberId <String>
    [<CommonParameters>]

Description

O Add-EntraDirectoryRoleMember cmdlet adiciona um membro a uma função Microsoft Entra ID.

Em cenários delegados, o usuário conectado deve ter uma função de Microsoft Entra com suporte ou uma função personalizada com as permissões necessárias. As funções mínimas necessárias para esta operação são:

  • Administrador de Função Privilégiada

Exemplos

Exemplo 1: Adicionar um membro a uma função de Microsoft Entra ID

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "DisplayName eq 'Helpdesk Administrator'"
$user = Get-EntraUser -UserId 'SawyerM@Contoso.com'
Add-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id -MemberId $user.Id

Este exemplo adiciona um membro a uma função de diretório.

  • DirectoryRoleId O parâmetro especifica a ID da função de diretório à qual o membro é adicionado. Use o comando Get-EntraDirectoryRole para recuperar os detalhes da função de diretório.
  • MemberIdO parâmetro especifica a ID de Microsoft Entra ID objeto a ser atribuído como proprietário/gerente/membro.

Parâmetros

-DirectoryRoleId

Especifica a ID de uma função de diretório em Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-MemberId

Especifica a ID do objeto Microsoft Entra ID a ser atribuído como proprietário/gerente/membro.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:RefObjectId

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.