Set-SCUserRole

Syntax

Set-SCUserRole
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-AddMember <String[]>]
   [-RemoveMember <String[]>]
   [-Permission <SelfServicePermission[]>]
   [-UserRoleDataPath <String>]
   [-RemoveLibraryStoreSharePath]
   [-ShowPROTips <Boolean>]
   [-AddScope <ClientObject[]>]
   [-RemoveScope <ClientObject[]>]
   [-Description <String>]
   [-VMNetworkMaximum <UInt16>]
   [-VMNetworkMaximumPerUser <UInt16>]
   [-RemoveVMNetworkMaximum]
   [-RemoveVMNetworkMaximumPerUser]
   [-VPNConnectionMaximum <UInt16>]
   [-VPNConnectionMaximumPerUser <UInt16>]
   [-RemoveVPNConnectionMaximum]
   [-RemoveVPNConnectionMaximumPerUser]
   [-NATConnectionMaximum <UInt16>]
   [-NATConnectionMaximumPerUser <UInt16>]
   [-RemoveNATConnectionMaximum]
   [-RemoveNATConnectionMaximumPerUser]
   [-VMNetworkVPNMaximumBandwidthInKbps <UInt64>]
   [-VMNetworkVPNMaximumBandwidthOutKbps <UInt64>]
   [-RemoveVMNetworkVPNMaximumBandwidthIn]
   [-RemoveVMNetworkVPNMaximumBandwidthOut]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCUserRole modifica as definições para uma função de utilizador virtual do Gestor de Máquinas Virtuais (VMM) existente. As definições que pode modificar dependem do tipo de função do utilizador VMM.

Os tipos de funções de utilizador são os seguintes:

Administrador VMM (Administrador)

Pode adicionar membros ou remover membros da função de utilizador do Administrador. Não é possível limitar o âmbito de aplicação de objetos que os membros desta função podem gerir.

Administrador Delegado (DelegadoAdmin)

Pode adicionar membros e remover membros de uma função de utilizador do Administrador Delegado. Pode expandir ou restringir o âmbito de aplicação de uma função de utilizador do Administrador Delegado. Pode conceder aos membros desta função de utilizador permissão para gerir todos os objetos em nuvens privadas e grupos de anfitriões. Pode permitir que os utilizadores gerem todos os objetos armazenados nos servidores da biblioteca. Neste âmbito, não é possível limitar as ações que os membros da função de utilizador do Administrador Delegado podem desempenhar.

Administrador Read-Only (ReadOnlyAdmin)

Pode adicionar membros e remover membros de uma função de utilizador do administrador Read-Only. Pode expandir ou restringir o âmbito de aplicação de uma função de utilizador do Administrador Read-Only. No entanto, os membros da função utilizadora só podem visualizar as propriedades, o estado e o estado de trabalho dos objetos dentro do âmbito atribuído. Não podem modificar nenhum dos objetos.

Self-Service Utilizador (SelfServiceUser)

Pode adicionar membros ou remover membros de uma função de utilizador Self-Service. Pode expandir ou limitar o âmbito e as ações dos membros de uma Self-Service papel de utilizador. Pode conceder aos membros de uma Self-Service permissão de papel de utilizador para gerir todos os objetos em nuvens privadas. Pode conceder permissão para criar máquinas virtuais, permissão para armazenar máquinas virtuais no caminho da máquina virtual armazenada na nuvem em que a máquina virtual está acesa, e permissão para usar objetos de modelo para criar máquinas virtuais. Neste âmbito, pode conceder aos membros de uma Self-Service ações de função de utilizador que os utilizadores de self-service podem tomar. Também pode limitar o número de máquinas virtuais que os utilizadores de self-service podem criar, definindo uma quota que se aplica a cada utilizador ou a todos os utilizadores coletivamente.

As ações que pode conceder a um utilizador de self-service incluem o seguinte:

• Permitir aLocalAdmin. Concede direitos de administrador local aos utilizadores em máquinas virtuais.
• Um autor. Autor de modelos de máquina virtual e de serviço.
• CanShare. Partilhe recursos com outros Self-Service utilizadores.
• PodeReceive. Receba recursos de outros Self-Service utilizadores.
• Posto de controlo. Criar e gerir postos de controlo de máquinas virtuais.
• CheckpointRestoreOnly. Só pode restaurar um posto de controlo.
• Criar. Crie máquinas e serviços virtuais apenas a partir de modelos.
• CreateFromVHDOrTemplate. Crie máquinas e serviços virtuais a partir de ficheiros ou modelos de disco rígido virtual (VHD).
• PauseAndResume. Faça uma pausa e retome as máquinas e serviços virtuais.
• Controlo remoto. Ligue-se remotamente a máquinas virtuais.
• Remover. Remova máquinas e serviços virtuais.
• Guarde. Poupe máquinas e serviços virtuais.
• Desligado. Desligue as máquinas virtuais.
• Iniciar. Inicie máquinas e serviços virtuais.
• Pare, não me deixe. Pare máquinas e serviços virtuais.
• A loja. Guarde máquinas virtuais numa biblioteca.

Exemplos

Exemplo 1: Adicionar utilizadores à função de utilizador do administrador VMM

PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddMember "Contoso\User01","Contoso\User02"

O primeiro comando obtém o objeto da função do utilizador chamado Administrador e, em seguida, armazena esse objeto na variável $UserRole.

O segundo comando adiciona User01 e User02 à função de utilizador do Administrador. Ambos os utilizadores são membros do domínio Contoso.com.

Exemplo 2: Adicionar os utilizadores à função de Administrador utilizando o pipeline

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" | where { $_.Profile -eq "Administrator" } | Set-SCUserRole -AddMember "Contoso\User03"

Este comando obtém todos os objetos de função do utilizador do VMMServer01, seleciona os objetos da função do utilizador cujo perfil é Administrador e, em seguida, adiciona User03 à função de utilizador do Administrador.

Exemplo 3: Modificar uma função de utilizador Self-Service existente adicionando uma nuvem ao seu âmbito

PS C:\> $Cloud = Get-SCCloud -Name "Cloud02"
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddScope $Cloud

O primeiro comando recebe o objeto de nuvem chamado Cloud02, e depois armazena esse objeto na variável $Cloud.

O segundo comando obtém o objeto da função do utilizador chamado ContosoSelfServiceUsers e, em seguida, armazena o objeto no perfil $UserRole.

O último comando modifica o âmbito da função do utilizador armazenada em $UserRole adicionando a nuvem armazenada em $Cloud ao seu âmbito.

Exemplo 4: Remover o utilizador especificado da função de utilizador do Administrador

PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -RemoveMember "Contoso\User01"

O primeiro comando obtém o objeto da função do utilizador chamado Administrador e, em seguida, armazena esse objeto na variável $UserRole.

O segundo comando remove o Utilizador01 da função de utilizador do Administrador. User01 é um membro do domínio Contoso.com.

Exemplo 5: Adicionar uma nuvem ao âmbito de uma Self-Service papel de utilizador

PS C:\> $Cloud = Get-SCCloud -Name "Cloud03"
PS C:\> Get-SCUserRole -Name "ContosoSelfServiceUsers" | Set-SCUserRole -AddScope $Cloud

O primeiro comando recebe o objeto de nuvem chamado Cloud03, e depois armazena esse objeto na variável $Cloud.

O segundo comando obtém o objeto da função do utilizador chamado ContosoSelfServiceUsers e, em seguida, passa esse objeto de papel de utilizador para o cmdlet atual. Este cmdlet adiciona a nuvem armazenada em $Cloud à função de utilizador.

Exemplo 6: Modificar as ações que os membros de um Self-Service papel de utilizador podem assumir nas suas máquinas virtuais

PS C:\> $UserRole = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -Permission "Create,PauseAndResume,Stop,AllowLocalAdmin,Store"

O primeiro comando obtém o objeto da função de utilizador no VMMServer01 chamado ContosoSelfServiceUsers e, em seguida, armazena o objeto na variável $UserRole.

O segundo comando modifica as permissões para os membros da função de utilizador armazenadas em $UserRole para permitir permissões de Criação, PauseAndResume, Stop, AllowLocalAdmin e Store.

Parâmetros

-AddMember

-AddScope

-Description

-JobGroup

-JobVariable

-Name

-NATConnectionMaximum

-NATConnectionMaximumPerUser

-OnBehalfOfUser

-OnBehalfOfUserRole

-Permission

-PROTipID

-RemoveLibraryStoreSharePath

-RemoveMember

-RemoveNATConnectionMaximum

-RemoveNATConnectionMaximumPerUser

-RemoveScope

-RemoveVMNetworkMaximum

-RemoveVMNetworkMaximumPerUser

-RemoveVMNetworkVPNMaximumBandwidthIn

-RemoveVMNetworkVPNMaximumBandwidthOut

-RemoveVPNConnectionMaximum

-RemoveVPNConnectionMaximumPerUser

-RunAsynchronously

-ShowPROTips

-UserRole

-UserRoleDataPath

-VMMServer

-VMNetworkMaximum

-VMNetworkMaximumPerUser

-VMNetworkVPNMaximumBandwidthInKbps

-VMNetworkVPNMaximumBandwidthOutKbps

-VPNConnectionMaximum

-VPNConnectionMaximumPerUser

Saídas

UserRole

Notas

• Para listar todas as permissões disponíveis que possa especificar para utilizadores de self-service, digite o seguinte comando:

PS C:\> [enum]::GetValues([Microsoft.VirtualManager.Remoting.SelfServicePermission])

Ligações Relacionadas

• Get-SCCloud
• Get-SCUserRole
• Grant-SCResource
• New-SCUserRole
• Remove-SCUserRole
• Revoke-SCResource