Share via

Get-MsolRoleMember

  • Referência
Módulo:
MSOnline

Obtém membros de uma função.

Syntax

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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

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

Type:Int32
Position:Named
Default value:250
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemberObjectTypes

Especifica uma matriz de tipos de objeto membro.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleObjectId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 a ser pesquisada.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Saídas

Microsoft.Online.Administation.RoleMember

Este cmdlet retorna objetos de 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.