Partilhar via

Get-MsolRoleMember

  • Referência
Módulo:
MSOnline

Obtém membros de uma função.

Sintaxe

Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-MsolRoleMember obtém membros da função especificada.

Exemplos

Exemplo 1: Obter membros de uma função

PS C:\> $Role = Get-MsolRole -RoleName "%Role Name%"
PS C:\> $RoleMembers = Get-MsolRoleMember -RoleObjectId $Role.ObjectId

Este comando devolve todos os membros da função especificada. O comando armazena os resultados na variável $RoleMembers.

Parâmetros

-All

Indica que este cmdlet devolve todos os resultados que encontrar. Não especifique este parâmetro e o parâmetro MaxResults .

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxResults

Especifica o número máximo de resultados que este cmdlet devolve. O valor predefinido é 250.

Tipo:Int32
Position:Named
Default value:250
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MemberObjectTypes

Especifica uma matriz de tipos de objeto membro.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RoleObjectId

Especifica o ID exclusivo da função a partir da qual pretende remover membros.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SearchString

Especifica uma cadeia. Este cmdlet devolve objetos com um nome a apresentar ou endereço de e-mail que começam com esta cadeia. A cadeia a procurar.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TenantId

Especifica o ID exclusivo do inquilino no qual efetuar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Microsoft.Online.Administation.RoleMember

Este cmdlet devolve objetos de membro da função que contêm as seguintes informações:

  • DisplayName. O nome a apresentar do membro da função.

  • EmailAddress. O endereço de e-mail do membro da função.

  • Está Licenciado. Quer o utilizador tenha ou não licença.

  • LastDirSyncTime. A data e hora em que este membro foi sincronizado pela última vez.

  • ObjectId. O ID exclusivo do membro.

  • OverallProvisioningStatus. O estado de aprovisionamento deste utilizador.

  • RoleMemberType. O tipo de membro da função. Atualmente, apenas o "Utilizador" é suportado.

  • ValidationStatus. Se existem ou não erros com este membro do grupo.