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。