Partilhar via

Get-SCUserRole

  • Referência
Módulo:
VirtualMachineManager

Obtém um papel de utilizador 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 utilizador do Gestor de Máquinas Virtuais (VMM). O VMM utiliza a segurança baseada em funções para definir os limites dentro dos quais os membros de uma determinada função de utilizador podem operar e o conjunto de membros de operações permitidos de uma função de utilizador pode desempenhar.

Para obter informações sobre a criação de funções de utilizador, escreva Get-Help New-SCUserRole.

Para obter informações sobre a definição das propriedades de uma função de utilizador, incluindo o âmbito para administradores delegados e apenas de leitura e o âmbito e ações para utilizadores de self-service, tipo Get-Help Set-SCUserRole.

Exemplos

Exemplo 1: Obtenha todas as funções de utilizador

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

Este comando obtém todas as funções de utilizador VMM no servidor denominado VMMServer01.Contoso.com. O comando apresenta informações sobre cada função de utilizador.

Exemplo 2: Obter uma função de utilizador pelo nome

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

Este comando obtém o objeto da função do utilizador chamado Administrador. O comando apresenta informações sobre a função do utilizador.

Exemplo 3: Obtenha uma função de utilizador por perfil

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

Este comando obtém as funções de utilizador do servidor chamado VMMServer01 que têm um perfil de função de utilizador do SelfServiceUser. O comando apresenta informações sobre estas funções do utilizador.

Exemplo 4: Exibir propriedades e outras informações sobre objetos de função do utilizador

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 do utilizador no servidor chamado VMMServer01 e, em seguida, armazena esses objetos na variável $UserRoles.

O segundo comando transmite cada objeto de função do utilizador em $UserRoles para o cmdlet Select-Object, que depois exibe o nome, perfil de função do utilizador, papel de utilizador principal e nuvem para cada papel de utilizador

O comando final passa cada papel de utilizador em $UserRoles para o cmdlet Get-Member , que exibe o tipo .NET para cada papel de utilizador e os métodos e propriedades associados a cada tipo de papel do utilizador.

Parâmetros

-ID

Especifica o ID único para a função de utilizador 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 utilizador VMM que este 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 utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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 utilizador que este cmdlet obtém. Os valores aceitáveis para este parâmetro são:

  • DelegadoAdmin
  • 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 este cmdlet obtém as funções do utilizador.

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

Saídas

UserRole

Este cmdlet devolve um objeto UserRole .