Set-SCOMUserRole

配置 Operations Manager 用户角色。

语法

FromUser

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -User <String[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllClassScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllClass]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromClassScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -ClassScope <ManagementPackClass[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllTaskScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllTask]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromTaskScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -TaskScope <ManagementPackTask[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllGroupScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllGroup]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromGroupcope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -GroupScope <MonitoringObjectGroup[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-SCOMUserRole cmdlet 配置 System Center - Operations Manager 用户角色。 用户角色包含两个功能:

  • 简介。 定义用户角色有权访问的作集合。
  • 范围。 定义轮廓作的边界;例如,任务和组。

可以使用此 cmdlet 更新用户列表或用户角色的范围。

示例

示例 1:授予用户角色对所有任务的访问权限

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso Operators"
PS C:\> $Role | Set-SCOMUserRole -AllTask -PassThru | Set-SCOMUserRole -AllGroup

此示例演示如何更新用户角色以授予其对所有任务的访问权限。

第一个命令获取名为 Contoso Operators 的用户角色对象,并将该对象存储在 $Role 变量中。

第二个命令使用管道运算符将存储在 $Role 变量中的用户角色传递给 Set-SCOMUserRole cmdlet。 此 cmdlet 授予用户角色对所有任务的访问权限,并返回更新的用户角色对象。 然后,该命令使用管道运算符将更新的对象传递给 Set-SCOMUserRole ,该运算符批准所有组的角色。

示例 2:授予用户角色对特定任务的访问权限

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso SQL Operators"
PS C:\> $NewTaskList = Get-SCOMTask -Name "*SQL*"
PS C:\> $Role | Set-SCOMUserRole -TaskScope $NewTaskList

此示例演示如何更新用户角色以授予其对特定任务的访问权限。

第一个命令获取名为 Contoso SQL 运算符的用户角色对象,并将该对象存储在 $Role 变量中。

第二个命令获取名称中带有 SQL 的所有任务对象,并将对象存储在 $NewTaskList 变量中。

最后一个命令使用管道运算符将存储在$Role变量中的用户角色传递给 Set-SCOMUserRole,这会将已批准任务的集合重置为存储在$NewTaskList变量中的列表。

示例 3:为用户添加用户角色

PS C:\>$Role = Get-SCOMUserRole -Name "Contoso Read-Only Operators"
PS C:\> $Role | Set-SCOMUserRole -User ($Role.Users + "Contoso\Cesar")

此示例将用户添加到用户角色。

第一个命令获取名为 Contoso Read-Only Operators 的用户角色对象,并将该对象存储在 $Role 变量中。

第二个命令使用管道运算符将存储在 $Role 变量中的对象传递给 Set-SCOMUserRole cmdlet,该 cmdlet 将用户 Contoso\Cesar 添加到该角色的现有用户列表中。

参数

-AllClass

指示“作者”用户角色授予的权限扩展到所有类。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

FromAllClassScope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AllGroup

指示用户角色授予的权限扩展到所有组。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

FromAllGroupScope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AllTask

表示“作者”、“操作员”或“高级操作员”用户角色授予的权限扩展到所有任务。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

FromAllTaskScope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ClassScope

指定 ManagementPackClass 对象数组,这些对象表示作者角色有权访问的类。 若要获取 ManagementPackClass 对象,请使用 Get-SCOMClass cmdlet。

参数属性

类型:

ManagementPackClass[]

默认值:None
支持通配符:False
不显示:False

参数集

FromClassScope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-GroupScope

指定 MonitoringObjectGroup 对象数组,这些对象表示用户角色有权访问的组。 若要获取监视对象组对象,请使用 Get-MonitoringObjectGroup cmdlet。

如果未为此参数指定值,则该角色可以访问所有组。 要拒绝角色对所有组的访问,请指定$Null或空数组 @()。

参数属性

类型:

MonitoringObjectGroup[]

默认值:None
支持通配符:False
不显示:False

参数集

FromGroupcope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PassThru

指示 cmdlet 创建或修改命令可在管道中使用的对象。 默认情况下,此 cmdlet 不生成任何输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TaskScope

指定 ManagementPackTask 对象数组,这些对象表示“作者”、“操作员”或“高级操作员”角色有权访问的任务。

如果未为此参数指定值,则角色可以访问所有任务。 要拒绝“作者”、“操作员”或“高级操作员”角色访问所有任务,请指定$Null或空数组 @()。

参数属性

类型:

ManagementPackTask[]

默认值:None
支持通配符:False
不显示:False

参数集

FromTaskScope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-User

指定属于此用户角色的用户名数组。 此列表将替换任何现有的用户列表。 要从用户角色中清除所有用户,请指定$Null或空数组 @()。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

FromUser
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-UserRole

指定用户角色对象。 若要获取 UserRole 对象,请使用 Get-SCOMUserRole cmdlet。

参数属性

类型:UserRole
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符: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