Partilhar via


Select-AzureADGroupIdsUserIsMemberOf

Seleciona os grupos dos quais um utilizador é membro.

Syntax

Select-AzureADGroupIdsUserIsMemberOf
      -ObjectId <String>
      -GroupIdsForMembershipCheck <GroupIdsForMembershipCheck>
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

Description

O cmdlet Select-AzureADGroupIdsUserIsMemberOf seleciona os grupos dos quais um utilizador é membro no Azure Actve Directory (AD).

Exemplos

Exemplo 1: obter a associação ao grupo de um grupo para um utilizador

PS C:\> $Groups = New-Object Microsoft.Open.AzureAD.Model.GroupIdsForMembershipCheck
PS C:\> $Groups.GroupIds = (Get-AzureADGroup -Top 1).ObjectId
PS C:\> $UserID = (Get-AzureADUser -Top 1).ObjectId
PS C:\> Select-AzureADGroupIdsUserIsMemberOf  -ObjectId $UserId -GroupIdsForMembershipCheck $Groups

OdataMetadata                                                                                   Value
-------------                                                                                   -----
https://graph.windows.net/85b5ff1e-0402-400c-9e3c-0f9e965325d1/$metadata#Collection(Edm.String) {093fc0e2-1d6e-4a1b-9bf8-effa0196f1f7}

O primeiro comando cria um objeto GroupIdsForMembershipCheck e, em seguida, armazena-o na variável $Groups.

O segundo comando obtém um ID para um grupo com o cmdlet Get-AzureADGroup (./Get-AzureADGroup.md) e, em seguida, armazena-o como uma propriedade de $Groups.

O terceiro comando obtém o ID de um utilizador com o cmdlet Get-AzureADUser (./Get-AzureADUser.md) e, em seguida, armazena-o na variável $UserId.

O comando final obtém a associação ao grupo de um grupo para um utilizador identificado pelo $UserId. Este cmdlet devolve um objeto oData. Para localizar os grupos de que este utilizador é membro, itere através do atributo Valor dos objetos oData devolvidos.

Parâmetros

-GroupIdsForMembershipCheck

Especifica uma matriz de IDs de objeto de grupo.

Tipo:GroupIdsForMembershipCheck
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

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

  • Continuar
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Especifica o ID de um utilizador (como UM UPN ou ObjectId) no Azure AD.

Tipo:String
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False