Share via

Service Manager Authoring Tool ワークフロー アクティビティ リファレンス

  • [アーティクル]

重要

このバージョンのService Managerはサポート終了に達しました。 Service Manager 2022 にアップグレードすることをお勧めします。

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

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

Active Directory 活動

Active Directory Domain Services (AD DS) アクティビティを使用して、Active Directory 関数をService Managerのワークフローの一部にします。

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

AD DS コンピューターをグループ アクティビティに追加する

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

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

プロパティ

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

表示名 内部名 型 必須 説明
コンピューターのドメイン ComputerDomain String はい コンピューターが配置されている完全修飾 DNS ドメイン名 (たとえば、contoso.com)。
[コンピューター名] FullyQualifiedComputerName String はい コンピューターの名前です。
グループ名 FullyQualifiedGroupName String はい Active Directory Domain Services グループの名前です。

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

表示名 内部名 型 説明
出力 出力 ブール値 操作の結果: 加算が成功した場合は True 。 失敗 した場合は False。
エラーと例外 解説 例
なし なし なし

AD DS ユーザーをグループに追加するアクティビティ

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

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

プロパティ

[グループへの AD DS ユーザーの追加] アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
ユーザー ドメイン UserDomain String はい ユーザーの完全修飾ドメイン名 (FQDN)。
[ユーザー名] UserName String はい ユーザーのサインイン名。
グループ名 FullyQualifiedGroupName String はい グループの FQDN。

[ADD AD DS User to Group]\(AD DS ユーザーのグループへの追加\) アクティビティでは、次の表に示す出力が生成されます。

表示名 内部名 型 説明
出力 出力 ブール値 操作の結果: 加算が成功した場合 は True 、失敗した場合 は False 。
エラーと例外 解説 例
なし なし なし

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

制御フロー アクティビティを使用して、Service Managerのワークフローの構造 (ブランチ、ループ、タイマー遅延) を提供します。

オーサリング ツールは、[アクティビティ ツールボックス] ウィンドウの [制御フロー] グループに 4 つの既定の制御フロー アクティビティを提供します。

アクティビティの遅延

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

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

プロパティ

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

表示名 内部名 型 必須 説明
Initialize TimeoutDuration (TimeoutDuration の初期化) InitializeTimeoutDuration 内部 TimeoutDuration プロパティを初期化するハンドラーを指定します。
TimeoutDuration (TimeoutDuration) TimeoutDuration (TimeoutDuration) Timespan Yes 遅延の期間です。

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

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

各ループ アクティビティについて

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

For Each ループ アクティビティは、アクティビティ用の 2 つのコンテナーを含む複合アクティビティです。

  • 入力コンテナー: このアクティビティはループを設定し、入力コレクションを定義します。 このロールでは、 インシデントの取得 または 仮想マシンの取得 アクティビティを使用できます。

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

    1. [現在の項目] を、ForEach アクティビティのループ コンテナー アクティビティの [現在のアイテム] プロパティに設定します。 このアクティビティが For Each ループ アクティビティの最初のアクティビティである場合、 現在のアイテム は自動的に設定されます。

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

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

  • スクリプト アクティビティ (Windows PowerShell スクリプト アクティビティなど)。

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

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

プロパティ

For Each ループ アクティビティでは、次の表に示す入力プロパティを使用します。

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

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

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

IfElse アクティビティ

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

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

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

プロパティ

[なし] :

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

並列アクティビティ

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

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

プロパティ

[なし] :

エラーと例外 解説 例
なし なし なし

Virtual Machine Manager 活動

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

Service Manager作成ツールは、[アクティビティ ツールボックス] ウィンドウの [VMM アクティビティ] グループに次の 5 つの既定の仮想マシン管理アクティビティを提供します。

VM アクティビティを取得する

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

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

プロパティ

GET VM アクティビティでは、次の表の入力プロパティを使用します。

表示名 内部名 型 必須 説明
パラメーター セット ParameterSet 文字列 いいえ;既定値は [接続] です。 特定の目的のために編成されたパラメーターのサブセットを指定します。 [ VM の取得 ] アクティビティでは、次のいずれかのパラメーター セットを選択できます。

- すべての： 使用可能なすべての仮想マシンを検索します。
- Id： 既知の ID を持つ仮想マシンを検索します。
- 接続：VMMServer プロパティによって指定された仮想マシン マネージャー (VMM) サーバーに接続されている仮想マシンを検索します。
- VMHostGroup:VM Host プロパティによって指定された仮想マシン ホストに接続されている仮想マシンを検索します。
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は [True] です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
エラーあり HasError 該当なし アクティビティにエラー セットがあるかどうかを指定します。 (読み取り専用)
すべて すべて Boolean いいえ。 (既定の設定は [True] です。) パラメーター セットが [すべて] の場合に使用できます。 True に設定されている場合、GET VM アクティビティは、使用可能なすべての仮想マシンの仮想マシン ID の一覧を返します。
id id String パラメーター セットが ID の場合は必須。 パラメーター セットが ID の場合に使用できます。 True に設定されている場合、Get VM アクティビティは、指定された ID 値のすべてまたは一部と一致する仮想マシン ID を持つすべての仮想マシンの仮想マシン ID の一覧を返します。
管理グループ ManagementGroup String いいえ この活動が実行される管理グループを指定します。 localhost に設定します。 (読み取り専用)
スクリプト サーバー 移行先 String はい Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost を使用しないでください。
スクリプトの制限時間 TimeoutSeconds Integer いいえ。 (既定の設定は 300 秒です。) アクティビティの実行に許可する最大秒数を指定します。
VM ホスト VMHost 文字列 パラメーター セットが VMHostGroup の場合は必須 パラメーター セットが VMHostGroup の場合に使用できます。 このパラメーター セットが選択されている場合、 VM の取得 アクティビティは、指定されたホストで実行されているすべての仮想マシンの仮想マシン ID の一覧を返します。
VM 名 VMName String いいえ 検索する仮想マシンの名前の全部または一部を指定します。 文字列が名前の一部である場合、アクティビティは文字列を含むすべての仮想マシンの ID を取得します。
VMMServer VMMServer String はい 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

GET VM アクティビティは、次の表に示す出力を生成します。

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

VM アクティビティの移動

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

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

プロパティ

VM の移動アクティビティでは、次の表の入力プロパティを使用します。

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

[VM の移動] アクティビティでは、次の表に示す出力が生成されます。

表示名 内部名 Type 説明
VM ID VMID 文字列 移動された仮想マシンの一意の ID を指定します。 入力 VM ID と出力 VM ID は、アクティビティが入力 VM ID と一致する VM ID を持つ仮想マシンを見つけることができなかった場合を除き 、同じです。 その場合、出力 VM ID は Null に設定されます。
エラーと例外 解説 例
VM の移動アクティビティでは、Service Managerによって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 なし なし

VM アクティビティのシャットダウン

Service Managerでのこのアクティビティにより、仮想マシン上のゲスト オペレーティング システムがシャットダウンされます。

シャットダウン VM アクティビティは、仮想化ゲスト サービスが仮想マシンにインストールされている場合にのみ、Windows ベースのホスト (Hyper-V ホストまたは仮想サーバー ホスト) 上の仮想マシンで使用できます。 Hyper-V ホスト上に展開されている仮想マシンでは、仮想化ゲスト サービスは "統合コンポーネント" と呼ばれます。 Virtual Server ホスト上に展開されている仮想マシンでは、仮想化ゲスト サービスは "Virtual Machine 追加機能" と呼ばれます。

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

プロパティ

シャットダウン VM アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は [True] です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
エラーあり HasError 該当なし 活動にエラーが設定されているかどうかを指定します。 (読み取り専用)
ジョブ変数 JobVariable String いいえ ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
管理グループ ManagementGroup String いいえ この活動が実行される管理グループを指定します。 localhost に設定します。 (読み取り専用)
PROTipID PROTipID Guid いいえ この操作をトリガーしたパフォーマンスとリソースの最適化 (PRO) ヒントの ID を指定します。 将来の PRO ヒントの監査を可能にします。
非同期に実行 RunAsynchronously Boolean いいえ。 (既定の設定は [False] です。) 制御が直ちにコマンド シェルに戻るように、ジョブを非同期で実行することを指定します。
スクリプト サーバー 移行先 String はい Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 Localhost は使用しないでください。
スクリプトの制限時間 TimeoutSeconds Integer いいえ。 (既定の設定は 300 秒です。) アクティビティの実行に許可する最大秒数を指定します。
VM ID VMID String はい シャットダウンする仮想マシンの一意の ID を指定します。
VMMServer VMMServer String はい 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

シャットダウン VM アクティビティは、次の表に示す出力を生成します。

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

VM アクティビティを開始する

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

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

プロパティ

VM の開始アクティビティでは、次の表の入力プロパティを使用します。

表示名 内部名 型 必須 説明
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は [True] です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
エラーあり HasError 該当なし 活動にエラーが設定されているかどうかを指定します。 (読み取り専用)
ジョブ変数 JobVariable String いいえ ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
管理グループ ManagementGroup String いいえ このアクティビティが実行される管理グループ。 localhost に設定します。 (読み取り専用)
PROTipID PROTipID Guid いいえ この操作をトリガーしたパフォーマンスとリソースの最適化 (PRO) ヒントの ID を指定します。 将来の PRO ヒントの監査を可能にします。
非同期に実行 RunAsynchronously Boolean いいえ。 (既定の設定は [False] です。) 制御が直ちにコマンド シェルに戻るように、ジョブを非同期で実行することを指定します。
スクリプト サーバー 移行先 String はい Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost を使用しないでください。
スクリプトの制限時間 TimeoutSeconds Integer いいえ。 (既定の設定は 300 秒です。) アクティビティの実行に許可する最大秒数を指定します。
VM ID VMID String はい 起動する仮想マシンの一意の ID を指定します。
VMMServer VMMServer String はい 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

[VM の開始] アクティビティでは、次の表に示す出力が生成されます。

表示名 内部名 Type 説明
VM ID VMID 文字列 起動された仮想マシンの一意の ID を指定します。 入力 VM ID と出力 VM ID は、アクティビティが入力 VM ID と一致する VM ID を持つ仮想マシンを見つけることができなかった場合を除き 、等しくなります。 その場合、出力 VM ID は Null に設定されます。
エラーと例外 解説 例
VM の開始アクティビティでは、Service Managerによって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティのいずれかが解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 なし なし

状態 VM アクティビティを保存する

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

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

プロパティ

状態の保存 VM アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は [True] です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
エラーあり HasError 該当なし 活動にエラーが設定されているかどうかを指定します。 (読み取り専用)
ジョブ変数 JobVariable String いいえ ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
管理グループ ManagementGroup String いいえ この活動が実行される管理グループを指定します。 localhost に設定します。 (読み取り専用)
PROTipID PROTipID Guid いいえ この操作をトリガーしたパフォーマンスとリソースの最適化 (PRO) ヒントの ID を指定します。 将来の PRO ヒントの監査を可能にします。
非同期に実行 RunAsynchronously Boolean いいえ。 (既定の設定は [False] です。) 制御が直ちにコマンド シェルに戻るように、ジョブを非同期で実行することを指定します。
スクリプト サーバー 移行先 String はい Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost を使用しないでください。
スクリプトの制限時間 TimeoutSeconds Integer いいえ。 (既定の設定は 300 秒です。) アクティビティの実行に許可する最大秒数を指定します。
VM ID VMID String はい 保存する仮想マシンの一意の ID を指定します。
VMM サーバー VMMServer String はい 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。

状態の保存 VM アクティビティは、次の表に示す出力を生成します。

表示名 内部名 Type 説明
VM ID VMID 文字列 保存された仮想マシンの一意の ID を指定します。 入力 VM ID と出力 VM ID は、アクティビティが入力 VM ID と一致する VM ID を持つ仮想マシンを見つけることができなかった場合を除き 、同じです。 その場合、出力 VM ID は Null に設定されます。
エラーと例外 解説 例
状態の保存 VM アクティビティは、Service Managerによって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 なし なし

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

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

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

Service Manager作成ツールは、[アクティビティ ツールボックス] ウィンドウの [スクリプト アクティビティ] グループの [汎用スクリプト アクティビティ] サブグループに、次の 3 つの既定のスクリプト アクティビティを提供します。

コマンド スクリプト アクティビティ

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

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

プロパティ

コマンド スクリプト アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は [True] です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
エラーあり HasError 該当なし 活動にエラーが設定されているかどうかを指定します。 (読み取り専用)
管理グループ ManagementGroupName String いいえ スクリプト サーバーが属する管理グループを指定します。 既定では、これは localhost に設定されています。 (読み取り専用)
スクリプト パラメーター パラメーター 辞書 <文字列,文字列> Yes 実行時にスクリプトに渡すコマンドライン スイッチまたはスイッチ/値のペアを指定します。
スクリプトの本文 ScriptBody String はい スクリプト自体のテキストを指定します。
スクリプト サーバー 移行先 String いいえ Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost を使用しないでください。
スクリプトの制限時間 TimeoutSeconds Integer いいえ。 (既定の設定は 300 秒です。) スクリプトの実行のための最大秒数を指定します。
エラーと例外 解説 例
コマンド スクリプト アクティビティは、Service Managerによって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 なし なし

Windows PowerShell スクリプト アクティビティ

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

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

プロパティ

Windows PowerShell スクリプト アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は [True] です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
エラーあり HasError 該当なし 活動にエラーが設定されているかどうかを指定します。 (読み取り専用)
管理グループ ManagementGroupName String いいえ スクリプト サーバーが属する管理グループを指定します。 既定では、これは localhost に設定されています。 (読み取り専用)
スクリプト パラメーター パラメーター 辞書文字列 <,文字列> Yes 実行時にスクリプトに渡すパラメーターの名前/値の一覧を指定します。

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

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

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

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

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

設計時の前提条件 実行時の前提条件
VBScript スクリプト アクティビティは、設計時に次の前提条件に依存します。
[なし] :		 None

プロパティ

VBScript スクリプト アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は [True] です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
エラーあり HasError 該当なし 活動にエラーが設定されているかどうかを指定します。 (読み取り専用)
管理グループ ManagementGroupName String いいえ スクリプト サーバーが属する管理グループを指定します。 (既定では、これは localhost に設定されています)(読み取り専用)
スクリプト パラメーター パラメーター 辞書文字列 <,文字列> Yes このスクリプトを実行するときに、スクリプトで使用する標準スイッチと関連する値のリストを提供します。
スクリプトの本文 ScriptBody String はい スクリプト自体のテキストを指定します。
スクリプト サーバー 移行先 String いいえ Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhost を使用しないでください。
スクリプトの制限時間 TimeoutSeconds Integer いいえ。 (既定の設定は 300 秒です。) スクリプトの実行のための最大秒数を指定します。
エラーと例外 解説 例
VBScript スクリプト アクティビティでは、Service Managerによって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティのいずれかを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 なし なし

Service Manager 活動

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

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

インシデント アクティビティを作成する

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

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

プロパティ

インシデントの作成アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 コメント
インシデント ID IncidentID String はい Incident オブジェクトに対して生成される一意識別子を指定します。
アクション ログのコメント ActionLogComment String はい Incident オブジェクトのアクション ログに含めるコメントを指定します。
影響を受けるユーザーのドメイン AffectedUserDomain String はい インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。
影響を受けるユーザー名 AffectedUserName String はい インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。
カテゴリ カテゴリ Integer はい ネットワークや印刷などのインシデントの種類 を 指定 します。 値は列挙型の ID です。 (Category -enum データ フィールド)
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は True です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
影響 影響 Integer はい 影響を受けるユーザーやユーザーにインシデントが与える影響を指定します。 値は列挙型の ID です。 (Impact -enum データ型)
source source Integer いいえ 電話や電子メールなど、インシデントに関する情報のソースを指定します。 値は列挙型の ID です。 (Source -enum データ型フィールド)
まとめ まとめ String はい インシデントの短い説明を指定します。
緊急度 緊急度 Integer はい インシデントを解決する緊急度を指定します。 値は列挙型の ID です。 (Urgency -enum データ型フィールド)

[ インシデントの作成] アクティビティでは、次の表に示す出力が生成されます。

名前 Type 説明
SM インシデント System.WorkItem.Incident 構築されたインシデント クラス インスタンスを返します。
エラーと例外 解説 例
なし なし なし

インシデント アクティビティを取得する

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

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

プロパティ

インシデントの取得アクティビティでは、次の表に示す入力プロパティを使用します。

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

インシデントの取得アクティビティでは、次の表に示す出力が生成されます。

表示名 内部名 Type 説明
SM インシデント SMIncidents System.WorkItem.Incident の配列 インシデント オブジェクトの配列を指定します。
エラーと例外 解説 例
なし インシデントの取得アクティビティには、入力プロパティに対してエラー検証を実行するための独自の検証コントロールがあります。 なし

インシデント アクティビティを更新する

Service Manager のこのアクティビティにより、プロパティの変更が 1 つのService Manager インシデントに保存されます。

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

プロパティ

Update Incident アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
アクション ログのコメント ActionLogComment String いいえ Incident オブジェクトのアクション ログに含めるコメントを指定します。
影響を受けるユーザーのドメイン AffectedUserDomain String いいえ インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。
影響を受けるユーザー名 AffectedUserName String いいえ インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。
カテゴリ カテゴリ Integer いいえ ネットワークや印刷など、インシデントの種類 を 指定 します。 値は列挙型の ID です。 (Category -enum データ型)
エラーのまま続行する ContinueOnError Boolean いいえ。 (既定の設定は True です。) 活動に失敗したときに、ワークフローを続行するかどうかを指定します。
影響 影響 Integer いいえ 影響を受けるユーザーやユーザーにインシデントが与える影響を指定します。 値は列挙型の ID です。 (Impact -enum データ型)
source source Integer いいえ 電話や電子メールなど、インシデントに関する情報のソースを指定します。 値は列挙型の ID です。 (Source -enum データ型)
Service Manager インシデント SMIncident System.Workitem.Incident いいえ 更新するインシデントの構築されたクラス インスタンス。
Status Status Integer いいえ アクティビティを生成したインシデントの状態を指定します。 値は列挙型の ID です。 (Status -enum データ型)
まとめ まとめ String いいえ インシデントの短い説明を指定します。
緊急度 緊急度 Integer いいえ インシデントを解決する緊急度を指定します。 値は列挙型の ID です。 (Urgency -enum データ型フィールド)

インシデントの更新アクティビティでは、次の表に示す出力が生成されます。

表示名 内部名 型 説明
SM インシデント SMIncident System.WorkItem.Incident インシデントのクラス インスタンスの更新を返します。 入力 SM インシデント と出力 SM インシデント は、アクティビティが SM インシデントを検出できなかった場合を除き、等しくなります。 その場合、出力 SM Incident は Null に設定されます。
エラーと例外 解説 例
なし なし なし

[アクティビティの状態] を [完了] アクティビティに設定する

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

設計時の前提条件 実行時の前提条件
なし [なし] :

プロパティ

[ アクティビティの状態を完了に設定] アクティビティでは、次の表に示す入力プロパティを使用します。

表示名 内部名 型 必須 説明
アクティビティ ID ActivityID String はい Service Manager自動アクティビティ オブジェクトの識別子を指定します。
エラーと例外 解説 例
なし Service Manager自動アクティビティによってトリガーされるワークフローでこのアクティビティを使用する場合は、このプロパティの値として「$Data/BaseManagedEntityId$」と入力します。 この値は、ワークフローの実行をトリガーした自動アクティビティの [アクティビティの状態を完了に設定] アクティビティに適用されます。 なし