Add-SCOMUserRole
將使用者角色新增至管理群組。
Syntax
Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-Operator]
[-TaskScope <ManagementPackTask[]>]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-ReadOnlyOperator]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-Author]
[-ClassScope <ManagementPackClass[]>]
[-TaskScope <ManagementPackTask[]>]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-AdvancedOperator]
[-TaskScope <ManagementPackTask[]>]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Add-SCOMUserRole Cmdlet 會將使用者角色新增至管理群組。 使用者角色包含兩個功能：
- 配置 檔。 定義使用者角色可存取的作業集合。
- 範圍。 定義設定檔作業的界限;例如，工作和群組。
範例
範例 1：新增唯讀操作員使用者角色
PS C:\>Add-SCOMUserRole -Name 'Script Role' -ReadOnlyOperator此命令會新增名為腳本角色的唯讀操作員使用者角色。
範例 2：藉由指定使用者名稱、工作和群組來新增使用者角色
PS C:\>$ApprovedTasks = Get-SCOMTask -Name '*SQL*'
PS C:\> $ApprovedGroups = Get-SCOMGroup -DisplayName '*SQL*'
PS C:\> Add-SCOMUserRole -Name 'SQL Operator' -Operator -GroupScope $ApprovedGroups -TaskScope $ApprovedTasks -User 'Contoso\Katarina','Contoso\Cesar'本範例會根據使用者名稱、工作和群組新增使用者角色。
前兩個命令會取得其名稱中具有 SQL 的所有工作和群組物件，並將物件分別儲存在$ApprovedTasks和$ApprovedGroups變數中。
最後一個命令會建立名為 SQL Operator 的操作員使用者角色，其中包含片片和 Cesar 使用者。 使用者角色可讓這兩個使用者存取儲存在 $ApprovedTasks 和 $ApprovedGroups 的工作和群組。
參數
-AdvancedOperator
指出新角色是進階操作員。 此角色可授與成員覆寫已設定範圍內特定目標或目標群組的規則設定和監視的能力。 進階操作員角色也會授與操作員和Read-Only操作員設定檔授與的擁有權限。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Author
指出新角色是 Author。 此角色可授與成員建立、編輯和刪除監視組態的能力，包括已設定範圍內的工作、規則、監視和檢視。 為了方便起見，作者角色可以具有特定群組的許可權。 作者角色也會授與進階操作員、操作員和Read-Only操作員角色中的擁有權限。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ClassScope
指定 ManagementPackClass 物件的陣列，代表 Author 角色可存取的類別。 若要取得 ManagementPackClass 物件，請使用 Get-SCOMClass Cmdlet。
如果您未指定此參數的值，則角色可以存取所有類別。 若要拒絕所有類別的角色存取，請指定$Null或空陣列 @ () 。
| Type: | ManagementPackClass[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
指定電腦名稱的陣列。 Cmdlet 會為這些電腦建立與管理群組的暫時連線。 您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱， (FQDN) 。 若要指定本機電腦，請輸入電腦名稱、localhost 或句點 (.)。
電腦必須執行 System Center 資料存取服務。
如果您未指定此參數，則預設為目前管理群組連線的電腦。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Credential
指定管理群組連線的 PSCredential 物件。
若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。
如需詳細資訊，請鍵入 Get-Help Get-Credential。
如果您在 ComputerName 參數中指定電腦，請使用可存取該電腦的帳戶。 預設為目前使用者。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定使用者角色的描述。 如果您未指定此參數的值，Cmdlet 會使用 DisplayName 參數的值。
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisplayName
指定使用者角色的顯示名稱。 如果此參數未出現，則預設值為 Name 參數中的值。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GroupScope
指定 MonitoringObjectGroup 物件的陣列，代表使用者角色可存取的群組。 若要取得監視物件群組物件，請使用 Get-MonitoringObjectGroup Cmdlet。
如果您未指定此參數的值，則角色可以存取所有群組。 若要拒絕所有群組的角色存取，請指定$Null或空陣列 @ ()
| Type: | MonitoringObjectGroup[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定使用者角色的名稱。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Operator
表示新角色是操作員。 此角色可授與成員與其設定範圍互動、執行工作及存取檢視的能力。 操作員角色也會授與Read-Only操作員設定檔授與的擁有權限。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReadOnlyOperator
表示新角色是Read-Only運算子。 此角色可授與成員根據其設定的範圍來檢視警示和存取檢視的能力。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
指定 Connection 物件的陣列。 若要取得 Connection 物件，請指定 Get-SCOMManagementGroupConnection Cmdlet。
如果未顯示此參數，Cmdlet 會使用與管理群組的作用中持續性連線。
使用 SCSession 參數來指定不同的持續性連線。
您可以使用 ComputerName 和 Credential 參數，建立與管理群組的暫時連線。
如需詳細資訊，請鍵入 Get-Help about_OpsMgr_Connections。
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskScope
指定 ManagementPackTask 物件的陣列，代表作者、操作員或進階操作員角色具有存取權的工作。 若要取得 ManagementPackTask 物件，請使用 ManagementPack.GetTask Cmdlet。 如果這個參數未出現，則角色可以存取所有工作。 若要拒絕所有工作的作者、操作員或進階操作員角色存取，請指定$Null或空陣列 @ () 。
| Type: | ManagementPackTask[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Users
指定陣列，其中包含屬於使用者角色的使用者名稱。
| Type: | String[] |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| 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 |