Get-SCOMUserRole
获取用户角色。
语法
Empty （默认值）
Get-SCOMUserRole
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromUserRoleDisplayName
Get-SCOMUserRole
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromUserRoleId
Get-SCOMUserRole
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromUserRoleName
Get-SCOMUserRole
-Name <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
说明
Get-SCOMUserRole cmdlet 获取用户角色。 用户角色合并了两个元素：
- 轮廓。 定义用户角色有权访问的操作集合。
- 范围。 定义配置文件操作的边界;例如，任务和组。
示例
示例 1：获取角色的用户角色信息
PS C:\>Get-SCOMUserRole -Name "OperationsManagerReadOnlyOperators"
此命令获取名为 OperationsManagerReadOnlyOperators 的用户角色的信息。
参数
-ComputerName
指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。
计算机必须运行 System Center Data Access 服务。
如果未指定此参数，则默认为当前管理组连接的计算机。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Credential
指定运行管理组连接的用户帐户。
为此参数指定 PSCredential 对象，例如 Get-Credential cmdlet 返回的对象。
有关凭据对象的详细信息，请键入 Get-Help Get-Credential。
如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认值为当前用户。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DisplayName
指定包含用户角色对象的显示名称的数组。 该 cmdlet 采用数组中的每个字符串，并查找此 cmdlet 使用的用户角色对象的显示名称之间的匹配项。 此参数的值因将哪些本地化管理包导入管理组以及运行 Windows PowerShell 的用户的区域设置而异。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromUserRoleDisplayName
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Id
指定用户角色对象的 ID 数组。 该 cmdlet 采用数组中的每个全局唯一标识符（GUID），并查找与 cmdlet 获取的用户角色对象的 ID 属性的匹配项。
参数属性
| 类型: | Guid[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromUserRoleId
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定包含用户角色对象名称的数组。 该 cmdlet 采用数组中的每个字符串，并查找与 cmdlet 获取的用户角色对象的 Name 属性匹配项。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromUserRoleName
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SCSession
指定 连接 对象的数组。 若要获取 连接 对象，请指定 Get-SCOMManagementGroupConnection cmdlet。
如果未为此参数指定值，cmdlet 将使用与管理组的活动持久连接。
使用 SCSession 参数指定不同的持久连接。
可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。
有关详细信息，请键入 Get-Help about_OpsMgr_Connections。
参数属性
| 类型: | Connection[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。