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
範例 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[] |
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 |