Set-SCOMUserRole
配置 Operations Manager 用户角色。
语法
Set-SCOMUserRole
[-UserRole] <UserRole>
-User <String[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllClass]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SCOMUserRole
[-UserRole] <UserRole>
-ClassScope <ManagementPackClass[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllTask]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SCOMUserRole
[-UserRole] <UserRole>
-TaskScope <ManagementPackTask[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllGroup]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 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 Operators 的用户角色对象，并将该对象存储在 $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
指示作者用户角色授予的权限扩展到所有类。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllGroup
指示用户角色授予的权限扩展到所有组。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllTask
指示“作者”、“操作员”或“高级操作员”用户角色授予的权限扩展到所有任务。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClassScope
指定 ManagementPackClass 对象的数组，这些对象表示作者角色有权访问的类。 若要获取 ManagementPackClass 对象，请使用 Get-SCOMClass cmdlet。
| Type: | ManagementPackClass[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GroupScope
指定 MonitoringObjectGroup 对象的数组，这些对象表示用户角色有权访问的组。 若要获取监视对象组对象，请使用 Get-MonitoringObjectGroup cmdlet。
如果未为此参数指定值，则角色有权访问所有组。 若要拒绝角色访问所有组，请指定$Null或空数组 @ () 。
| Type: | MonitoringObjectGroup[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
指示 cmdlet 创建或修改命令可以在管道中使用的对象。 默认情况下，此 cmdlet 将不产生任何输出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskScope
指定 ManagementPackTask 对象的数组，这些对象表示作者、操作员或高级操作员角色有权访问的任务。
如果未为此参数指定值，则角色有权访问所有任务。 若要拒绝“作者”、“操作员”或“高级操作员”角色对所有任务的访问权限，请指定$Null或空数组 @ () 。
| Type: | ManagementPackTask[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-User
指定属于此用户角色的用户名数组。 此列表替换任何现有用户列表。 若要从用户角色中清除所有用户，请指定$Null或空数组 @ () 。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
指定一个用户角色对象。 若要获取 UserRole 对象，请使用 Get-SCOMUserRole cmdlet。
| Type: | UserRole |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |