Compartilhar via


Get-MsolScopedRoleMember

Obtém membros de uma função que recebem essa função em uma unidade administrativa.

Sintaxe

Get-MsolScopedRoleMember
   [-AdministrativeUnitObjectId <Guid>]
   [-RoleObjectId <Guid>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolScopedRoleMember
   [-AdministrativeUnitObjectId <Guid>]
   [-RoleObjectId <Guid>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-MsolScopedRoleMember obtém membros da função especificada que recebem essa função em uma unidade administrativa.

Exemplos

Exemplo 1: Obter membros da função administrador da conta de usuário

PS C:\> $WestCoastAu = Get-MsolAdministrativeUnit -SearchString "West Coast"
PS C:\> $UaAdmin = Get-MsolRole -RoleName "User Account Administrator"
PS C:\> Get-MsolScopedRoleMember -RoleObjectId $UaAdmin.ObjectId -AdministrativeUnitObjectId $WestCoastAu.ObjectId

Este exemplo obtém todos os membros da função Administrador de Conta de Usuário que tem como escopo a unidade administrativa chamada Costa Oeste.

Parâmetros

-AdministrativeUnitObjectId

Especifica a ID de objeto exclusiva da unidade administrativa. Se você não especificar esse parâmetro, esse cmdlet obterá administradores para todas as unidades administrativas.

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

-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 retornados por este cmdlet.

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

-RoleObjectId

Especifica a ID de objeto exclusiva da função da qual obter membros.

Tipo:Guid
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.Administration.RoleScopedMember

Esse cmdlet retorna objetos que contêm as seguintes informações:

  • DisplayName. O nome de exibição do membro de função com escopo.
  • Userprincipalname. O nome principal do usuário do membro de função com escopo.
  • Objectid. A ID exclusiva do membro da função com escopo.