次の方法で共有

Service Manager Authoring Tool ワークフロー アクティビティの参照

この記事では、カスタムの Windows Workflow Foundation (WF) のアクティビティを作成する情報技術 (IT) 開発者向けのガイドラインについて説明します。IT プロは、このカスタムの WF のアクティビティを使用して、各自の IT プロセスに固有の WF ワークフローを構築できます。 カスタムの WF のアクティビティは、アクティビティ ライブラリ (Service Manager Authoring Tool と共に配布されるアクティビティ) を拡張します。 このドキュメントの「ワークフロー活動のリファレンス」セクションでは、活動ライブラリの既定の WF 活動の詳細を説明します。 この情報は、開発者 (または開発者の職務を遂行する IT プロ) によるカスタム WF 活動の作成作業を必要に応じて支援することを目的としています。

Service Manager で WF のアクティビティと WF ワークフローを使用する方法については、「ワークフローによる IT プロセスの自動化」を参照してください。

Active Directory のアクティビティ

Active Directory 関数を Service Manager のワークフローに取り入れるには、Active Directory Domain Services (AD DS) のアクティビティを使用します。

Service Manager Authoring Tool では、[アクティビティ ツールボックス] ウィンドウの [Active Directory のアクティビティ] グループに 2 つの既定の Service Manager アクティビティが提供されます。 この記事のセクションでは、これらのアクティビティについて説明します。

AD DS コンピューターのグループへの追加アクティビティ

このアクティビティは、Service Manager の Active Directory ドメイン サービス (AD DS) のセキュリティ グループにコンピューターを追加します。 コンピューターとグループは同じドメインに属している必要があり、ドメイン内のすべてのコンテナが検索されます。

設計時の前提条件 実行時の前提条件
None このアクティビティを使用するときは、Service Manager ワークフロー アカウントに AD DS のセキュリティ グループを変更する十分なアクセス許可があることを確認してください。

プロパティ

AD DS コンピューターのグループへの追加アクティビティでは、次の表に示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
コンピューター ドメイン コンピュータドメイン 糸 あり コンピューターが配置されている完全修飾 DNS ドメイン名 (例: contoso.com)。
[コンピューター名] FullyQualifiedComputerName 糸 あり コンピューターの名前です。
グループ名 FullyQualifiedGroupName 糸 あり Active Directory ドメイン サービス グループの名前。

AD DS コンピューターのグループへの追加アクティビティでは、次の表に示す出力が生成されます。

表示名称 内部名 タイプ 説明
出力 出力 ボーリアン 操作の結果: 追加が成功した場合は True、失敗した場合は False。
エラーと例外 注釈 例
None None None

AD DS ユーザーのグループへの追加アクティビティ

このアクティビティは、Service Manager の Active Directory ドメイン サービス (AD DS) のセキュリティ グループにユーザーを追加します。 ユーザーとグループは同じドメインに属している必要があり、ドメイン内のすべてのコンテナが検索されます。

設計時の前提条件 実行時の前提条件
None このアクティビティを使用するときは、Service Manager ワークフロー アカウントに AD DS のセキュリティ グループを変更する十分なアクセス許可があることを確認してください。

プロパティ

AD DS ユーザーのグループへの追加アクティビティでは、次の表に一覧表示される入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
ユーザーのドメイン ユーザードメイン 糸 あり ユーザーの完全修飾ドメイン名 (FQDN)。
ユーザー名 UserName 糸 あり ユーザーのサインイン名。
グループ名 FullyQualifiedGroupName 糸 あり グループの FQDN。

AD DS ユーザーのグループへの追加アクティビティでは、次の表に示す出力が生成されます。

[表示名] 内部名 タイプ 説明
出力 出力 ボーリアン 操作の結果: 追加が成功した場合は True、失敗した場合は False。
エラーと例外 注釈 例
None None None

制御フローのアクティビティ

制御フローのアクティビティを使用して、Service Manager のワークフローの構造 (分岐、ループ、タイマー遅延) を指定します。

作成ツールでは、[アクティビティ ツールボックス] ウィンドウの [制御フロー] グループにおいて、4 種類の既定の制御フローのアクティビティが提供されます。

Delay アクティビティ

このアクティビティにより、Service Manager のワークフロー内のアクティビティ間に遅延が発生します。 Delay アクティビティは、Microsoft .NET Framework の DelayActivity クラスから派生します。

設計時の前提条件 実行時の前提条件
None None

プロパティ

Delay アクティビティでは、次の表に示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
TimeoutDuration の初期化 InitializeTimeoutDuration 内部 TimeoutDuration プロパティを初期化するハンドラーを指定します。
タイムアウト時間 TimeoutDuration Timespan あり 遅延の期間。

Delay アクティビティでは出力プロパティは生成されません。

エラーと例外 注釈 例
None このアクティビティの詳細については、.NET Framework クラス ライブラリの DelayActivity クラスを参照してください。 None

For Each Loop アクティビティ

For Each Loop アクティビティは、オブジェクトの配列 (コレクション) を入力として受け取り、コレクション内の各オブジェクトに対してループ内のアクティビティ セットを繰り返します。 たとえば、入力コレクションに 5 つのオブジェクトがある場合、ループは 5 回繰り返されます。 コレクションが空の場合、ループは反復されません。 コレクション内のオブジェクトの数に上限はありません。 For Each Loop アクティビティは、ワークフローが実行されるコンピューター上で常に実行されます。

For Each Loop アクティビティは、アクティビティ用の 2 つのコンテナーを持つ複合アクティビティです。

  • 入力コンテナー: このアクティビティでループを設定し、入力コレクションを定義します。 このロールでは、Get Incident アクティビティまたは Get Virtual Machine アクティビティを使用できます。

  • ループ コンテナー: ForEachChildActivity という名前のこのアクティビティには、ループのアクティビティが含まれます。 このコンテナーに配置するほとんどの Windows Workflow Foundation (WF) のアクティビティには、Current Item と Property to Bind という 2 つの追加プロパティがあります。 ループ コンテナー内の各アクティビティに対して、これらのプロパティを次のように設定します。

    1. [現在のアイテム] を、ForEach アクティビティの Loop Container アクティビティの Current Item プロパティに設定します。 このアクティビティが For Each Loop アクティビティの最初のアクティビティである場合、[現在のアイテム] が自動的に設定されます。

    2. Property to Bind プロパティの値を、[現在のアイテム] 値を使用する現在のアクティビティのプロパティの値に設定します。

次の 2 種類のアクティビティは、Current Item プロパティと Property to Bind プロパティを取得しないため、入力コレクション内のオブジェクトを使用できません。

  • Windows PowerShell Script アクティビティなどのスクリプトのアクティビティ。

  • WorkflowActivityBase クラスから継承されないカスタム アクティビティまたはその他のアクティビティ。 このようなアクティビティには、ネイティブの Visual Studio のアクティビティなど、Activity 基本クラスに応じたアクティビティが含まれます。

設計時の前提条件 実行時の前提条件
None None

プロパティ

For Each Loop アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
入力コレクション InputCollection 配列/オブジェクト 対象外 For Each Loop アクティビティ内のアクティビティに 1 つずつ渡されるオブジェクトのコレクション。 入力コンテナー内に存在するアクティビティが出力プロパティとしてオブジェクトの配列を生成する場合、[入力コレクション] は自動的にそのプロパティに設定されます。 このプロパティの現在の値を表示するには、ループ コンテナーを右クリックして [プロパティ] を選択します。
現在のアイテム 現在の項目 オブジェクト 対象外 ループ内のアクティビティで入力プロパティとして使用できる [入力コレクション] のインデックス。 ループ コンテナーの最初のアクティビティでは、このプロパティは自動的に設定されます。
エラーと例外 注釈 例
For Each Loop アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 アクティビティは、次の条件下でエラーまたは例外を生成します。

- ForEachLoop アクティビティでエラーが発生し、それが子アクティビティで発生していない場合、ワークフローは終了します。
- 子アクティビティ内でエラーが発生した場合、ContinueOnError=true でない限りワークフローは終了します。
- 入力プロパティのいずれかが null の場合。 アクティビティは反復されません。

For Each Loop アクティビティ内の各アクティビティは、独自のエラーまたは例外をカスタム追跡サービスに書き込む必要があります。 For Each Loop アクティビティ自体はこれを実行しません。		 None None

IfElse アクティビティ

このアクティビティは、ブール値 (True/False) 条件に基づいてワークフロー内のアクティビティのシーケンスを制御します。 前のアクティビティ (スクリプト アクティビティなど) の出力を条件として使用できます。

IfElse アクティビティは、ルールと条件を使用する Visual Studio アクティビティです。 Windows Workflow Foundation (WF) のルールと条件の使用に関する詳細については、MSDN ライブラリの「チュートリアル: WF のルールと条件の使用」を参照してください。

設計時の前提条件 実行時の前提条件
None None

プロパティ

なし。

エラーと例外 注釈 例
None IfElse アクティビティの詳細については、.NET Framework 4 クラス ライブラリの IfElseActivity クラスを参照してください。 None

並行アクティビティ

このアクティビティは、アクティビティのシーケンスを、同時に実行する 2 つのシーケンスに分けます。 Parallel アクティビティは Visual Studio アクティビティです。 ParallelActivity クラスの詳細については、.NET Framework クラス ライブラリの ParallelActivity クラスを参照してください。

設計時の前提条件 実行時の前提条件
None None

プロパティ

なし。

エラーと例外 注釈 例
None None None

仮想マシン管理のアクティビティ

Service Manager の仮想マシン管理のアクティビティを使用して、仮想マシンの作成と更新を可能にするワークフローを作成できます。 仮想マシン管理のアクティビティは、System Center Virtual Machine Manager をサポートします。

Service Manager Authoring Tool では、[アクティビティ ツールボックス] ウィンドウの [VMM のアクティビティ] グループにおいて、次の 5 種類の既定の仮想マシン管理のアクティビティが提供されます。

Get VM アクティビティ

Service Manager のこのアクティビティは、Virtual Machine Manager (VMM) ライブラリから 1 つ以上の仮想マシン ID の一覧を取得します。

設計時の前提条件 実行時の前提条件
None - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。
- Service Manager ワークフロー アカウントに、Active Directory ドメイン サービス (AD DS) のセキュリティ グループを変更するのに十分なアクセス許可があることを確認します。
- Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。
- Service Manager ワークフロー アカウントに、Active Directory ドメイン サービス (AD DS) のセキュリティ グループを変更するのに十分なアクセス許可があることを確認します。

プロパティ

Get VM アクティビティでは、次のテーブルの入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
パラメーター セット パラメーターセット 糸 いいえ。既定値は Connection です。 特定の目的のために体系化されたパラメーターのサブセットを指定します。 Get VM アクティビティでは、次のいずれかのパラメーター セットを選択できます。

- すべて: 使用可能なすべての仮想マシンを検索します。
- ID: 既知の ID を持つ仮想マシンを検索します。
- 接続: VMMServer プロパティで指定された Virtual Machine Manager (VMM) サーバーに接続されている仮想マシンを検索します。
- VMHostGroup: VM Host プロパティで指定された仮想マシン ホストに接続されている仮想マシンを検索します。
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
すべて すべて ボーリアン その必要はありません。 (既定の設定は True です) [パラメーター セット] が [すべて] の場合に使用できます。 [True] に設定されている場合、Get VM アクティビティは、使用可能なすべての仮想マシンの仮想マシン ID の一覧を返します。
身分証明書 身分証明書 糸 [パラメーター セット] が [ID] の場合は必須です。 [パラメーター セット] が [ID] の場合に使用できます。 [True] に設定されている場合、Get VM アクティビティは、指定された ID 値の全部または一部と一致する仮想マシン ID を持つすべての仮想マシンの仮想マシン ID の一覧を返します。
管理グループ ManagementGroup 糸 いいえ このアクティビティが実行される管理グループを指定します。 [localhost] に設定します。 (読み取り専用)
スクリプト サーバー Target 糸 あり Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost は使用しないでください。
スクリプトの時間制限 タイムアウト秒数 整数 その必要はありません。 (既定の設定は 300 秒です) アクティビティの実行を許可する最大秒数を指定します。
VM ホスト VMHost 糸 [パラメーター セット] が VMHostGroup の場合に必須 [パラメーター セット] が VMHostGroup の場合に使用できます。 このパラメーター セットを選択した場合、Get VM アクティビティは、指定されたホスト上で実行されているすべての仮想マシンの仮想マシン ID の一覧を返します。
VM 名 VMName 糸 いいえ 検索する仮想マシンの名前または名前の一部を指定します。 文字列が名前の一部である場合、アクティビティは文字列を含むすべての仮想マシンの ID を取得します。
VMMServer VMMServer 糸 あり 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

Get VM アクティビティは、次のテーブルに示す出力を生成します。

表示名称 内部名 タイプ コメント
VM ID VMIDList 文字列の配列 VM Name 文字列の全体または一部に一致する名前を持つ仮想マシンの ID の一覧を指定します。
エラーと例外 注釈 例
Get VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 None None

Move VM アクティビティ

Service Manager のこのアクティビティは、仮想マシンを Virtual Machine Manager (VMM) ライブラリからメンテナンス ホストに移動させます。

設計時の前提条件 実行時の前提条件
None - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。
- Service Manager ワークフロー アカウントに、Active Directory ドメイン サービス (AD DS) のセキュリティ グループを変更するのに十分なアクセス許可があることを確認します。

プロパティ

Move VM アクティビティでは、次のテーブルの入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
ホストがビジーの場合は LM をブロック BlockLMIfHostBusy ボーリアン その必要はありません。 (既定の設定は Falseです) 移行元ホストまたは移行先ホストがすでに別のライブ マイグレーションに参加しているために移行が失敗した場合は、Hyper-V ライブ マイグレーションの再試行をブロックします。
ジョブ グループ ジョブグループ Guid (文字列) いいえ セットとして実行される一連のコマンドの識別子を指定します。
ジョブ変数 JobVariable 糸 いいえ ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。
管理グループ ManagementGroup 糸 いいえ このアクティビティが実行される管理グループを指定します。 [localhost] に設定します。 (読み取り専用)
経路 経路 糸 いいえ メンテナンス ホスト上の仮想マシンの移行先を指定します。
PROTipID PROTipID GUID いいえ このアクションをトリガーしたパフォーマンスとリソースの最適化 (PRO) に関するヒントの ID を指定します。 PRO に関するヒントの将来の監査が可能になります。
非同期的に実行する RunAsynchronously ボーリアン その必要はありません。 (既定の設定は Falseです) ジョブが非同期的に実行されることで制御がコマンド シェルに即座に戻るように指定します。
スクリプト サーバー Target 糸 あり Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost は使用しないでください。
スクリプトの時間制限 タイムアウト秒数 整数 その必要はありません。 (既定の設定は 300 秒です) アクティビティの実行を許可する最大秒数を指定します。
ターゲットで VM を起動する StartVMOnTarget ボーリアン その必要はありません。 (既定の設定は Falseです) 仮想マシンが移行先ホストに到達するとすぐに起動するよう指定します。
クラスターを使用する UseCluster ボーリアン その必要はありません。 (既定の設定は Falseです) クラスターが Hyper-V ライブ マイグレーションをサポートしている場合でも、保存された状態の仮想マシンをホストに転送するために強制的に Windows Server 2008 クラスター移行を使用します。
LAN を使用する UseLan ボーリアン その必要はありません。 (既定の設定は Falseです) 記憶域ネットワーク (SAN) 転送などのより高速な転送メカニズムが使用できる場合でも、ローカル エリア ネットワーク (LAN) で強制的に転送します。
VM ホスト VMHostName 糸 あり 仮想マシンの移動先のメンテナンス ホストの名前を指定します。
VM ID (仮想マシンの識別子) VMID 糸 あり 移動する仮想マシンの一意の ID を指定します。
VMM サーバー VMMServer 糸 あり 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

Move VM アクティビティは、次のテーブルに示す出力を生成します。

表示名称 内部名 タイプ コメント
VM ID (仮想マシンの識別子) VMID 糸 移動された仮想マシンの一意の ID を指定します。 アクティビティが入力 VM ID と一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、入力 VM ID と出力 VM ID は等しくなります。 その場合、出力 VM ID は [Null] に設定されます。
エラーと例外 注釈 例
Move VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 None None

Shutdown VM アクティビティ

Service Manager のこのアクティビティは、仮想マシン上のゲスト オペレーティング システムをシャットダウンします。

Windows ベースのホスト (Hyper-V ホストまたは仮想サーバー ホスト) 上の仮想マシンで Shutdown VM アクティビティを使用できるのは、仮想化ゲスト サービスが仮想マシンにインストールされている場合のみです。 Hyper-V ホストにデプロイされている仮想マシンの場合、仮想化ゲスト サービスは "統合コンポーネント" と呼ばれます。 仮想サーバー ホストにデプロイされている仮想マシンの場合、仮想化ゲスト サービスは "仮想マシンの追加" と呼ばれます。

設計時の前提条件 実行時の前提条件
None - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。
- Service Manager ワークフロー アカウントに、Active Directory ドメイン サービス (AD DS) のセキュリティ グループを変更するのに十分なアクセス許可があることを確認します。

プロパティ

Shutdown VM アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
ジョブ変数 JobVariable 糸 いいえ ジョブの進行状況を追跡され、このパラメーターで指定されている変数に格納するように指定します。
管理グループ ManagementGroup 糸 いいえ このアクティビティが実行される管理グループを指定します。 [localhost] に設定します。 (読み取り専用)
PROTipID PROTipID GUID いいえ このアクションをトリガーしたパフォーマンスとリソースの最適化 (PRO) に関するヒントの ID を指定します。 PRO に関するヒントの将来の監査が可能になります。
非同期的に実行する RunAsynchronously ボーリアン その必要はありません。 (既定の設定は Falseです) ジョブが非同期的に実行されることで制御がコマンド シェルに即座に戻るように指定します。
スクリプト サーバー Target 糸 あり Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 Localhost は使用しないでください。
スクリプトの時間制限 タイムアウト秒数 整数 その必要はありません。 (既定の設定は 300 秒です) アクティビティの実行を許可する最大秒数を指定します。
VM ID (仮想マシンの識別子) VMID 糸 あり シャットダウンする仮想マシンの一意の ID を指定します。
VMMServer VMMServer 糸 あり 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

Shutdown VM アクティビティは、次のテーブルに示す出力を生成します。

表示名称 内部名 タイプ コメント
VM ID (仮想マシンの識別子) VMID 糸 シャットダウンされた仮想マシンの一意の ID を指定します。 アクティビティが入力 VM ID と一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、入力 VM ID と出力 VM ID は等しくなります。 その場合、出力 VM ID は [Null] に設定されます。
エラーと例外 注釈 例
Shutdown VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 None None

Start VM アクティビティ

Service Manager のこのアクティビティは、停止または一時停止された仮想マシンを開始します。

設計時の前提条件 実行時の前提条件
None None

プロパティ

Start VM アクティビティでは、次のテーブルの入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
ジョブ変数 JobVariable 糸 いいえ ジョブの進行状況を追跡され、このパラメーターで指定されている変数に格納するように指定します。
管理グループ ManagementGroup 糸 いいえ このアクティビティが実行される管理グループ。 [localhost] に設定します。 (読み取り専用)
PROTipID PROTipID GUID いいえ このアクションをトリガーしたパフォーマンスとリソースの最適化 (PRO) に関するヒントの ID を指定します。 PRO に関するヒントの将来の監査が可能になります。
非同期的に実行する RunAsynchronously ボーリアン その必要はありません。 (既定の設定は Falseです) ジョブが非同期的に実行されることで制御がコマンド シェルに即座に戻るように指定します。
スクリプト サーバー Target 糸 あり Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost は使用しないでください。
スクリプトの時間制限 タイムアウト秒数 整数 その必要はありません。 (既定の設定は 300 秒です) アクティビティの実行を許可する最大秒数を指定します。
VM ID (仮想マシンの識別子) VMID (仮想マシン識別子) 糸 あり 開始する仮想マシンの一意の ID を指定します。
VMMServer VMMServer 糸 あり 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

Start VM アクティビティは、次のテーブルに示す出力を生成します。

[表示名] 内部名 タイプ コメント
VM ID (仮想マシンの識別子) VMID 糸 開始された仮想マシンの一意の ID を指定します。 アクティビティが入力 VM ID と一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、入力 VM ID と出力 VM ID は等しくなります。 その場合、出力 VM ID は [Null] に設定されます。
エラーと例外 注釈 例
Start VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 None None

Save State VM アクティビティ

Service Manager のこのアクティビティは、仮想マシンの状態を保存してから仮想マシンを停止します。

設計時の前提条件 実行時の前提条件
None - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。
- Service Manager ワークフロー アカウントに、Active Directory ドメイン サービス (AD DS) のセキュリティ グループを変更するのに十分なアクセス許可があることを確認します。

プロパティ

Save State VM アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
ジョブ変数 JobVariable 糸 いいえ ジョブの進行状況を追跡され、このパラメーターで指定されている変数に格納するように指定します。
管理グループ ManagementGroup 糸 いいえ このアクティビティが実行される管理グループを指定します。 [localhost] に設定します。 (読み取り専用)
PROTipID PROTipID GUID いいえ このアクションをトリガーしたパフォーマンスとリソースの最適化 (PRO) に関するヒントの ID を指定します。 PRO に関するヒントの将来の監査が可能になります。
非同期的に実行する RunAsynchronously ボーリアン その必要はありません。 (既定の設定は Falseです) ジョブが非同期的に実行されることで制御がコマンド シェルに即座に戻るように指定します。
スクリプト サーバー Target 糸 あり Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost は使用しないでください。
スクリプトの時間制限 TimeoutSeconds 整数 その必要はありません。 (既定の設定は 300 秒です) アクティビティの実行を許可する最大秒数を指定します。
VM ID (仮想マシンの識別子) VMID 糸 あり 保存する仮想マシンの一意の ID を指定します。
VMM サーバー VMMServer 糸 あり 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

Save State VM アクティビティは、次のテーブルに示す出力を生成します。

表示名称 内部名 タイプ コメント
VM ID (仮想マシンの識別子) VMID 糸 保存された仮想マシンの一意の ID を指定します。 アクティビティが入力 VM ID と一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、入力 VM ID と出力 VM ID は等しくなります。 その場合、出力 VM ID は [Null] に設定されます。
エラーと例外 注釈 例
Save State VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 None None

スクリプトのアクティビティ

Service Manager のスクリプト アクティビティを使用して、ワークフローの一部としてスクリプトを実行できます。

スクリプト活動はワークフローとは別のプロセスで実行されますが、Service Manager ワークフロー アカウントのセキュリティ コンテキストでも実行されます。

Service Manager Authoring Tool では、[アクティビティ ツールボックス] ウィンドウの [スクリプトのアクティビティ] グループの [汎用スクリプトのアクティビティ] サブグループにおいて、次の 3 種類の既定のスクリプトのアクティビティが提供されます。

Command Script アクティビティ

このアクティビティは、Windows Workflow Foundation (WF) ワークフローの一部としてコマンド ライン スクリプトを実行します。

設計時の前提条件 実行時の前提条件
None None

プロパティ

Command Script アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
管理グループ 管理グループ名 糸 いいえ スクリプト サーバーが属する管理グループを指定します。 既定では、これは [localhost] に設定されています。 (読み取り専用)
スクリプト パラメーター パラメーター ディクショナリ <string,string> あり スクリプトの実行時に渡されるコマンドライン スイッチまたはスイッチ/値のペアを指定します。
スクリプトの本文 ScriptBody 糸 あり スクリプト自体のテキストを指定します。
スクリプト サーバー Target 糸 いいえ Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost は使用しないでください。
スクリプトの時間制限 TimeoutSeconds 整数 その必要はありません。 (既定の設定は 300 秒です) スクリプトの実行を許可する最大秒数を指定します。
エラーと例外 注釈 例
Command Script アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 None None

Windows PowerShell Script アクティビティ

Service Manager のこのアクティビティは、Windows Workflow Foundation (WF) ワークフローの一部として Windows PowerShell スクリプトを実行します。

設計時の前提条件 実行時の前提条件
Windows PowerShell Script アクティビティは、設計時に次の前提条件に依存します。
- Windows PowerShell 2.0		 Windows PowerShell 2.0

プロパティ

Windows PowerShell Script アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
管理グループ 管理グループ名 糸 いいえ スクリプト サーバーが属する管理グループを指定します。 既定では、これは [localhost] に設定されています。 (読み取り専用)
スクリプト パラメーター パラメーター ディクショナリ <string,string> あり スクリプトの実行時に渡されるパラメーターの名前/値の一覧を指定します。

パラメーター値は、次のいずれかの管理パック参照に設定できます。

- $Target/...$
- $MPElement[...]
- $Data/...$. $Data 参照は、実行時にのみパラメーターで解決されます (スクリプト自体では解決されません)。

これらの参照の 1 つをパラメーターの唯一の値として使用すると、そのパラメーターは、入力データ項目 (GetItemXML から) を表す XML 文字列に設定されます。
スクリプトの本文 ScriptBody 糸 あり スクリプト自体のテキストを指定します。
スナップイン SnapIns 糸 いいえ 実行空間に事前に読み込む Windows PowerShell スナップインを一覧表示します。
スクリプト サーバー Target 糸 いいえ Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost は使用しないでください。
スクリプトの時間制限 TimeoutSeconds 整数 その必要はありません。 (既定の設定は 300 秒です) スクリプトの実行を許可する最大秒数を指定します。
エラーと例外 注釈 例
Windows PowerShell Script アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 Windows PowerShell の詳細については、「Windows PowerShell」を参照してください。 None

VBScript Script アクティビティ

Service Manager のこのアクティビティは、Windows Workflow Foundation (WF) ワークフローの一部として VBScript スクリプトを実行します。

設計時の前提条件 実行時の前提条件
VBScript Script アクティビティは、設計時に次の前提条件に依存します。
なし。		 None

プロパティ

VBScript Script アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

[表示名] 内部名 タイプ 必須 説明
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
エラーあり HasError 対象外 アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
管理グループ 管理グループ名 糸 いいえ スクリプト サーバーが属する管理グループを指定します。 (デフォルトでは localhost に設定されます) (読み取り専用)
スクリプト パラメーター パラメーター ディクショナリ <string,string> あり このスクリプトの実行時に使用される標準スイッチと関連値の一覧を提供します。
スクリプトの本文 ScriptBody 糸 あり スクリプト自体のテキストを指定します。
スクリプト サーバー Target 糸 いいえ Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost は使用しないでください。
スクリプトの時間制限 タイムアウト秒数 整数 その必要はありません。 (既定の設定は 300 秒です) スクリプトの実行を許可する最大秒数を指定します。
エラーと例外 注釈 例
VBScript Script アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外を記録します。 スクリプト プロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 None None

Service Manager アクティビティ

Service Manager の Service Manager アクティビティを使用して、Service Manager の関数をワークフローに含めます。

Service Manager オーサリング ツールでは、[アクティビティ ツールボックス] ウィンドウの [SM のアクティビティ] グループに次の 4 つの既定の Service Manager アクティビティが用意されています。

Create Incident アクティビティ

このアクティビティは、Service Manager でインシデントを作成して設定します。

設計時の前提条件 実行時の前提条件
None None

プロパティ

Create Incident アクティビティでは、次の表に示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 コメント
インシデント ID IncidentID 糸 あり Incident オブジェクトに対して生成される一意の識別子を指定します。
アクション ログのコメント ActionLogComment 糸 あり Incident オブジェクトのアクション ログに含めるコメントを指定します。
影響を受けるユーザー ドメイン 影響を受けるユーザードメイン 糸 あり インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。
影響を受けるユーザー名 影響を受けたユーザー名 糸 あり インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。
カテゴリ カテゴリ 整数 あり ネットワークや印刷など、インシデントの種類を指定します。 値は 列挙型 の ID です。 (カテゴリ -enum データ フィールド)
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
影響 影響 整数 あり 影響を受けるユーザーに対するインシデントの影響を指定します。 値は 列挙型 の ID です。 (影響 -enum データ型)
Source Source 整数 いいえ 電話やメールなど、インシデントに関する情報のソースを指定します。 値は 列挙型 の ID です。 (ソース -enum データ型フィールド)
まとめ まとめ 糸 あり インシデントを説明する概要テキストを指定します。
緊急度 緊急度 整数 あり インシデントの解決に関する緊急性を指定します。 値は 列挙型 の ID です。 (緊急性 -enum データ型フィールド)

Create Incident アクティビティは、次のテーブルに示す出力を生成します。

名前 タイプ コメント
SM インシデント システム作業項目インシデント 構成されたインシデント クラス インスタンスを返します。
エラーと例外 注釈 例
None None None

Get Incident アクティビティ

このアクティビティは、Service Manager で 1 つ以上のインシデントを取得します。

設計時の前提条件 実行時の前提条件
None None

プロパティ

Get Incident アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 コメント
影響を受けるユーザー ドメイン 影響を受けたユーザードメイン 糸 いいえ インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。
影響を受けるユーザー名 影響を受けたユーザー名 糸 いいえ インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。
カテゴリ カテゴリ 整数 いいえ ネットワークや印刷など、インシデントの種類を指定します。 値は 列挙型 の ID です。 (カテゴリ -enum データ フィールド)
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定値は Trueです) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
インシデント ID IncidentID 糸 いいえ インシデント オブジェクトに対して生成される一意の識別子を指定します。
検索の種類 検索タイプ 整数 いいえ アクティビティで使用される検索タイプのタイトルを指定します。
Status Status 整数 いいえ インシデントの状態を指定します。 値は 列挙型 の ID です。 (状態 -enum データ フィールド)
概要テキスト SummaryText 糸 いいえ インシデントを説明する概要テキストを指定します。

Get Incident アクティビティは、次のテーブルに示す出力を生成します。

表示名称 内部名 タイプ コメント
SM インシデント SMインシデンツ System.Workitem.Incident の配列 インシデント オブジェクトの配列を指定します。
エラーと例外 注釈 例
None Get Incident アクティビティには、入力プロパティのエラー検証を実行するための独自の検証コントロールがあります。 None

Update Incident アクティビティ

Service Manager のこのアクティビティは、プロパティの変更を 1 つの Service Manager インシデントに保存します。

設計時の前提条件 実行時の前提条件
None None

プロパティ

Update Incident アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
アクション ログのコメント ActionLogComment 糸 いいえ Incident オブジェクトのアクション ログに含めるコメントを指定します。
影響を受けるユーザー ドメイン 影響を受けるユーザードメイン 糸 いいえ インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。
影響を受けるユーザー名 影響を受けたユーザー名 糸 いいえ インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。
カテゴリ カテゴリ 整数 いいえ ネットワークや印刷など、インシデントの種類を指定します。 値は 列挙型 の ID です。 (カテゴリ -enum データ型)
エラーのまま続行する ContinueOnError ボーリアン その必要はありません。 (既定の設定は True です) アクティビティが失敗した場合にワークフローの実行を継続するかどうかを決定します。
影響 影響 整数 いいえ 影響を受けるユーザーに対するインシデントの影響を指定します。 値は 列挙型 の ID です。 (影響 -enum データ型)
Source Source 整数 いいえ 電話やメールなど、インシデントに関する情報のソースを指定します。 値は 列挙型 の ID です。 (ソース -enum データ型)
Service Manager インシデント SMIncident システム・作業項目・インシデント いいえ 更新する構成されたインシデント クラス インスタンス。
Status Status 整数 いいえ アクティビティを生成したインシデントの状態を指定します。 値は 列挙型 の ID です。 (状態 -enum データ型)
まとめ まとめ 糸 いいえ インシデントを説明する概要テキストを指定します。
緊急度 緊急度 整数 いいえ インシデントの解決に関する緊急性を指定します。 値は 列挙型 の ID です。 (緊急性 -enum データ型フィールド)

Update Incident アクティビティは、次のテーブルに示す出力を生成します。

表示名称 内部名 タイプ 説明
SM インシデント SMインシデント システム.作業項目.インシデント インシデント クラス インスタンスの更新を返します。 アクティビティが SM インシデントを見つけられなかった場合を除き、入力 SM インシデントと出力 SM インシデントは等しくなります。 その場合、出力 SM インシデントは [Null] に設定されます。
エラーと例外 注釈 例
None None None

Set Activity Status to Completed アクティビティ

このアクティビティは、Service Manager の自動アクティビティの状態を更新します。

設計時の前提条件 実行時の前提条件
None なし。

プロパティ

Set Activity Status to Completed アクティビティでは、次のテーブルに示す入力プロパティが使用されます。

表示名称 内部名 タイプ 必須 説明
活動 ID アクティビティID 糸 あり Service Manager の自動アクティビティ オブジェクトの識別子を指定します。
エラーと例外 注釈 例
None Service Manager の自動アクティビティによってトリガーされるワークフローでこのアクティビティを使用する場合は、このプロパティの値として $Data/BaseManagedEntityId$ を入力します。 この値は、ワークフローの実行をトリガーした自動アクティビティで Set Activity Status to Completed アクティビティに適用されます。 None