New-SCSMWorkflow

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

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

  • 構成
  • Change
  • インシデント
  • ManualActivity
  • ReviewActivity
  • DeploymentActivity
Type:System.String
Position:Named
Default value:None
Required:True
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

-Criteria

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

Type:System.String
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:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enable

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

Type:System.Boolean
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNotification

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

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Event

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

  • 作成
  • 更新
Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Accepted values:Create, Update
Position:Named
Default value:Created
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementPack

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

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Default value:The default management pack
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Notification

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

Type:System.Collections.Hashtable[]
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

-SCSession

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

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Template

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

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
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.

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