Runbook の例: Runbook を使用してフォルダーを監視する
この記事では、新しいテキスト ファイルのフォルダーを監視する単純な Runbook を作成する方法について説明します。 ファイルが検出されると、Runbook はイベント ログのメッセージを送信してから、別の Runbook を開始します。
![[監視フォルダー] のスクリーンショット。](media/monitor-a-folder-within-a-runbook/orch-2016-sample-monitor-folder.png?view=sc-orch-2019)
モニター Runbook の作成とテスト
フォルダーを監視する単純な Runbook を作成、構成、テストする手順を以下に示します。
ワークフローを作成する
ワークフローを作成するには、次の手順に従います。
Runbook Designer Connections ペインで、 Runbooks フォルダーを右クリックして New を選択し、 Runbook を選択します。
[ 新しい Runbook ] タブを右クリックして、[ 名前の変更] を選択します。
[ 確認 ダイアログボックスで、 Yesを選択します。
Runbook の名前 ( Monitor Runbook など) を入力し、Enter キーを押します。
Activities ペインで、File Management を選択してカテゴリを展開し、Monitor Folder アクティビティを Runbook Designer Design ワークスペースにドラッグします。
Activities ペインで Notification を選択してカテゴリを展開し、Send イベント ログ メッセージ アクティビティを Runbook Designer Design ワークスペースにドラッグして、Monitor Folder アクティビティの右側に移動します。
[ Runbook Designer ] デザイン ワークスペースで、カーソルを [ フォルダーの監視 ] 活動の右側に置いて、スマート リンクの矢印を表示させます。
スマート リンクの矢印を選択し、 Send イベント ログ メッセージ アクティビティにドラッグします。
Activities ペインで、Runbook Control を選択してカテゴリを展開し、Invoke Runbook アクティビティを Runbook Designer Design ワークスペースにドラッグして、イベント ログ メッセージの送信アクティビティの右側に移動します。
[ Runbook Designer ] デザイン ワークスペースで、カーソルを [ イベント ログ メッセージの送信 ] 活動の右側に置いて、スマート リンクの矢印を表示させます。
スマート リンクの矢印を選択し、 Invoke Runbook アクティビティにドラッグします。
ワークフローを構成する
ワークフローを構成するには、次の手順に従います。
[ Runbook Designer ] デザイン ワークスペースで、[ フォルダーの監視 ] 活動をダブルクリックします。
Monitor フォルダーのプロパティ ダイアログ ボックスで、General タブを選択します。
[ Name ボックスで、アクティビティの名前を有益なものに変更します。 たとえば、 Monitor C:\Monitor フォルダー。
詳細タブを選択します。
[ Details ] タブの [ Path ボックスに、監視するフォルダーのパスを入力します。 たとえば、 C:\Monitor。
ファイル フィルター一覧の下にある [追加] 選択。
[ Filter の設定 ダイアログで、次の設定を行います。
[ 名前 ] 一覧で、[ ファイル名] を選択します。
[ 関係 ] 一覧で、[ 次のパターンと一致する] を選択します。
[ Value ボックスに、「 *.txt」と入力します。
この設定で、拡張子が txt のファイルを探して監視するようになります。 このフィールドは、正規表現の構文を入力できます。
[OK] を選択します。
[トリガー] タブを選択します。
[ファイルの数] オプション選択し、一覧の値を より大きい値に設定し編集ボックスに「0」と入力します。
完了 を選択します。
[ Runbook Designer ] デザイン ワークスペースで、[ イベント ログ メッセージの送信] 活動をダブルクリックします。
[イベント ログ メッセージのプロパティの送信] ダイアログの [Details] タブの [Properties セクションで、次の値を設定します。
[ Computer ボックスに、イベント メッセージを受信するコンピューターの名前を入力します。
これは通常、Runbook Designer を実行しているコンピューターです。
[ Message ボックスに、イベント ログに表示するメッセージを入力します。 たとえば、 File Detected。
[ 重要度 ] レベルは [ 情報] にします。
[完了] を選択します。
Note
このサンプルでは、 Invoke Runbook アクティビティは構成されていません。
Runbook の設定を変更する
Runbook の設定を変更するには、次の手順に従います。
[ Runbook Designer ] のデザイン ワークスペースで、[ モニター Runbook ] のタブを右クリックして [ プロパティ] を選択します。
Monitor Runbook のプロパティ ダイアログで、ログ タブを選択し、Store アクティビティ固有の戻りデータと Store Common Returned Data の両方を選択します。
完了 を選択します。
[ モニター Runbook ] を右クリックして、[ チェックイン] を選択します。
Runbook をテストする
Runbook Tester では、ランタイムがシミュレートされるデバッグ環境で、Runbook をテストできます。 Runbook 全体の実行、1 度に 1 つの活動をステップスルー、または、選択した任意の活動でシミュレーションを停止するブレークポイントの追加をすることができます。
Runbook Testerで Runbook をテストするには、次の手順に従います。
コンピューターを準備する
コンピューターを準備するには、次の手順に従います。
[ スタート ] を右クリックして [ エクスプローラーを開く] を選択します。
コンピューターに C:\Monitor フォルダーを作成します。
コンピューターに C:\Source フォルダーを作成します。
C:\Source フォルダーに、拡張子が txt のファイルを作成します。 たとえば、 text.txt。
Runbook をテストする
Runbook をテストするには、次の手順に従います。
[ Runbook Designer ] デザイン ワークスペースで、[ モニター Runbook ] タブをダブルクリックします。
Runbook Designer Design ワークスペースの上にあるツール バーで、Runbook Tester を選択します。
[ 確認 ダイアログボックスで、 Yesを選択します。
Runbook Tester ツール バーの Step Over を選択して Runbook のステップ実行を開始します。
ヒント
[ ログ ] ウィンドウのサイズを大きくするには、 メニューの [ 表示 ] を選択し、[ リソース ブラウザー ] オプションをオフにして、[ リソース ブラウザー ] ウィンドウを削除します。
エクスプローラーで C:\Source フォルダー内を表示します。
test.txt を C:\Monitorにコピーします。
エクスプローラーを閉じます。
Runbook Tester ツール バーの Next を選択します。
しばらくすると、 Log ペインエントリが更新され、 Monitor Folder アクティビティのイベントが表示されます。
Log ペインで、Show Details リンクを選択して、その Runbook のデータ バスの内容を表示します。
プロパティの一覧を、下にスクロールします。 アクティビティの状態が success の場合は、 Monitor Folder アクティビティによってフォルダー内の変更が検出されたことを示します。
Runbook Tester ツール バーの Next を選択します。
[ ログ ] ウィンドウが変更され、 イベント ログ メッセージの送信 活動のイベントが表示されていることを確認します。
Show の詳細リンクを選択します。 アクティビティの状態が success の場合は、 Send イベント ログ メッセージ アクティビティがフォルダー内の変更を検出したことを示します。
[ Runbook Tester] を閉じます。
実行デザイナーツール バーで、チェックインを選択します。