Select-AzureADGroupIdsUserIsMemberOf

Módulo:

AzureAD

Seleciona os grupos dos quais um usuário é membro.

Syntax

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

Description

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

Exemplos

Exemplo 1: Obter a associação de grupo de um grupo para um usuário

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 o armazena na variável $Groups.

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

O terceiro comando obtém a ID de um usuário usando o cmdlet Get-AzureADUser (./Get-AzureADUser.md)e o armazena na variável $UserId.

O comando final obtém a associação de grupo de um grupo para um usuário identificado pelo $UserId. Esse cmdlet retorna um objeto oData. Para localizar os grupos dos quais esse usuário é membro, itera por meio do atributo Value dos objetos oData retornados.

Parâmetros

-GroupIdsForMembershipCheck

Especifica uma matriz de IDs de objeto de grupo.

Type:	GroupIdsForMembershipCheck
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InformationAction

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

• Continuar
• Ignorar
• Consultar
• SilentlyContinue
• Stop
• Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Especifica uma variável de informações.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

Especifica a ID de um usuário (como UPN ou ObjectId) em Azure AD.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False