Get-EntraDirectoryRoleMember

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

Obtém membros de uma função de diretório.

Sintaxe

Default (Default) 

Get-EntraDirectoryRoleMember

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

Description

O Get-EntraDirectoryRoleMember cmdlet recupera os membros de uma função de diretório em Microsoft Entra ID. Para obter os membros de uma função de diretório específica, especifique o DirectoryRoleId. Use o Get-EntraDirectoryRole cmdlet para obter o DirectoryRoleId valor.

Em cenários delegados com contas corporativas ou de estudante, 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 seguintes funções com menos privilégios são suportadas para esta operação:

  • Administrador de usuários
  • Administrador de assistência técnica
  • Administrador de suporte a serviço
  • Administrador de cobrança
  • Leitores de diretório
  • Gravadores de diretório
  • Administrador de Aplicativos
  • Leitor de Segurança
  • Administrador de segurança
  • Administrador de Função Privilégiada
  • Administrador de Aplicativos na Nuvem

Exemplos

Exemplo 1: Obter membros por ID da função

Connect-Entra -Scopes 'RoleManagement.Read.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "displayName eq 'Helpdesk Administrator'"
Get-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id | Select Id, DisplayName, '@odata.type', CreatedDateTime

id                                   displayName     @odata.type            createdDateTime
--                                   -----------     -----------            ---------------
bbbbbbbb-7777-8888-9999-cccccccccccc Debra Berger    #microsoft.graph.user  10/7/2024 12:31:57 AM
cccccccc-2222-3333-4444-dddddddddddd Contoso Group   #microsoft.graph.group 11/12/2024 9:59:43 AM

Este exemplo recupera os membros da função especificada.

  • -DirectoryRoleId o parâmetro especifica a ID da função de diretório.

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

-Property

Especifica as propriedades a serem retornadas.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Select

Conjuntos de parâmetros

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