スクリプトタスク設定

スクリプトタスクを構成する

1. 「スクリプトタスク設定」ページで、スクリプトタスクを見つけ、省略記号を選択し、「構成」を選択します。
2. 「スクリプトタスクの構成」ウィザードで、次の設定を構成し、「保存」をクリックします。

• 「このタスクを有効にする」。現在の構成セットに対してタスクを有効にする（はい）か無効にする（いいえ）かを選択します。無効になっている場合、エージェントはタスクを処理しません。
• 「署名を検証する」。タスクを実行する前に署名を検証するかどうかを選択します。スクリプトタスクにフルアクセスが許可されている場合、署名検証は必須です。
• 「タスクのタイムアウト」。タスクのタイムアウト（分単位）を設定するかどうかを選択します。タイムアウトが発生すると、タスクは強制的に終了します。サポートされる値: 1～60。タスクにタイムアウトを設定することをお勧めします。そうしないと、タスクが実行されたままになり、他のタスクの実行が妨げられる可能性があります。
• 「フィルター」。フィルターを選択してタスクをコンテキスト化するかどうかを選択します。フィルターが選択されている場合、このタスクはフィルター内のすべての条件が満たされた場合にのみ実行されます。フィルターを選択する際は、次の点を考慮してください。
  • フィルターにスクリプトタスクに適用されない条件が含まれている場合、エージェントはタスクを実行する前にフィルターを評価する際にそれらの条件をスキップします。スクリプトタスクに適用されない条件の完全なリストについては、「マシン設定に適用されない条件」(/ja-jp/workspace-environment-management/service/manage/configuration-sets/assignment.html#conditions-not-applicable-to-machine-settings)を参照してください。

• タスクのトリガーを構成します。次のことができます。
  • タスクに関連付けるトリガーを選択します。アクティブ化されると、これらのトリガーはユーザー環境でタスクを開始します。
  • このタスクに適用されるトリガーのみを表示するかどうかを選択します。
  • 新しいトリガーを作成します。「トリガーの作成」を参照してください(/ja-jp/workspace-environment-management/service/manage/configuration-sets/triggers.html#create-a-trigger)。
  注:
  既存のトリガーを編集するには、「トリガー」に移動します(/ja-jp/workspace-environment-management/service/manage/configuration-sets/triggers.html)。

• スクリプト化されたタスクにパラメーターを渡す。スクリプト化されたタスクにパラメーターを渡すかどうかを選択します。有効にすると、実行時にスクリプト化されたタスクでパラメーター変数として入力を提供できます。これにより、基になるコードを変更せずにスクリプト化されたタスクの動作を制御できるという利点があります。次のパラメータータイプが利用可能です。
  • 整数。例: 123。
  • 文字列。例: hello world。
  • ブール値。真または偽。
  • 文字。例: c。
  • スイッチ。真または偽。
  • 倍精度浮動小数点数。例: 1.023。
  • 日付と時刻。例: YYYY-MM-DD HH:mm:ss。
  • ファイルパス。System.IO.FileInfoクラスに渡したいパスを入力します。環境変数がサポートされています。パスには次の文字を含めることはできません: * ? < >。
  注:
  • 最大20個のパラメーターを設定できます。
  • 名前フィールドは、「スイッチ」タイプのパラメーターを除き、オプションです。
  • 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 に送信されるデータ量が削減されます。このオプションを有効にすると、指定されたキーワードに関係なく、「キーワードをハイライト表示」機能には表示するコンテンツがありません。
• 詳細オプション。
  • ランタイムエラーが発生した場合でも出力を収集。タスクの実行中にエラーが発生した場合でも、出力ファイルの内容とコンソール出力を収集するかどうかを制御します。

スクリプトタスクのレポートを表示する