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 对象。