スクリプトタスク設定
「スクリプトタスク」ページで利用可能なすべてのスクリプトタスクを一覧表示します。スクリプトタスクは構成セットレベルで実行されます。ここでは、現在の構成セットで有効にするスクリプトタスクを構成します。スクリプトタスクを編集するには、「スクリプトタスク」に移動します。
スクリプトタスクを構成する
-
「スクリプトタスク設定」ページで、スクリプトタスクを見つけ、省略記号を選択し、「構成」を選択します。
-
「スクリプトタスクの構成」ウィザードで、次の設定を構成し、「保存」をクリックします。
「一般」で:
-
「このタスクを有効にする」。現在の構成セットでタスクを有効にする（はい）か無効にする（いいえ）かを選択します。無効になっている場合、エージェントはタスクを処理しません。
-
「署名を検証する」。タスクを実行する前に署名を検証するかどうかを選択します。スクリプトタスクにフルアクセスが許可されている場合、署名検証は必須です。
-
「タスクのタイムアウト」。タスクのタイムアウト（分単位）を設定するかどうかを選択します。タイムアウトが発生すると、タスクは強制的に終了されます。サポートされる値: 1～60。タスクにタイムアウトを設定することをお勧めします。そうしないと、タスクが実行されたままになり、他のタスクの実行が妨げられる可能性があります。
-
「フィルター」。フィルターを選択してタスクをコンテキスト化するかどうかを選択します。フィルターが選択されている場合、このタスクはフィルター内のすべての条件が満たされた場合にのみ実行されます。フィルターを選択する際は、次の点を考慮してください。
-
フィルターにスクリプトタスクに適用されない条件が含まれている場合、エージェントはタスクを実行する前にフィルターを評価する際にそれらの条件をスキップします。スクリプトタスクに適用されない条件の完全なリストについては、「マシン設定に適用されない条件」を参照してください。
-
「トリガー」で:
「パラメーター」で:
-
スクリプト化されたタスクにパラメーターを渡す。スクリプト化されたタスクにパラメーターを渡すかどうかを選択します。有効にすると、実行時にスクリプト化されたタスクでパラメーター変数として入力を提供できます。これにより、基になるコードを変更せずにスクリプト化されたタスクの動作を制御できるという利点があります。次のパラメータータイプが利用可能です:
-
整数。例:
123。 -
文字列。例:
hello world。 -
ブール値。True または False。
-
文字。例:
c。 -
スイッチ。True または False。
-
倍精度。例：
1.023。 -
日付と時刻。例:
YYYY-MM-DD HH:mm:ss。 -
ファイルパス。
System.IO.FileInfoクラスに渡すパスを入力します。環境変数がサポートされています。パスには次の文字を含めることはできません:* ? < >。
注:-
最大20個のパラメーターを設定できます。
-
名前フィールドは、「switch」タイプのパラメーターを除き、オプションです。
-
PowerShellは部分的なパラメーター名をサポートしています。部分的なパラメーター名を使用する場合は、その名前が一意であることを確認してください。既存のパラメーター名と区別してください。例: PowerShellでは、次のパラメーター名は同じです:
-t、-ti、および-title。この場合、他のパラメーターと区別するために、パラメーター名の十分な文字を指定してください。
-
「出力」で:
-
「出力ファイル」。タスクが出力するファイルを収集するかどうかを選択します。選択した場合、タスク用に生成されたレポートに出力ファイルの内容が含まれます。これにより、ユーザー環境で出力ファイルにアクセスすることなく、レポートで出力ファイルの内容を表示できます。
-
「出力のハイライト」。出力ファイルの内容とコンソール出力で特定のコンテンツをハイライト表示するかどうかを選択します。
-
「キーワードのハイライト」。レポートでハイライト表示するキーワードを指定します。複数のキーワードをコンマで区切って入力できます。キーワードを入力したら、Enter キーを押して続行します。指定した場合、生成されたレポートの「出力ファイルの内容」および「コンソール出力」セクションで、キーワードに一致するレポートコンテンツがハイライト表示されます。
-
「正規表現の一致をハイライト」。ハイライト表示するコンテンツを記述する正規表現を入力します。正規表現は、PCRE互換の.NET正規表現ライブラリ構文に準拠している必要があります。詳細については、Microsoftのドキュメントを参照してください:
<https://docs.microsoft.com/ja-jp/dotnet/standard/base-types/regular-expression-language-quick-reference>。-
「正規表現」。ハイライト表示するコンテンツを記述する正規表現を入力します。
-
「大文字と小文字を区別しない」。コンテンツが大文字と小文字を正確に一致させる必要があるかどうかを選択します。
-
「複数行マッチングを使用」。複数行マッチングを使用するかどうかを選択します。複数行マッチングでは、\^ と \$ は出力コンテンツ全体の先頭と末尾ではなく、各行の先頭と末尾に一致します。
-
「名前付きグループのみをキャプチャ」。名前付きグループのみをキャプチャするかどうかを選択します。キャプチャされたグループは、正規表現パターンで括弧を使用して定義されます。名前付きグループは、
(?<name> subexpression)構文によって明示的に名前または番号が割り当てられます。 -
「コンテキストの手がかりとして含める行数」。ハイライトにコンテキストの手がかりとして含める、一致の前後の行数を指定します。サポートされる値: 1～10。
-
「レポートに正規表現の一致のみを含める」。レポートにすべての出力コンテンツを含めるか、正規表現に一致するコンテンツのみを含めるかを制御します。このオプションを有効にすると、Citrix Cloud に送信されるデータ量が削減されます。このオプションを有効にすると、「キーワードのハイライト」機能は、指定されたキーワードに関係なく、表示するコンテンツがなくなります。
-
-
-
「詳細オプション」。
-
「ランタイムエラーが発生した場合でも出力を収集」。タスクの実行中にエラーが発生した場合でも、出力ファイルの内容とコンソール出力を収集するかどうかを制御します。
-
スクリプトタスクのレポートを表示する
「スクリプトタスク設定」ページで、スクリプトタスクを見つけ、省略記号を選択し、「レポートの表示」を選択します。その結果、「監視 > レポート」ページに移動し、タスクに関連するレポート（存在する場合）が表示されます。詳細情報を表示するには、省略記号をクリックします。詳細については、「レポート」を参照してください。