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
このユーザー ロールのメンバーが、カタログ アイテムの特定のグループのみにアクセスをスコープ設定するために使用できるカタログ アイテム グループを指定します。 指定されていないグループ内のカタログ アイテムは、このロールのメンバーは使用できません。
すべてのグループへのアクセスを許可するには All を指定します。 値を指定しない場合、カタログ アイテム グループは使用できません。
| Type: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Class
ユーザー ロールがアクセスできる管理パック クラスのインスタンスを指定します。 これは、Author ロールだけに適用されます。
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
System Center データ アクセス サービスが実行しているコンピューターの名前を指定します。 Credential パラメーターで指定されたユーザー アカウントには、指定されたコンピューターへのアクセス権が必要です。
| Type: | System.String[] |
| Position: | Named |
| Default value: | Localhost |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | System.Management.Automation.SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
このコマンドレットが System Center Data Access サービスを実行するサーバーに接続するために使用する資格情報を指定します。 指定するユーザー アカウントには、そのサーバーへのアクセス権が必要です。
| Type: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
ユーザー ロールの説明を指定します。
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
ユーザー ロールの名前を指定します。
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FormTemplate
このユーザー ロールのユーザーが使用できるフォーム テンプレートを指定します。 指定されていないフォームは、このロールのユーザーは使用できません。 テンプレートを使用できるようにするには、None を指定します。 すべてのテンプレートを使用できるようにするには、[すべて] を指定します。
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Group
このユーザー ロールのメンバーが、特定の構成項目のグループのみにアクセスをスコープ設定するために使用できるグループを指定します。 指定されていないグループ内の構成項目は、このロールのメンバーは使用できません。 すべてのグループへのアクセスを許可するには All を指定します。 値を指定しない場合、グループは使用できません。
| Type: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
このコマンドレットは、作成したユーザー ロールを返します。 このオブジェクトを他のコマンドレットに渡すことができます。
| Type: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Queue
このユーザー ロールのメンバーが使用できるキューを指定して、作業項目の特定のキューのみにアクセスのスコープを設定します。 指定されていないキュー内の作業項目は、このユーザー ロールのメンバーが使用できません。 すべてのキューへのアクセスを許可するには All を指定します。 値を指定しない場合、キューは使用できません。
| Type: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
Service Manager 管理サーバーへのセッションを表すオブジェクトを指定します。
| Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Task
管理パック コンソール タスクを指定します。 ManagementPack プロパティが$Nullされていない場合にのみ、このパラメーターを指定します。 値 All は、すべての要素にアクセス可能であることを意味し、値 None は、アクセス可能な要素がないことを意味します。
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-User
新しいユーザー ロールのメンバーとなるユーザーを指定します。
| Type: | System.String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleType
作成するユーザー ロールの種類を指定します。 有効な値は次のとおりです。
- ActivityImplementers
- 管理者
- AdvancedOperators
- Authors
- ChangeInitiators
- ChangeManagers
- EndUsers
- IncidentResolvers
- ProblemAnalysts
- ReadOnlyOperators
- Workflows
| Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.UserRoleTypeEnum |
| Accepted values: | ActivityImplementer, AdvancedOperator, Author, ChangeInitiator, ChangeManager, EndUser, IncidentResolver, ProblemAnalyst, ReadOnlyOperator, ReleaseManager, ServiceRequestAnalyst |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-View
このユーザー ロールのメンバーが、特定のビューのみにアクセスをスコープするために使用できるビューを指定します。 指定されていないビューは、このロールのメンバーは使用できません。 すべてのビューへのアクセスを許可するには All を指定します。 値を指定しない場合、ビューは使用できません。
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackView[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | System.Management.Automation.SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None.
パイプを使用してこのコマンドレットに入力を渡すことはできません。
出力
None.
このコマンドレットは出力を生成しません。