スクリプトタスク
ヒント:
スクリプトタスクはマシンレベルで動作します。ユーザーセッションレベルでタスクを実行するには、代わりに外部タスクを使用します。
このページでは、環境管理のニーズに合わせてスクリプトタスクを構成および自動化できます。
スクリプトタスクを作成する
スクリプトは、組み込みスクリプトとカスタムスクリプトの2種類に分類されます。各タイプには、スクリプトビューとタスクビューの2つの表示モードがあります。すべてのスクリプトタスクは、構成セットレベルで実行されます。
スクリプトからタスクを作成するには、次の手順に従います。
注:
スクリプトタスクを作成した後、スクリプトリストから直接管理できます。スクリプトを展開してタスクを表示し、タスク行にカーソルを合わせると、表示、編集、削除のアクションアイコンにアクセスできます。
一般
一般ページで次の設定を構成します。
-
このタスクを有効にする。現在の構成セットでタスクを有効にするか (はい)、無効にするか (いいえ) を選択します。無効にすると、エージェントはタスクを処理しません。
-
署名を検証する。タスクを実行する前に署名を検証するかどうかを選択します。スクリプトタスクにフルアクセスが許可されている場合、署名検証は必須です。
-
タスクのタイムアウト。タスクのタイムアウト（分単位）を設定するかどうかを選択します。タイムアウトが発生すると、タスクは強制的に終了されます。サポートされている値：1～60。タスクにタイムアウトを設定することをお勧めします。そうしないと、タスクが実行されたままになり、他のタスクの実行が妨げられる可能性があります。
-
フィルター。フィルターを選択してタスクをコンテキスト化するかどうかを選択します。フィルターが選択されている場合、このタスクはフィルター内のすべての条件が満たされた場合にのみ実行されます。フィルターを選択する際は、次の点を考慮してください。
-
フィルターにスクリプトタスクに適用されない条件が含まれている場合、エージェントはタスクを実行する前にフィルターを評価する際にそれらの条件をスキップします。スクリプトタスクに適用されない条件の完全なリストについては、「マシン設定に適用されない条件」を参照してください。
-
パラメーター
パラメーターページで次の設定を構成します。
-
スクリプトタスクにパラメーターを渡す。スクリプトタスクにパラメーターを渡すかどうかを選択します。有効にすると、実行時にスクリプトタスクにパラメーター変数として入力を提供できます。これにより、基になるコードを変更せずにスクリプトタスクの動作を制御できるという利点があります。次のパラメータータイプが利用可能です。
-
整数。例：
123。 -
文字列。例：
hello world。 -
ブール値。True または False。
-
文字。例:
c。 -
スイッチ。True または False。
-
倍精度浮動小数点数。例:
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 に送信されるデータ量が削減されます。このオプションを有効にすると、指定されたキーワードに関係なく、キーワードの強調表示機能には表示するコンテンツがありません。
-
-
-
詳細オプション。
-
ランタイムエラーが発生した場合でも出力を収集する。タスクの実行中にエラーが発生した場合でも、出力ファイルの内容とコンソール出力を収集するかどうかを制御します。
-
スクリプトタスクのレポートを表示する
-
スクリプトタスクページで、スクリプト行のタスクドロップダウンメニューをクリックして、タスクリストを展開します。
-
タスクにカーソルを合わせると、アクションアイコンが表示されます。
-
レポートの表示アイコンをクリックします。
その結果、監視 > レポートページに移動し、タスクに関連するレポート（存在する場合）が表示されます。詳細情報を表示するには、省略記号をクリックします。詳細については、「レポート」を参照してください。
注:
ログオンユーザーとして実行に設定されているスクリプトタスクを実行するには、監視 > 管理 > エージェントで最近接続されたエージェントを選択し、その他 > スクリプトタスクの実行を選択します。