Compartilhar via

Get-SCUserRole

  • Referência
Módulo:
VirtualMachineManager

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

Syntax

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 VMM (Virtual Machine Manager). 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"

Esse 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"

Esse 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"

Esse comando obtém as funções de usuário que o servidor chamado VMMServer01 tem um perfil de função de usuário do 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 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 este cmdlet obtém.

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

-Name

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

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

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

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 esse parâmetro são:

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

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

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

Saídas

UserRole

Este cmdlet retorna um objeto UserRole .