Select-AzureADGroupIdsUserIsMemberOf
Seleciona os grupos dos quais um usuário é membro.
Sintaxe
Default (Padrã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 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 a armazena na variável $UserId.
O comando final obtém a associação de grupo de um grupo para um usuário identificado por $UserId. Esse cmdlet retorna um objeto oData. Para localizar os grupos dos quais esse usuário é membro, itere por meio do atributo Value dos objetos oData retornados.
Parâmetros
-GroupIdsForMembershipCheck
Especifica uma matriz de IDs de objeto de grupo.
Propriedades do parâmetro
| Tipo: | GroupIdsForMembershipCheck |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação. Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Consulta
- SilentlyContinue
- Parar
- Suspender
Propriedades do parâmetro
| Tipo: | ActionPreference |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | infa |
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 |
-InformationVariable
Especifica uma variável de informação.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Iv |
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 |
-ObjectId
Especifica a ID de um usuário (como um UPN ou ObjectId) no Azure AD.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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.