Service Manager Authoring Tool ワークフロー アクティビティ リファレンス
この記事では、IT 担当者が IT プロセスに固有の WF ワークフローを構築するために使用できるカスタム Windows Workflow Foundation (WF) アクティビティを作成できるように、情報テクノロジ (IT) 開発者向けのガイダンスを提供します。 カスタム WF アクティビティは、アクティビティ ライブラリ (Service Manager オーサリング ツールで配布されるアクティビティ) を拡張します。 このドキュメントの「ワークフロー活動のリファレンス」セクションでは、活動ライブラリの既定の WF 活動の詳細を説明します。 この情報は、開発者 (または開発者の職務を遂行する IT プロ) によるカスタム WF 活動の作成作業を必要に応じて支援することを目的としています。
Service Manager で WF アクティビティと WF ワークフローを使用する方法については、「 ワークフローを使用した IT プロセスの自動化」を参照してください。
Active Directory アクティビティ
Active Directory ドメイン Services (AD DS) アクティビティを使用して、Active Directory 関数を Service Manager のワークフローの一部にします。
Service Manager 作成ツールは、Activities ツールボックス ウィンドウの Active Directory アクティビティ グループに 2 つの既定の Service Manager アクティビティを提供します。 この記事のセクションでは、これらのアクティビティについて説明します。
AD DS コンピューターをグループ アクティビティに追加する
このアクティビティは、Service Manager の Active Directory ドメイン Services (AD DS) のセキュリティ グループにコンピューターを追加します。 コンピューターとグループは同じドメインに属している必要があり、ドメイン内のすべてのコンテナーが検索されます。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | このアクティビティを使用する場合は、Service Manager ワークフロー アカウントに AD DS のセキュリティ グループを変更するための十分なアクセス許可があることを確認します。 |
プロパティ
AD DS コンピューターをグループに追加アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| コンピューター ドメイン | ComputerDomain | String | はい | コンピューターが配置されている完全修飾 DNS ドメイン名 (たとえば、contoso.com)。 |
| [コンピューター名] | FullyQualifiedComputerName | String | はい | コンピューターの名前です。 |
| グループ名 | FullyQualifiedGroupName | String | はい | Active Directory ドメイン サービス グループの名前。 |
AD DS コンピューターをグループに追加アクティビティは、次の表に示す出力を生成します。
| [表示名] | 内部名 | 型 | 説明 |
|---|---|---|---|
| 出力 | 出力 | Boolean | 操作の結果: True 加算が成功した場合は False 失敗した場合。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | なし | なし |
AD DS ユーザーをグループに追加するアクティビティ
このアクティビティにより、Service Manager の Active Directory ドメイン Services (AD DS) のセキュリティ グループにユーザーが追加されます。 ユーザーとグループは同じドメインに属している必要があり、ドメイン内のすべてのコンテナーが検索されます。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | このアクティビティを使用する場合は、Service Manager ワークフロー アカウントに AD DS のセキュリティ グループを変更するための十分なアクセス許可があることを確認します。 |
プロパティ
AD DS ユーザーをグループに追加 アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| ユーザー ドメイン | UserDomain | String | はい | ユーザーの完全修飾ドメイン名 (FQDN)。 |
| [ユーザー名] | UserName | String | はい | ユーザーのサインイン名。 |
| グループ名 | FullyQualifiedGroupName | String | はい | グループの FQDN。 |
AD DS ユーザーをグループに追加アクティビティは、次の表に示す出力を生成します。
| 表示名 | 内部名 | 型 | 説明 |
|---|---|---|---|
| 出力 | 出力 | Boolean | 操作の結果: True 追加に成功した場合は False 失敗した場合。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | なし | なし |
フロー アクティビティの制御
制御フロー アクティビティを使用して、Service Manager でワークフローの構造 (分岐、ループ、タイマー遅延) を提供します。
オーサリング ツールは、Activities ツールボックス ウィンドウの Control Flow グループに 4 つの既定の制御フロー アクティビティを提供します。
アクティビティの遅延
このアクティビティでは、Service Manager のワークフロー内のアクティビティ間の遅延が発生します。 Delay アクティビティは、Microsoft .NET Framework DelayActivity クラスから派生します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
Delay アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| TimeoutDuration の初期化 | InitializeTimeoutDuration | Internal | TimeoutDuration プロパティを初期化するハンドラーを指定します。 | |
| TimeoutDuration | TimeoutDuration | Timespan | はい | 遅延の期間。 |
Delay アクティビティは出力プロパティを生成しません。
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | このアクティビティの詳細については、.NET Framework クラス ライブラリの「 DelayActivity クラス 」を参照してください。 | なし |
For Each ループ アクティビティ
For Each Loop アクティビティは、オブジェクトの配列 (collection) を入力として受け取り、コレクション内の各オブジェクトに対してループ内のアクティビティのセットを繰り返します。 たとえば、入力コレクションに 5 つのオブジェクトがある場合、ループは 5 回反復処理します。 コレクションが空の場合、ループは反復処理されません。 コレクション内のオブジェクトの数に上限はありません。 For Each Loop アクティビティは、ワークフローが実行されているコンピューター上で常に実行されます。
For Each Loop アクティビティは、アクティビティ用の 2 つのコンテナーを含む複合アクティビティです。
入力コンテナー: このアクティビティはループを設定し、入力コレクションを定義します。 このロールでは、 Get インシデント または Get 仮想マシン アクティビティを使用できます。
ループ コンテナー: 名前付き ForEachChildActivity、このアクティビティにはループ アクティビティが含まれます。 このコンテナーに配置するほとんどの Windows Workflow Foundation (WF) アクティビティには、 Current Item と Property to Bind の 2 つのプロパティがあります。 ループ コンテナー内の各アクティビティに対して、次のようにこれらのプロパティを設定します。
Current Item ForEach アクティビティの Loop Container アクティビティの Current Item プロパティに設定します。 このアクティビティが For Each Loop アクティビティの最初のアクティビティである場合、 現在の項目 が自動的に設定されます。
Property の値を Bind プロパティの値に、Current Item 値を使用する現在のアクティビティのプロパティの値を設定します。
2 種類のアクティビティは、 Current Item プロパティと Property to Bind プロパティを取得しないため 入力コレクション内のオブジェクトを使用できません。
Windows PowerShell スクリプト アクティビティなどのスクリプト アクティビティ。
WorkflowActivityBase クラスから継承されないカスタム アクティビティまたはその他のアクティビティ。 このようなアクティビティには、ネイティブの Visual Studio アクティビティなど、 Activity 基底クラスに基づくアクティビティが含まれます。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
For Each Loop アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| Input コレクション | InputCollection | Array/Object | 該当なし | For Each Loop アクティビティ内のアクティビティに一度に 1 つずつ渡されるオブジェクトのコレクション。 入力コンテナーに存在するアクティビティが出力プロパティとしてオブジェクトの配列を生成する場合、 Input Collection はそのプロパティに自動的に設定されます。 このプロパティの現在の値を表示するには、ループ コンテナーを右クリックし、 Properties を選択します。 |
| 現在のアイテム | CurrentItem | Object | 該当なし | ループ内のアクティビティが入力プロパティとして使用できる Input Collection へのインデックス。 ループ コンテナー内の最初のアクティビティの場合、このプロパティは自動的に設定されます。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| For Each Loop アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 アクティビティは、次の条件下でエラーまたは例外を生成します。 - ForEachLoop アクティビティでエラーが発生し、子アクティビティに含まれていない場合、ワークフローは終了します。 - 子アクティビティ内でエラーが発生した場合、 ContinueOnError=true でない限り、ワークフローは終了します。 - 入力プロパティのいずれかが null の場合。 アクティビティは反復処理されません。 For Each Loop アクティビティ内の各アクティビティは、独自のエラーまたは例外をカスタム追跡サービスに書き込む必要があります。 For Each ループアクティビティ自体は実行されません。 |
なし | なし |
IfElse アクティビティ
このアクティビティは、ブール値 (True/False) 条件に基づいて、ワークフロー内のアクティビティのシーケンスを制御します。 条件には、スクリプト アクティビティなどの以前のアクティビティの結果を使用できます。
IfElse アクティビティは、ルールと条件を使用する Visual Studio アクティビティです。 Windows Workflow Foundation (WF) でルールと条件を使用する方法の詳細については、MSDN ライブラリの「 Tutorial: WF でルールと条件を使用する を参照してください。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
なし。
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | IfElse アクティビティの詳細については、.NET Framework 4 クラス ライブラリのIfElseActivity クラスを参照してください。 | なし |
並列活動
このアクティビティは、アクティビティのシーケンスを 2 つの同時アクティビティ シーケンスにフォークします。 Parallel アクティビティは Visual Studio アクティビティです。 ParallelActivity クラスの詳細については、.NET Framework クラス ライブラリの「ParallelActivity クラス」を参照してください。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
なし。
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | なし | なし |
Virtual Machine Manager アクティビティ
Service Manager の仮想マシン管理アクティビティを使用して、仮想マシンの作成と更新を可能にするワークフローを構築します。 仮想マシン管理アクティビティは、System Center Virtual Machine Manager をサポートします。
Service Manager 作成ツールは、Activities ツールボックス ペインの VMM アクティビティ グループに、次の 5 つの既定の仮想マシン管理アクティビティを提供します。
VM アクティビティを取得する
Service Manager でのこのアクティビティは、仮想マシン マネージャー (VMM) ライブラリから 1 つ以上の仮想マシン ID の一覧を取得します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。 - Service Manager ワークフロー アカウントに、Active Directory ドメイン Services (AD DS) のセキュリティ グループを変更するための十分なアクセス許可があることを確認します。 - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。 - Service Manager ワークフロー アカウントに、Active Directory ドメイン Services (AD DS) のセキュリティ グループを変更するための十分なアクセス許可があることを確認します。 |
プロパティ
Get VM アクティビティでは、次の表の入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| パラメーター セット | ParameterSet | String | いいえ;既定値は Connection です。 | 特定の目的のために編成されたパラメーターのサブセットを指定します。 Get VM アクティビティでは、次のいずれかのパラメーター セットを選択できます。 - All: 使用可能なすべての仮想マシンを検索します。 - ID: 既知の ID を持つ仮想マシンを検索します。 - Connection: VMMServer プロパティによって指定された仮想マシン マネージャー (VMM) サーバーに接続されている仮想マシンを検索します。 - VMHostGroup: VM Host プロパティによって指定された仮想マシン ホストに接続されている仮想マシンを検索します。 |
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定の設定は True です)。 | アクティビティが失敗した場合にワークフローの実行を続行するかどうかを決定します。 |
| エラーあり | HasError | 該当なし | アクティビティにエラーが設定されているかどうかを指定します。 (読み取り専用) | |
| すべて | すべて | Boolean | いいえ。 (既定の設定は True です)。 | Parameter Set が All の場合に使用できます。 True に設定されている場合、Get VM アクティビティは、使用可能なすべての仮想マシンの仮想マシン ID の一覧を返します。 |
| ID | ID | String | パラメーター セットが ID の場合に必要です。 | Parameter Set が ID の場合に使用できます。 True に設定されている場合、Get VM アクティビティは、仮想マシン ID が指定した ID 値のすべてまたは一部と一致するすべての仮想マシンの仮想マシン ID の一覧を返します。 |
| 管理グループ | ManagementGroup | String | いいえ | このアクティビティを実行する管理グループを指定します。 localhostに設定します。 (読み取り専用) |
| スクリプト サーバー | ターゲット | String | はい | Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhostを使用しないでください。 |
| スクリプトの時間制限 | TimeoutSeconds | Integer | いいえ。 (既定の設定は 300 秒です)。 | アクティビティの実行を許可する最大秒数を指定します。 |
| VM ホスト | VMHost | String | パラメーター セットがVMHostGroup の場合に必要です | Parameter Set が |
| VM 名 | VMName | String | いいえ | 検索する仮想マシンの名前または名前の一部を指定します。 文字列が名前の一部である場合、アクティビティは文字列を含むすべての仮想マシンの ID を取得します。 |
| VMMServer | VMMServer | String | はい | 仮想マシンを管理する System Center Virtual Machine Manager (VMM) サーバーの名前を指定します。 |
Get VM アクティビティは、次の表に示す出力を生成します。
| [表示名] | 内部名 | Type | Comments |
|---|---|---|---|
| VM ID | VMIDList | 文字列の配列 | VM Name 文字列のすべてまたは一部に一致する名前を持つ仮想マシンの ID の一覧を指定します。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| Get VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 | なし | なし |
VM アクティビティの移動
Service Manager でのこのアクティビティは、仮想マシン マネージャー (VMM) ライブラリからメンテナンス ホストに仮想マシンを移動します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。 - Service Manager ワークフロー アカウントに、Active Directory ドメイン Services (AD DS) のセキュリティ グループを変更するための十分なアクセス許可があることを確認します。 |
プロパティ
Move VM アクティビティでは、次の表の入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定の設定は True です)。 | アクティビティが失敗した場合にワークフローの実行を続行するかどうかを決定します。 |
| エラーあり | HasError | 該当なし | アクティビティにエラーが設定されているかどうかを指定します。 (読み取り専用) | |
| ホストがビジー状態の場合に LM をブロックする | BlockLMIfHostBusy | Boolean | いいえ。 (既定の設定は False です)。 | 移行元ホストまたは移行先ホストが既に別のライブ マイグレーションに参加しているため、移行に失敗した場合、Hyper-V ライブ マイグレーションの再試行をブロックします。 |
| ジョブ グループ | JobGroup | Guid (文字列) | いいえ | セットとして実行される一連のコマンドの識別子を指定します。 |
| ジョブ変数 | JobVariable | String | いいえ | ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。 |
| 管理グループ | ManagementGroup | String | いいえ | このアクティビティを実行する管理グループを指定します。 localhostに設定します。 (読み取り専用) |
| Path | Path | 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) サーバーの名前を指定します。 |
Move VM アクティビティは、次の表に示す出力を生成します。
| [表示名] | 内部名 | Type | Comments |
|---|---|---|---|
| VM ID | VMID | String | 移動された仮想マシンの一意の ID を指定します。 入力VM IDと出力VM IDは、アクティビティが入力VM IDに一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、等しくなります。 その場合、出力 VM ID は Null に設定されます。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| Move VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 | なし | なし |
VM のシャットダウン アクティビティ
Service Manager でのこのアクティビティにより、仮想マシン上のゲスト オペレーティング システムがシャットダウンされます。
Shutdown VMアクティビティは、仮想化ゲスト サービスが仮想マシンにインストールされている場合にのみ、Windows ベースのホスト (Hyper-V ホストまたは仮想サーバー ホスト) 上の仮想マシンで使用できます。 Hyper-V ホストにデプロイされている仮想マシンの場合、仮想化ゲスト サービスは統合コンポーネントと呼ばれます。 仮想サーバー ホストにデプロイされている仮想マシンの場合、仮想化ゲスト サービスは仮想マシンの追加と呼ばれます。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。 - Service Manager ワークフロー アカウントに、Active Directory ドメイン Services (AD DS) のセキュリティ グループを変更するための十分なアクセス許可があることを確認します。 |
プロパティ
Shutdown VM アクティビティでは、次の表に示す入力プロパティが使用されます。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| エラー時に続行 | 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) サーバーの名前を指定します。 |
Shutdown VM アクティビティは、次の表に示す出力を生成します。
| [表示名] | 内部名 | Type | Comments |
|---|---|---|---|
| VM ID | VMID | String | シャットダウンされた仮想マシンの一意の ID を指定します。 入力VM IDと出力VM IDは、アクティビティが入力VM IDに一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、等しくなります。 その場合、出力 VM ID は Null に設定されます。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| Shutdown VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 | なし | なし |
VM アクティビティの開始
Service Manager でのこのアクティビティにより、停止または一時停止された仮想マシンが開始されます。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
START VM アクティビティでは、次の表の入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| エラー時に続行 | 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) サーバーの名前を指定します。 |
START VM アクティビティは、次の表に示す出力を生成します。
| 表示名 | 内部名 | Type | Comments |
|---|---|---|---|
| VM ID | VMID | String | 起動された仮想マシンの一意の ID を指定します。 入力VM IDと出力VM IDは、アクティビティが入力VM IDに一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、等しくなります。 その場合、出力 VM ID は Null に設定されます。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| Start VM アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプト のプロパティのいずれかが解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 | なし | なし |
状態 VM アクティビティの保存
Service Manager でのこのアクティビティは、仮想マシンの状態を保存し、仮想マシンを停止します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | - Virtual Machine Manager コンソールと Service Manager の両方が同じサーバーにインストールされている必要があります。 - Service Manager ワークフロー アカウントに、Active Directory ドメイン Services (AD DS) のセキュリティ グループを変更するための十分なアクセス許可があることを確認します。 |
プロパティ
状態 VM アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| エラー時に続行 | 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 | Comments |
|---|---|---|---|
| VM ID | VMID | String | 保存された仮想マシンの一意の ID を指定します。 入力VM IDと出力VM IDは、アクティビティが入力VM IDに一致する VM ID を持つ仮想マシンを見つけられなかった場合を除き、等しくなります。 その場合、出力 VM ID は Null に設定されます。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| 状態 VM の保存アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 | なし | なし |
スクリプト アクティビティ
Service Manager のスクリプト アクティビティを使用して、ワークフローの一部としてスクリプトを実行します。
スクリプト活動はワークフローとは別のプロセスで実行されますが、Service Manager ワークフロー アカウントのセキュリティ コンテキストでも実行されます。
Service Manager 作成ツールは、Activities ツールボックス ペインの Script アクティビティ グループの Generic Script Activities サブグループに、次の 3 つの既定のスクリプト アクティビティを提供します。
コマンド スクリプト アクティビティ
このアクティビティは、Windows Workflow Foundation (WF) ワークフローの一部としてコマンド ライン スクリプトを実行します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
Command Script アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定の設定は True です)。 | アクティビティが失敗した場合にワークフローの実行を続行するかどうかを決定します。 |
| エラーあり | HasError | 該当なし | アクティビティにエラーが設定されているかどうかを指定します。 (読み取り専用) | |
| 管理グループ | ManagementGroupName | String | いいえ | スクリプト サーバーが属する管理グループを指定します。 既定では、これは localhost に設定されます。 (読み取り専用) |
| スクリプト パラメーター | パラメーター | Dictionary <string,string> | はい | 実行時にスクリプトに渡されるコマンド ライン スイッチまたはスイッチ/値ペアを指定します。 |
| スクリプト本文 | ScriptBody | String | はい | スクリプト自体のテキストを指定します。 |
| スクリプト サーバー | ターゲット | String | いいえ | Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhostを使用しないでください。 |
| スクリプトの時間制限 | TimeoutSeconds | Integer | いいえ。 (既定の設定は 300 秒です)。 | スクリプトの実行を許可する最大秒数を指定します。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| Command Script アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 | なし | なし |
Windows PowerShell スクリプト アクティビティ
Service Manager でのこのアクティビティは、Windows Workflow Foundation (WF) ワークフローの一部として Windows PowerShell スクリプトを実行します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| Windows PowerShell スクリプトアクティビティは、設計時に次の前提条件に依存します。 - Windows PowerShell 2.0 |
Windows PowerShell 2.0 |
プロパティ
Windows PowerShell スクリプト アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定の設定は True です)。 | アクティビティが失敗した場合にワークフローの実行を続行するかどうかを決定します。 |
| エラーあり | HasError | 該当なし | アクティビティにエラーが設定されているかどうかを指定します。 (読み取り専用) | |
| 管理グループ | ManagementGroupName | String | いいえ | スクリプト サーバーが属する管理グループを指定します。 既定では、これは localhost に設定されます。 (読み取り専用) |
| スクリプト パラメーター | パラメーター | Dictionary <string,string> | はい | 実行時にスクリプトに渡されるパラメーターの名前/値リストを指定します。 パラメーター値は、次のいずれかの管理パック参照に設定できます。 - $Target/...$ - $MPElement[...] - $Data/..$。 $Data参照は、実行時にのみパラメーターで解決されます (スクリプト自体では解決されません)。 パラメーターの唯一の値としてこれらの参照のいずれかを使用すると、そのパラメーターが入力データ項目を表す XML 文字列に設定されます ( GetItemXML)。 |
| スクリプト本文 | ScriptBody | String | はい | スクリプト自体のテキストを指定します。 |
| スナップイン | SnapIns | String | いいえ | 実行空間にプリロードする 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 スクリプトアクティビティは、設計時に次の前提条件に依存します。 なし。 |
なし |
プロパティ
VBScript Script アクティビティでは、次の表に示す入力プロパティを使用します。
| 表示名 | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定の設定は True です)。 | アクティビティが失敗した場合にワークフローが引き続き実行されるかどうかを判断します。 |
| エラーあり | HasError | 該当なし | アクティビティにエラーが設定されているかどうかを指定します。 (読み取り専用) | |
| 管理グループ | ManagementGroupName | String | いいえ | スクリプト サーバーが属する管理グループを指定します。 (既定では、これは localhost) に設定されます (読み取り専用) |
| スクリプト パラメーター | パラメーター | Dictionary <string,string> | はい | 標準スイッチの一覧と、このスクリプトが実行時に使用する関連する値を提供します。 |
| スクリプト本文 | ScriptBody | String | はい | スクリプト自体のテキストを指定します。 |
| スクリプト サーバー | ターゲット | String | いいえ | Service Manager コンソールを実行するサーバーのドメイン ネーム システム (DNS) 名を指定します。 localhostを使用しないでください。 |
| スクリプトの時間制限 | TimeoutSeconds | Integer | いいえ。 (既定の設定は 300 秒です)。 | スクリプトの実行を許可する最大秒数を指定します。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| VBScript スクリプト アクティビティは、Service Manager によって提供されるカスタム追跡サービスを使用して、アクティビティの実行時にエラーと例外をログに記録します。 スクリプトのプロパティを解決できない場合、アクティビティは必要に応じてエラーまたは例外を生成します。 | なし | なし |
Service Manager アクティビティ
Service Manager のアクティビティを使用して、Service Manager 関数をワークフローの一部にします。
Service Manager 作成ツールは、Activities ツールボックス ペインの SM アクティビティ グループに、次の 4 つの既定の Service Manager アクティビティを提供します。
インシデント アクティビティの作成
このアクティビティは、Service Manager でインシデントを作成して設定します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
Create Incident アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | 必須 | Comments |
|---|---|---|---|---|
| インシデント ID | IncidentID | String | はい | Incident オブジェクトに対して生成される一意識別子を指定します。 |
| アクション ログのコメント | ActionLogComment | String | はい | Incident オブジェクトのアクション ログに含めるコメントを指定します。 |
| 影響を受けるユーザー ドメイン | AffectedUserDomain | String | はい | インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。 |
| 影響を受けるユーザー名 | AffectedUserName | String | はい | インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。 |
| カテゴリ | カテゴリ | Integer | はい | Networking Printing などのインシデントの種類を指定します。 値は enum の ID です。 (カテゴリ -enum データ フィールド) |
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定の設定は true です)。 | アクティビティが失敗した場合にワークフローの実行を続行するかどうかを決定します。 |
| 影響 | 影響 | Integer | はい | 影響を受けるユーザーに対するインシデントの影響を指定します。 値は enum の ID です。 (Impact -enum データ型) |
| ソース | ソース | Integer | いいえ | Phone、E-mail など、インシデントに関する情報のソース指定。 値は enum の ID です。 (Source -enum データ型フィールド) |
| まとめ | まとめ | String | はい | インシデントを説明する概要テキストを指定します。 |
| 緊急度 | 緊急度 | Integer | はい | インシデントを解決する緊急性を指定します。 値は enum の ID です。 (Urgency -enum データ型フィールド) |
Create Incident アクティビティは、次の表に示す出力を生成します。
| 名前 | Type | Comments |
|---|---|---|
| SM インシデント | System.WorkItem.Incident | 構築されたインシデント クラス インスタンスを返します。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | なし | なし |
インシデント アクティビティを取得する
このアクティビティは、Service Manager で 1 つ以上のインシデントを取得します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
Get Incident アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | 必須 | Comments |
|---|---|---|---|---|
| 影響を受けるユーザー ドメイン | AffectedUserDomain | String | いいえ | インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。 |
| 影響を受けるユーザー名 | AffectedUserName | String | いいえ | インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。 |
| カテゴリ | カテゴリ | Integer | いいえ | Networking Printing などのインシデントの種類を指定します。 値は enum の ID です。 (カテゴリ -enum データ フィールド) |
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定値は true です。) | アクティビティが失敗した場合にワークフローの実行を続行するかどうかを決定します。 |
| インシデント ID | IncidentID | String | いいえ | インシデント オブジェクトに対して生成される一意の識別子を指定します。 |
| 検索の種類 | SearchType | Integer | いいえ | アクティビティで使用される検索の種類のタイトルを指定します。 |
| 状態 | 状態 | Integer | いいえ | インシデントの状態を指定します。 値は enum の ID です。 (Status -enum data フィールド) |
| 概要テキスト | SummaryText | String | いいえ | インシデントを説明する概要テキストを指定します。 |
Get Incident アクティビティは、次の表に示す出力を生成します。
| [表示名] | 内部名 | Type | Comments |
|---|---|---|---|
| SM インシデント | SMIncidents | System.Workitem.Incident の配列 | インシデント オブジェクトの配列を指定します。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | Get Incident アクティビティには、入力プロパティに対してエラー検証を実行する独自の検証コントロールがあります。 | なし |
インシデント アクティビティの更新
Service Manager でのこのアクティビティは、プロパティの変更を 1 つの Service Manager インシデントに保存します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし |
プロパティ
Update Incident アクティビティでは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| アクション ログのコメント | ActionLogComment | String | いいえ | Incident オブジェクトのアクション ログに含めるコメントを指定します。 |
| 影響を受けるユーザー ドメイン | AffectedUserDomain | String | いいえ | インシデントの影響を受けるプライマリ ユーザーのドメイン ネーム システム (DNS) ドメインの名前を指定します。 |
| 影響を受けるユーザー名 | AffectedUserName | String | いいえ | インシデントの影響を受けるプライマリ ユーザーのユーザー名を指定します。 |
| カテゴリ | カテゴリ | Integer | いいえ | Networking Printing などのインシデントの種類を指定します。 値は enum の ID です。 (Category -enum データ型) |
| エラー時に続行 | ContinueOnError | Boolean | いいえ。 (既定の設定は true です)。 | アクティビティが失敗した場合にワークフローの実行を続行するかどうかを決定します。 |
| 影響 | 影響 | Integer | いいえ | 影響を受けるユーザーに対するインシデントの影響を指定します。 値は enum の ID です。 (Impact -enum データ型) |
| ソース | ソース | Integer | いいえ | Phone、E-mail など、インシデントに関する情報のソース指定。 値は enum の ID です。 (Source -enum データ型) |
| Service Manager インシデント | SMIncident | System.Workitem.Incident | いいえ | 更新する構築済みのインシデント クラス インスタンス。 |
| 状態 | 状態 | Integer | いいえ | アクティビティを生成したインシデントの状態を指定します。 値は enum の ID です。 (Status -enum データ型) |
| まとめ | まとめ | String | いいえ | インシデントを説明する概要テキストを指定します。 |
| 緊急度 | 緊急度 | Integer | いいえ | インシデントを解決する緊急性を指定します。 値は enum の ID です。 (Urgency -enum データ型フィールド) |
Update Incident アクティビティは、次の表に示す出力を生成します。
| [表示名] | 内部名 | 型 | 説明 |
|---|---|---|---|
| SM インシデント | SMIncident | System.WorkItem.Incident | インシデント クラス インスタンスの更新を返します。 入力 SM インシデント と出力 SM インシデント は、アクティビティが SM インシデントを見つけられなかった場合は等しくなります。 その場合、出力 SM Incident は Null に設定されます。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | なし | なし |
[アクティビティの状態] を [完了] アクティビティに設定する
このアクティビティは、Service Manager の自動アクティビティの状態を更新します。
| 設計時の前提条件 | 実行時の前提条件 |
|---|---|
| なし | なし。 |
プロパティ
アクティビティの状態を完了に設定アクティビティは、次の表に示す入力プロパティを使用します。
| [表示名] | 内部名 | Type | Required | 説明 |
|---|---|---|---|---|
| 活動 ID | ActivityID | String | はい | Service Manager の自動アクティビティ オブジェクトの識別子を指定します。 |
| エラーと例外 | 解説 | 例 |
|---|---|---|
| なし | Service Manager の自動アクティビティによってトリガーされるワークフローでこのアクティビティを使用する場合は、このプロパティの値として「 $Data/BaseManagedEntityId$ 」と入力します。 この値は、ワークフローの実行をトリガーした自動アクティビティの アクティビティの状態を完了 アクティビティに適用されます。 | なし |