共用方式為


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>]

Description

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

指出 Author 使用者角色授與所有類別的許可權。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-AllGroup

指出使用者角色授與的許可權會延伸至所有群組。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-AllTask

指出作者、操作員或進階操作員使用者角色授與的許可權會延伸至所有工作。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ClassScope

指定代表 Author 角色可存取之類別的 ManagementPackClass 物件陣列。 若要取得 ManagementPackClass 物件,請使用 get-SCOMClass Cmdlet

類型:ManagementPackClass[]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-GroupScope

指定 MonitoringObjectGroup 的陣列, 物件,代表使用者角色可存取的群組。 若要取得監視物件群組物件,請使用 get-MonitoringObjectGroup Cmdlet

如果您未指定此參數的值,則角色可以存取所有群組。 若要拒絕所有群組的角色存取權,請指定$Null或空陣列 @()。

類型:MonitoringObjectGroup[]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-PassThru

指出 Cmdlet 會建立或修改命令可以在管線中使用的物件。 根據預設,此 Cmdlet 不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-TaskScope

指定 ManagementPackTask 物件的陣列,這些物件代表作者、操作員或進階操作員角色可存取的工作。

如果您未指定此參數的值,則角色可以存取所有工作。 若要拒絕作者、操作員或進階操作員角色存取所有工作,請指定$Null或空陣列 @()。

類型:ManagementPackTask[]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-User

指定屬於此使用者角色一部分的用戶名稱數位。 此清單會取代任何現有的用戶清單。 若要從使用者角色清除所有使用者,請指定$Null或空陣列 @()。

類型:String[]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-UserRole

指定使用者角色物件。 若要取得 UserRole 物件,Get-SCOMUserRole Cmdlet。

類型:UserRole
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False