Get-SCUserRole
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-MemberO 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 .