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

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

Parâmetros

-All

Indica que esse cmdlet retorna todos os resultados encontrados. Não especifique esse parâmetro e o parâmetro MaxResults .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxResults

Especifica o número máximo de resultados que esse cmdlet retorna. O valor padrão é 250.

Tipo:Int32
Cargo:Named
Valor padrão:250
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MemberObjectTypes

Especifica uma matriz de tipos de objeto membro.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RoleObjectId

Especifica a ID exclusiva da função da qual remover membros.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SearchString

Especifica uma cadeia de caracteres. Esse cmdlet retorna objetos com um nome de exibição ou endereço de email que começam com essa cadeia de caracteres. A cadeia de caracteres na qual pesquisar.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantId

Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Microsoft.Online.Administation.RoleMember

Esse cmdlet retorna objetos membro de função que contêm as seguintes informações:

  • DisplayName. O nome de exibição do membro da função.

  • Emailaddress. O endereço de email do membro da função.

  • IsLicensed. Se o usuário é ou não licenciado.

  • LastDirSyncTime. A data e a hora da última sincronização deste membro.

  • Objectid. A ID exclusiva do membro.

  • OverallProvisioningStatus. O status de provisionamento deste usuário.

  • RoleMemberType. O tipo de membro de função. Atualmente apenas o "Usuário" tem suporte.

  • ValidationStatus. Se tiver ou não algum erro com este membro do grupo.