New-SCSMWorkflow

モジュール:

System.Center.Service.Manager

Service Manager で新しいワークフローを作成します。

構文

New-SCSMWorkflow
   -Class <String>
   [-DisplayName] <String>
   [-Description <String>]
   [-Enable <Boolean>]
   [-Event <WorkflowEvent>]
   [-ManagementPack <ManagementPack>]
   [-Criteria <String>]
   [-Template <ManagementPackObjectTemplate>]
   [-EnableNotification <Boolean>]
   [-Notification <Hashtable[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-SCSMWorkflow コマンドレットは、Service Manager でワークフローを作成します。

例

例 1: 手動アクティビティ作成のワークフローを作成する

PS C:\>$Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name "AssignedToUserNotificationTemplate" },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 07" -Class "ManualActivity" -Description "Contoso workflow 07." -Enable $True -Event Create -Notification $Notification -Template $Template

最初のコマンドは、Get-SCSMObjectTemplate コマンドレットを使用して DefaultManualActivityTemplate という名前のテンプレートを取得します。 このコマンドは、テンプレートを $Template 変数に格納します。

2 番目のコマンドは、ハッシュ テーブルとして通知の配列を作成し、$Notification変数に格納します。

最後のコマンドは、手動アクティビティの作成時に使用できるワークフローを作成します。 スクリプトは条件を指定しないため、このワークフローは手動アクティビティの作成に適用されます。

例 2: ユーザーの手動アクティビティ作成のワークフローを作成する

PS C:\>$CriteriaString = @'
>>  <Criteria>
>>   <Expression>
>>    <SimpleExpression>
>>     <ValueExpression>
>>      <Property State="Post">
>>  $Context/$Path[Relationship='System.WorkItem.Library!System.WorkItemCreatedByUser' TypeConstraint='System!System.Domain.User']/Property[Type='System!System.Domain.User']/UserName$
>>      </Property>
>>     </ValueExpression>
>>     <Operator>Equal</Operator>
>>     <ValueExpression>
>>      <Value>Evan Narvaez</Value>
>>     </ValueExpression>
>>    </SimpleExpression>
>>   </Expression>
>>  </Criteria>
>>  '@
PS C:\> $ManagementPack = Get-SCSMManagementPack -Name "Workflows"
PS C:\> $Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name AssignedToUserNotificationTemplate },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 09" -Class "ManualActivity" -Criteria $CriteriaString -Description "Contoso workflow 09." -Enable $False -Event Create -ManagementPack $ManagementPack -Template $Template

最初のコマンドは、ユーザー Evan Narvaez によって作成された手動アクティビティのみを選択する、手動アクティビティに定義された条件文字列を作成します。 このコマンドは、これらの条件を $CriteriaString 変数に格納します。

2 番目のコマンドは、Get-SCSMManagementPack コマンドレットを使用して Workflows という名前の管理パックを取得し、$ManagementPack変数に格納します。 後続のコマンドでは、この値を使用してワークフローを保存する場所を指定します。 これは、封印された管理パックにすることはできません。

3 番目のコマンドは、Get-SCSMObjectTemplate コマンドレットを使用して DefaultManualActivityTemplate という名前のテンプレートを取得します。 このコマンドは、テンプレートを $Template 変数に格納します。

4 番目のコマンドは、ハッシュ テーブルとして通知の配列を作成し、$Notification変数に格納します。

最後のコマンドは、手動アクティビティの作成時に使用できるワークフローを作成します。

パラメーター

-Class

ワークフローが変更されたときにワークフローを開始するクラスの名前を指定します。 有効な値は次のとおりです。

• 構成
• 変える
• 事件
• ManualActivity
• ReviewActivity
• DeploymentActivity

型:	System.String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	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

-Criteria

結果セットを制限する条件を表すオブジェクトを指定します。

型:	System.String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

ワークフローの説明を指定します。

型:	System.String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisplayName

作成するワークフローの名前を指定します。

型:	System.String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Enable

このコマンドレットでワークフローを有効または無効にするかどうかを示します。

型:	System.Boolean
配置:	Named
規定値:	True
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableNotification

このコマンドレットがワークフローからの通知を有効または無効にするかどうかを示します。

型:	System.Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Event

ワークフローを開始する条件を指定します。 有効な値は次のとおりです。

• 創造する
• 更新

型:	Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
指定可能な値:	Create, Update
配置:	Named
規定値:	Created
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ManagementPack

ワークフローを格納する管理パックを指定します。 封印された管理パックは指定しないでください。

型:	Microsoft.EnterpriseManagement.Configuration.ManagementPack
配置:	Named
規定値:	The default management pack
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Notification

ワークフローからの通知に使用するユーザーとテンプレートのハッシュ テーブルを指定します。

型:	System.Collections.Hashtable[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

このコマンドレットは、このコマンドレットが作成するワークフローを返します。 このオブジェクトは、他のコマンドレットに渡すことができます。

型:	System.Management.Automation.SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SCSession

Service Manager 管理サーバーへのセッションを表すオブジェクトを指定します。

型:	Microsoft.SystemCenter.Core.Connection.Connection[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Template

ワークフローが影響を受けるオブジェクトに適用するテンプレートを指定します。

型:	Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:	System.Management.Automation.SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None.

このコマンドレットに入力をパイプすることはできません。

出力

None.

このコマンドレットは出力を生成しません。

関連リンク

• Get-SCSMWorkflow
• Remove-SCSMWorkflow
• Update-SCSMWorkflow