Set-SCUserRole

語法

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

Set-SCUserRole Cmdlet 會修改現有 Virtual Machine Manager （VMM） 使用者角色的設定。 您可以修改的設定取決於 VMM 使用者角色的類型。

使用者角色的類型如下所示：

VMM 系統管理員（系統管理員）

您可以將成員新增至系統管理員使用者角色，或從系統管理員使用者角色中移除成員。 您無法限制此角色成員可以管理的物件範圍。

委派管理員（DelegatedAdmin）

您可以將成員新增至委派的系統管理員使用者角色，並從中移除成員。 您可以展開或限制委派系統管理員使用者角色的範圍。 您可以授與此使用者角色許可權的成員，以管理私人雲端和主機群組中的所有物件。 您可以允許使用者管理儲存在連結庫伺服器上的所有物件。 在該架構中，您無法限制委派系統管理員使用者角色成員可執行的動作。

Read-Only 系統管理員 （ReadOnlyAdmin）

您可以將成員新增至系統管理員使用者角色，並從 Read-Only 移除成員。 您可以展開或限制 Read-Only 系統管理員使用者角色的範圍。 不過，使用者角色的成員只能檢視其指派範圍內對象的屬性、狀態和作業狀態。 它們無法修改任何物件。

Self-Service 使用者 （SelfServiceUser）

您可以將成員新增至或移除 Self-Service 使用者角色的成員。 您可以展開或限制 Self-Service 使用者角色成員的範圍和動作。 您可以授與 Self-Service 使用者角色許可權的成員，以管理私人雲端中的所有物件。 您可以授與建立虛擬機的許可權、將虛擬機儲存在虛擬機位於雲端的預存虛擬機路徑的許可權，以及使用範本物件來建立虛擬機的許可權。 在該架構中，您可以授與自助使用者可以採取的 Self-Service 使用者角色動作成員。 您也可以藉由設定套用至每個使用者或所有使用者的配額，來限制自助使用者可以建立的虛擬機數目。

您可以授與自助使用者的動作包括下列各項：

• AllowLocalAdmin。 授與虛擬機上的使用者本機系統管理員許可權。
• 作者。 撰寫虛擬機和服務範本。
• CanShare。 與其他 Self-Service 用戶共享資源。
• CanReceive。 從其他 Self-Service 使用者接收資源。
• 檢查站。 建立和管理虛擬機檢查點。
• CheckpointRestoreOnly。 只能還原檢查點。
• 創造。 僅從範本建立虛擬機和服務。
• CreateFromVHDOrTemplate。 從虛擬硬碟 （VHD） 檔案或範本建立虛擬機和服務。
• PauseAndResume。 暫停和繼續虛擬機和服務。
• RemoteConnect。 從遠端連線到虛擬機。
• 刪除。 拿掉虛擬機和服務。
• 救。 儲存虛擬機和服務。
• 關閉。 關閉虛擬機。
• 開始。 啟動虛擬機和服務。
• 停。 停止虛擬機和服務。
• 商店。 將虛擬機儲存在連結庫中。

範例

範例 1：將使用者新增至 VMM 系統管理員使用者角色

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

第一個命令會取得名為 Administrator 的使用者角色對象，然後將該物件儲存在$UserRole變數中。

第二個命令會將 User01 和 User02 新增至系統管理員使用者角色。 這兩個使用者都是 Contoso.com 網域的成員。

範例 2：使用管線將使用者新增至系統管理員角色

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

此命令會從 VMMServer01 取得所有使用者角色對象、選取其配置檔為 Administrator 的使用者角色對象，然後將 User03 新增至系統管理員使用者角色。

範例 3：藉由將雲端新增至其範圍來修改現有的 Self-Service 使用者角色

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

第一個命令會取得名為 Cloud02 的雲端對象，然後將該物件儲存在$Cloud 變數中。

第二個命令會取得名為 ContosoSelfServiceUsers 的使用者角色對象，然後將物件儲存在$UserRole配置檔中。

最後一個命令會藉由將儲存在 $Cloud 中的雲端新增至其範圍，來修改儲存在 $UserRole 中的使用者角色範圍。

範例 4：從系統管理員使用者角色移除指定的使用者

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

第一個命令會取得名為 Administrator 的使用者角色對象，然後將該物件儲存在$UserRole變數中。

第二個命令會從系統管理員使用者角色中移除User01。 User01 是 Contoso.com 網域的成員。

範例 5：將雲端新增至 Self-Service 使用者角色的範圍

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

第一個命令會取得名為 Cloud03 的雲端對象，然後將該物件儲存在$Cloud 變數中。

第二個命令會取得名為 ContosoSelfServiceUsers 的使用者角色對象，然後將該使用者角色對象傳遞給目前的 Cmdlet。 此 Cmdlet 會將儲存在 $Cloud 中的雲端新增至使用者角色。

範例 6：修改 Self-Service 使用者角色成員在其虛擬機上可以採取的動作

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

第一個命令會取得名為 ContosoSelfServiceUsers 之 VMMServer01 上的使用者角色對象，然後將物件儲存在$UserRole變數中。

第二個命令會修改儲存在 $UserRole 中之使用者角色成員的許可權，以允許 Creation、PauseAndResume、Stop、AllowLocalAdmin 和 Store 許可權。

參數

-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

輸出

UserRole

備註

• 若要列出您可以為自助使用者指定的所有可用許可權，請輸入下列命令：

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

相關連結

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