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"このコマンドは、すべての管理パック、キュー、グループ、タスク、ビュー、およびテンプレートにアクセスできるユーザー ロールを作成します。 ユーザー ロールのメンバーはドメイン管理者です。
例 2: フォームとビューの読み取り専用ロールを作成する
PS C:\>New-SCSMUserRole -UserRoleType ReadOnlyOperator -DisplayName "restricted role" -Group @() -Queue @() -Task @() -User "WOODGROVE\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 データ アクセス サービスを実行するコンピューターの名前を指定します。 Credential パラメーターで指定するユーザー アカウントには、指定したコンピューターへのアクセス権が必要です。
| 型: | System.String[] |
| 配置: | Named |
| 規定値: | Localhost |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | System.Management.Automation.SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
このコマンドレットが System Center データ アクセス サービスを実行するサーバーに接続するために使用する資格情報を指定します。 指定したユーザーアカウントには、そのサーバーへのアクセス権が必要です。
| 型: | 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
作成するユーザー・ロールのタイプを指定します。 有効な値は次のとおりです。
- アクティビティインプリメンターズ
- 管理者
- アドバンストオペレーター
- 作者
- チェンジイニシエータ
- チェンジマネージャー
- エンドユーザー
- インシデントリゾルバー
- 問題アナリスト
- ReadOnly演算子
- ワークフロー
| 型: | 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.
このコマンドレットは出力を生成しません。