Set-SCOMUserRole

構文

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 コマンドレットは、System Center - Operations Manager ユーザー ロールを構成します。 ユーザー ロールには、次の 2 つの機能が含まれています。

• [プロファイル]。 ユーザー ロールがアクセスできる操作のコレクションを定義します。
• 範囲。 プロファイル操作の境界を定義します。たとえば、タスクやグループなどです。

このコマンドレットを使用して、ユーザー リストまたはユーザー ロールのスコープを更新できます。

例

例 1: すべてのタスクへのアクセス権をユーザー ロールに付与する

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

この例では、ユーザー ロールを更新して、すべてのタスクへのアクセスを許可する方法を示します。

最初のコマンドは、Contoso Operators という名前のユーザー ロール オブジェクトを取得し、そのオブジェクトを $Role 変数に格納します。

2 番目のコマンドでは、パイプライン演算子を使用して、$Role変数に格納されているユーザー ロールを Set-SCOMUserRole コマンドレットに渡します。 このコマンドレットは、すべてのタスクへのアクセス権をユーザー ロールに付与し、更新されたユーザー ロール オブジェクトを返します。 次に、パイプライン演算子を使用して、更新されたオブジェクトを 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 変数に格納します。

2 番目のコマンドは、名前に 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 変数に格納します。

2 番目のコマンドでは、パイプライン演算子を使用して、$Role変数に格納されているオブジェクトを Set-SCOMUserRole コマンドレットに渡します。これにより、ユーザー Contoso\Cesar がロールの既存のユーザー リストに追加されます。

パラメーター

-AllClass

-AllGroup

-AllTask

-ClassScope

-Confirm

-GroupScope

-PassThru

-TaskScope

-User

-UserRole

-WhatIf

関連リンク

• Add-SCOMUserRole
• Get-SCOMUserRole
• Get-SCClass