Select-AzureADGroupIdsUserIsMemberOf
Seleciona os grupos dos quais um usuário é membro.
Sintaxe
Default (Predefinição)
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 Azure Actve Directory (AD).
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, em seguida, armazena-o 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, em seguida, armazena-a na variável $UserId.
O comando final obtém a associação de grupo de um grupo para um usuário identificado por $UserId. Este cmdlet retorna um objeto oData. Para localizar os grupos dos quais esse usuário é membro, itere através do atributo Value dos objetos oData retornados.
Parâmetros
-GroupIdsForMembershipCheck
Especifica uma matriz de IDs de objeto de grupo.
Propriedades dos parâmetros
| Tipo: | GroupIdsForMembershipCheck |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação. Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Pergunte
- Continuar em Silêncio
- Parar
- Suspender
Propriedades dos parâmetros
| Tipo: | ActionPreference |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Infa |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InformationVariable
Especifica uma variável de informação.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | • |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ObjectId
Especifica a ID de um usuário (como um UPN ou ObjectId) no Azure AD.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| 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.