New-SCUserRole
为一组 VMM 用户创建用户角色。
语法
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>] 说明
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
指定新用户角色的唯一 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 提示) 的性能和资源优化提示的 ID。 此参数允许你审核 PRO 提示。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行，以便控件立即返回到命令 shell。
| 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 对象。