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
参数
-Description
指定用户角色的说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ID
指定新用户角色的唯一 ID。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-JobGroup
指定一系列命令的标识符，这些命令在包含同一作业组标识符运行的最后一个命令之前作为集运行。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-JobVariable
指定在其中跟踪和存储作业进度的变量。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定新用户角色的名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-OnBehalfOfUser
指定用户名。 此 cmdlet 代表此参数指定的用户运行。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-OnBehalfOfUserRole
指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。
| 类型: | UserRole |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ParentUserRole
将现有 VMM 用户角色指定为新用户角色的父角色。
| 类型: | UserRole |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PROTipID
指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令行界面。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserRoleProfile
指定作为新用户角色基础的配置文件的类型。 此参数的可接受值为：
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| 类型: | Profile |
| 接受的值: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-VMMServer
指定此 cmdlet 在其中创建用户角色的 VMM 服务器。
| 类型: | ServerConnection |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
输出
UserRole
此 cmdlet 返回 UserRole 对象。