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>] 説明
New-SCSMUserRole コマンドレットは、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[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Class
ユーザー ロールがアクセスできる管理パック クラスのインスタンスを指定します。 これは作成者ロールにのみ適用されます。
| 型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ComputerName
System Center Data Access サービスを実行するコンピューターの名前を指定します。 Credential パラメーターで指定されたユーザー アカウントには、指定したコンピューターへのアクセス権が必要です。
| 型: | System.String[] |
| 配置: | Named |
| 規定値: | Localhost |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | System.Management.Automation.SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
このコマンドレットが System Center Data Access サービスを実行するサーバーへの接続に使用する資格情報を指定します。 指定されたユーザー アカウントには、そのサーバーへのアクセス権が必要です。
| 型: | System.Management.Automation.PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
ユーザー ロールの説明を指定します。
| 型: | System.String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisplayName
ユーザー ロールの名前を指定します。
| 型: | System.String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FormTemplate
このユーザー ロールのユーザーが使用できるフォーム テンプレートを指定します。 指定されていないフォームは、このロールのユーザーは使用できません。 テンプレートを使用できるようにするには、[なし] を指定します。 すべてのテンプレートを使用できるようにするには、[すべて] を指定します。
| 型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Group
このユーザー ロールのメンバーが、特定の構成項目のグループのみにアクセスをスコープ設定するために使用できるグループを指定します。 指定されていないグループ内の構成項目は、このロールのメンバーが使用できません。 すべてのグループへのアクセスを許可するには、[すべて] を指定します。 値を指定しない場合、グループは使用できません。
| 型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
このコマンドレットによって、作成されたユーザー ロールが返されることを示します。 このオブジェクトは、他のコマンドレットに渡すことができます。
| 型: | System.Management.Automation.SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Queue
作業項目の特定のキューのみにアクセスのスコープを設定するために、このユーザー ロールのメンバーが使用できるキューを指定します。 指定されていないキュー内の作業項目は、このユーザー ロールのメンバーが使用できません。 すべてのキューへのアクセスを許可するには、[すべて] を指定します。 値を指定しない場合、キューは使用できません。
| 型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SCSession
Service Manager 管理サーバーへのセッションを表すオブジェクトを指定します。
| 型: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Task
管理パックコンソール タスクを指定します。 ManagementPack プロパティが$Nullされていない場合にのみ、このパラメーターを指定します。 値 All は、すべての要素にアクセス可能であることを意味し、値 None は、アクセス可能な要素がないことを意味します。
| 型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-User
新しいユーザー ロールのメンバーになるユーザーを指定します。
| 型: | System.String[] |
| 配置: | 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 |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-View
特定のビューのみにアクセスのスコープを設定するために、このユーザー ロールのメンバーが使用できるビューを指定します。 指定されていないビューは、このロールのメンバーには使用できません。 すべてのビューへのアクセスを許可するには、[すべて] を指定します。 値を指定しない場合、ビューは使用できません。
| 型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackView[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | System.Management.Automation.SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None.
このコマンドレットに入力をパイプすることはできません。
出力
None.
このコマンドレットは出力を生成しません。