Select-EntraGroupIdsUserIsMemberOf

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

Seleciona os grupos a que um utilizador pertence.

Sintaxe

Default (Predefinição) 

Select-EntraGroupIdsUserIsMemberOf

    -UserId <String>
    -GroupIdsForMembershipCheck <GroupIdsForMembershipCheck>
    [<CommonParameters>]

Descrição

O Select-EntraGroupIdsUserIsMemberOf cmdlet seleciona os grupos a que um utilizador pertence no Microsoft Entra ID.

Exemplos

Exemplo 1: Obtenha a pertença a um grupo para um utilizador

Connect-Entra -Scopes 'Application.Read.All'
$myGroup = Get-EntraGroup -Filter "DisplayName eq '<Group-DisplayName>'"
$UserId = 'SawyerM@contoso.com'
$groups = New-Object Microsoft.Open.AzureAD.Model.GroupIdsForMembershipCheck
$groups.GroupIds = $myGroup.Id
Select-EntraGroupIdsUserIsMemberOf -UserId 'SawyerM@contoso.com' -GroupIdsForMembershipCheck $groups

aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Este exemplo recupera a pertença a um grupo para um utilizador.

  • -UserId o parâmetro especifica o Id do objeto de um utilizador (como UserPrincipalName ou ObjectId).
  • -GroupIdsForMembershipCheck o parâmetro especifica o grupo Object Ids.

Parâmetros

-GroupIdsForMembershipCheck

Especifica um array de IDs de objetos de grupo.

Propriedades dos parâmetros

Tipo:GroupIdsForMembershipCheck
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-UserId

Especifica o ID de um utilizador (como UserPrincipalName ou ObjectId) no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto

Conjuntos de parâmetros

(All)
Posto: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.