Partilhar via

Get-SCUserRole

  • Referência
Módulo:
VirtualMachineManager

Obtém uma função de usuário do VMM.

Sintaxe

Get-SCUserRole
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-UserRoleProfile <Profile>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Get-SCUserRole obtém uma ou mais funções de usuário do Virtual Machine Manager (VMM). O VMM usa a segurança baseada em função para definir os limites dentro dos quais os membros de uma determinada função de usuário podem operar e o conjunto de operações permitidas que os membros de uma função de usuário podem executar.

Para obter informações sobre como criar funções de usuário, digite Get-Help New-SCUserRole.

Para obter informações sobre como definir as propriedades de uma função de usuário, incluindo o escopo para administradores delegados e somente leitura e o escopo e as ações para usuários de autoatendimento, digite Get-Help Set-SCUserRole.

Exemplos

Exemplo 1: Obter todas as funções de usuário

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"

Este comando obtém todas as funções de usuário do VMM no servidor chamado VMMServer01.Contoso.com. O comando exibe informações sobre cada função de usuário.

Exemplo 2: Obter uma função de usuário por nome

PS C:\> Get-SCUserRole -Name "Administrator"

Este comando obtém o objeto de função de usuário chamado Administrador. O comando exibe informações sobre essa função de usuário.

Exemplo 3: Obter uma função de usuário por perfil

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"

Este comando obtém as funções de usuário do servidor chamado VMMServer01 que têm um perfil de função de usuário de SelfServiceUser. O comando exibe informações sobre essas funções de usuário.

Exemplo 4: Exibir propriedades e outras informações sobre objetos de função de usuário

PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member

O primeiro comando obtém todos os objetos de função de usuário no servidor chamado VMMServer01 e, em seguida, armazena esses objetos na variável $UserRoles.

O segundo comando passa cada objeto de função de usuário em $UserRoles para o cmdlet Select-Object, que exibe o nome, o perfil de função de usuário, a função de usuário pai e a nuvem para cada função de usuário

O comando final passa cada função de usuário em $UserRoles para o cmdlet Get-Member, que exibe o tipo .NET para cada função de usuário e os métodos e propriedades associados a cada tipo de função de usuário.

Parâmetros

-ID

Especifica a ID exclusiva para a função de usuário que esse cmdlet obtém.

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

-Name

Especifica o nome da função de usuário do VMM que esse cmdlet obtém.

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

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

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

-UserRoleProfile

Especifica o tipo de perfil que é a base para as funções de usuário que esse cmdlet obtém. Os valores aceitáveis para este parâmetro são:

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Tipo:Profile
Valores aceites:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica o servidor VMM no qual esse cmdlet obtém funções de usuário.

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

Saídas

UserRole

Este cmdlet retorna um objeto UserRole.