New-SCSMUserRole
在 Service Manager 中建立新的使用者角色。
語法
New-SCSMUserRole
[-UserRoleType] <UserRoleTypeEnum>
-DisplayName <String>
[-Description <String>]
[-Class <ManagementPackClass[]>]
[-Group <EnterpriseManagementObject[]>]
[-CatalogGroup <EnterpriseManagementObject[]>]
[-Queue <EnterpriseManagementObject[]>]
[-Task <ManagementPackConsoleTask[]>]
[-View <ManagementPackView[]>]
[-FormTemplate <ManagementPackObjectTemplate[]>]
[-User <String[]>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-SCSMUserRole Cmdlet 會在 Service Manager 中建立使用者角色。
範例
範例 1：建立具有所有存取權的使用者角色
PS C:\>New-SCSMUserRole -UserRoleType ActivityImplementer -DisplayName "Role for implementers" -User "WOODGROVE\Domain Admins"此命令會建立可存取所有管理元件、佇列、群組、工作、檢視和範本的使用者角色。 使用者角色的成員是 Domain Admins。
範例 2：建立表單和檢視的唯讀角色
PS C:\>New-SCSMUserRole -UserRoleType ReadOnlyOperator -DisplayName "restricted role" -Group @() -Queue @() -Task @() -User "WOODGROVE\Patti Fuller"此命令會建立只讀操作員角色，其只能存取窗體和檢視。 新角色中唯一的成員是 Patti Fuller。
參數
-CatalogGroup
指定此使用者角色成員可以使用的目錄專案群組，將存取範圍限定為目錄專案的特定群組。 未指定群組中的目錄項目無法供此角色的成員使用。
指定[全部] 以允許存取所有群組。 如果您未指定任何值，則沒有任何目錄專案群組可供使用。
| 類型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Class
指定使用者角色可存取的管理元件類別實例。 這隻適用於作者角色。
| 類型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ComputerName
指定 System Center 資料存取服務執行所在的電腦名稱。 Credential 參數中指定的使用者帳戶必須具有指定計算機的訪問許可權。
| 類型: | System.String[] |
| Position: | Named |
| 預設值: | Localhost |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | System.Management.Automation.SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
指定此 Cmdlet 用來連線到 System Center 資料存取服務執行所在的伺服器認證。 指定的使用者帳戶必須具有該伺服器的訪問許可權。
| 類型: | System.Management.Automation.PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定使用者角色的描述。
| 類型: | System.String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisplayName
指定使用者角色的名稱。
| 類型: | System.String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FormTemplate
指定此使用者角色中可供使用者使用的表單範本。 此角色中的用戶無法使用未指定的表單。 指定 [無] 可讓範本無法使用。 指定 [全部] 以讓所有範本可供使用。
| 類型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Group
指定可供此使用者角色成員使用的群組，以限定對特定組態專案群組的存取範圍。 未指定群組中的組態項目無法供此角色的成員使用。 指定[全部] 以允許存取所有群組。 如果您未指定任何值，則沒有可用的群組。
| 類型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PassThru
指出此 Cmdlet 會傳回它所建立的使用者角色。 您可以將這個物件傳遞至其他 Cmdlet。
| 類型: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Queue
指定可供此使用者角色成員使用的佇列，以限定工作專案特定佇列的存取範圍。 未指定之佇列中的工作項目無法供此使用者角色的成員使用。 指定 [全部] 以允許存取所有佇列。 如果您未指定任何值，則沒有可用的佇列。
| 類型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SCSession
指定物件，表示 Service Manager 管理伺服器的會話。
| 類型: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Task
指定管理元件主控台工作。 只有當 ManagementPack 屬性未$Null時，才指定此參數。 [全部] 值表示所有元素皆可存取，而 [無] 值表示無法存取任何元素。
| 類型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-User
指定將成為新使用者角色成員的使用者。
| 類型: | System.String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserRoleType
指定要建立的使用者角色類型。 有效值為：
- ActivityImplementers
- 管理員
- AdvancedOperators
- 作者
- ChangeInitiators
- ChangeManagers
- EndUsers
- IncidentResolvers
- ProblemAnalysts
- ReadOnlyOperators
- 工作流程
| 類型: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.UserRoleTypeEnum |
| 接受的值: | ActivityImplementer, AdvancedOperator, Author, ChangeInitiator, ChangeManager, EndUser, IncidentResolver, ProblemAnalyst, ReadOnlyOperator, ReleaseManager, ServiceRequestAnalyst |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-View
指定可供這個使用者角色成員使用的檢視，以限定存取特定檢視的範圍。 未指定之檢視不適用於此角色中的成員。 指定 [全部] 以允許存取所有檢視。 如果您未指定任何值，則沒有可用的檢視。
| 類型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackView[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | System.Management.Automation.SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None.
您無法使用管線將輸入傳送至此 Cmdlet。
輸出
None.
此 Cmdlet 不會產生任何輸出。