Get-SCOMUserRole

获取用户角色。

语法

Get-SCOMUserRole
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMUserRole
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMUserRole
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
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 服务。

如果未指定此参数,则默认为当前管理组连接的计算机。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定管理组连接运行所在的用户帐户。 为此参数指定 PSCredential 对象,例如 Get-Credential cmdlet 返回的对象。 有关凭据对象的详细信息,请键入 Get-Help Get-Credential

如果在 ComputerName 参数中指定计算机,请使用有权访问该计算机的帐户。 默认为当前用户。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

指定包含用户角色对象的显示名称的数组。 该 cmdlet 采用数组中的每个字符串,并在此 cmdlet 使用的用户角色对象的显示名称之间查找匹配项。 此参数的值因将哪些本地化管理包导入管理组以及运行Windows PowerShell的用户的区域设置而异。

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定用户角色对象的 ID 数组。 该 cmdlet 采用数组中每个全局唯一标识符 (GUID) ,并查找与 cmdlet 获取的用户角色对象的 ID 属性匹配项。

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定包含用户角色对象名称的数组。 该 cmdlet 采用数组中的每个字符串,并查找与 cmdlet 获取的用户角色对象的 Name 属性匹配项。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

指定 Connection 对象的数组。 若要获取 Connection 对象,请指定 Get-SCOMManagementGroupConnection cmdlet。

如果未为此参数指定值,cmdlet 将使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerNameCredential 参数创建与管理组的临时连接。 要了解详情,请键入 Get-Help about_OpsMgr_Connections

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False