New-SCUserRole
建立 VMM 使用者群組的使用者角色。
Syntax
New-SCUserRole
[-VMMServer <ServerConnection>]
[-Name] <String>
-UserRoleProfile <Profile>
[-ID <Guid>]
[-JobGroup <Guid>]
[-Description <String>]
[-ParentUserRole <UserRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
New-SCUserRole Cmdlet 會為一組 Virtual Machine Manager (VMM) 使用者建立使用者角色。 您可以建立下列使用者角色：委派的系統管理員、Read-Only系統管理員、虛擬機器系統管理員和Self-Service使用者。 只有一個系統管理員角色存在。 您無法建立另一個系統管理員角色，或刪除現有的角色。
如果您是委派系統管理員使用者角色的成員，您可以建立使用者角色。 不過，新使用者角色的範圍必須是其父使用者角色範圍的子集。
建立使用者角色之後，您可以使用 Set-SCUserRole Cmdlet 來重新命名使用者角色、新增或移除成員，以及新增或修改角色成員可以管理的物件範圍。 針對Self-Service使用者角色，您可以指定Self-Service使用者角色成員可以在其虛擬機器上採取的動作，而且您可以定義配額來限制虛擬機器自助使用者可以建立的虛擬機器數目。 雖然您無法建立或移除系統管理員角色或限制其範圍，但您可以使用 Set-SCUserRole 將成員新增或移除至該角色。
如需如何修改使用者角色屬性的資訊，請輸入 Get-Help Set-SCUserRole 。
範例
範例 1：建立委派的系統管理員使用者角色
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"此命令會建立名為 ContosoDelegatedAdmin 的委派系統管理員使用者角色、提供 Contoso.com 網域的委派系統管理員描述，並使用 UserRoleProfile 參數將使用者角色類型指定為委派系統管理員。
範例 2：建立自助使用者角色
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"此命令會建立名為 ContosoSelfServiceUsers 的新使用者角色、使用 UserRoleProfile 參數將新的使用者角色類型指定為Self-Service使用者，並將新的使用者角色物件儲存在 $SelfServiceRole 變數中。
範例 3：建立虛擬機器系統管理員角色
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"此命令會建立名為 VirtualMachineAdmin的虛擬機器系統管理員使用者角色、提供 「contoso.com 網域的虛擬機器系統管理員」描述，並使用 UserRoleProfile 參數將使用者角色類型指定為 VMAdmin。
參數
-Description
指定使用者角色的描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
指定新使用者角色的唯一識別碼。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
指定一系列命令的識別碼，這些命令會在包含相同作業群組識別碼的執行的最後一個命令之前，以集合的形式執行。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定追蹤和儲存作業進度的變數。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定新使用者角色的名稱。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定使用者名稱。 這個 Cmdlet 會代表此參數所指定的使用者運作。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 會代表此參數所指定的使用者角色運作。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentUserRole
將現有的 VMM 使用者角色指定為新使用者角色的父系。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行，讓控制項立即返回命令殼層。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
指定新使用者角色的基礎配置檔案類型。 此參數可接受的值為：
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Type: | Profile |
| Accepted values: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
指定此 Cmdlet 建立使用者角色的 VMM 伺服器。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸出
UserRole
此 Cmdlet 會傳回 UserRole 物件。