Get-SCUserRole
获取 VMM 用户角色。
语法
Get-SCUserRole
[-VMMServer <ServerConnection>]
[[-Name] <String>]
[-UserRoleProfile <Profile>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] 说明
Get-SCUserRole cmdlet 获取一个或多个 Virtual Machine Manager (VMM) 用户角色。 VMM 使用基于角色的安全性来定义给定用户角色的成员可以操作的边界，以及用户角色的允许操作成员集。
有关创建用户角色的信息，请键入 Get-Help New-SCUserRole。
有关设置用户角色的属性的信息，包括委派管理员和只读管理员的范围以及自助服务用户的范围和操作，请键入 Get-Help Set-SCUserRole。
示例
示例 1：获取所有用户角色
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"此命令获取名为 VMMServer01.Contoso.com 服务器上的所有 VMM 用户角色。 此命令显示有关每个用户角色的信息。
示例 2：按名称获取用户角色
PS C:\> Get-SCUserRole -Name "Administrator"此命令获取名为 Administrator 的用户角色对象。 该命令显示有关该用户角色的信息。
示例 3：按配置文件获取用户角色
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"此命令获取名为 VMMServer01 的服务器具有 SelfServiceUser 的用户角色配置文件的用户角色。 此命令显示有关这些用户角色的信息。
示例 4：显示有关用户角色对象的属性和其他信息
PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member第一个命令获取名为 VMMServer01 的服务器上的所有用户角色对象，然后将这些对象存储在$UserRoles变量中。
第二个命令将$UserRoles中的每个用户角色对象传递给 Select-Object cmdlet，然后显示每个用户角色的名称、用户角色配置文件、父用户角色和云
最终命令将$UserRoles中的每个用户角色传递给 Get-Member cmdlet，该 cmdlet 显示每个用户角色的 .NET 类型以及与每个用户角色类型关联的方法和属性。
参数
-ID
指定此 cmdlet 获取的用户角色的唯一 ID。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定此 cmdlet 获取的 VMM 用户角色的名称。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| 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 |
-UserRoleProfile
指定此 cmdlet 获取的用户角色的基础配置文件的类型。 此参数的可接受值为：
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
| Type: | Profile |
| Accepted values: | Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 对象。