スクリプトタスクの設定 | Workspace Environment Managementサービス

スクリプトタスクの設定

October 15, 2024

寄稿者:

C C

[スクリプト化されたタスク] ページで使用可能なすべてのスクリプト化されたタスクを一覧表示します 。スクリプト化されたタスクは構成セットレベルで実行されます。ここでは、現在の構成セットに対して有効にするスクリプト化されたタスクを設定します。スクリプト化されたタスクを編集するには、[スクリプト化されたタスク]に移動します。

スクリプト化されたタスクを設定する

[ スクリプト化されたタスクの設定] ページで、スクリプト化されたタスクを探して省略記号を選択し、[ 構成] を選択します。

[ スクリプトタスクの構成 ] ウィザードで、次の設定を構成し、[ 保存] をクリックします。

[ トリガー]で:

このタスクを有効にします。現在の構成セットに対してタスクを有効 (Yes) または無効 (No) にするかを選択します。無効にすると、エージェントはタスクを処理しません。

署名を検証します。タスクを実行する前に署名を検証するかどうかを選択します。スクリプト化されたタスクにフルアクセス権が付与されている場合、署名の検証は必須です。

タスクタイムアウト。タスクにタイムアウト (分単位) を設定するかどうかを選択します。タイムアウトが発生すると、タスクは強制的に終了します。サポートされる値:1—60。タスクのタイムアウトを設定することをお勧めします。そうしないと、タスクが実行されたままになり、他のタスクが実行されなくなる可能性があります。

[フィルタ]。フィルターを選択して、タスクをコンテキスト化するかどうかを選択します。フィルタを選択すると、このタスクはフィルタのすべての条件が満たされた場合にのみ実行されます。フィルターを選択するときは、次の点を考慮してください。

スクリプト化されたタスクに適用されない条件がフィルタに含まれている場合、エージェントはタスクを実行する前にフィルタを評価するときにそれらの条件をスキップします。スクリプト化されたタスクに適用されない条件の完全なリストについては、マシン設定に適用されない条件を参照してください。

[ パラメータ]:

タスクのトリガーを構成します。以下の操作を実行できます：

タスクに関連付けるトリガーを選択します。アクティブ化されると、これらのトリガーはユーザー環境でタスクを開始します。
このタスクに適用されるトリガーのみを表示するかどうかを選択します。
新しいトリガーを作成します。「トリガーを作成する」を参照してください。

注意:

既存のトリガーを編集するには、[ トリガー] に移動します。

一般:

スクリプト化されたタスクにパラメーターを渡します。スクリプトタスクにパラメータを渡すかどうかを選択します。有効にすると、実行時にスクリプトタスクにパラメータ変数として入力を提供できます。この利点は、基になるコードを変更することなく、スクリプトタスクの動作を制御できることです。次のパラメータタイプを使用できます。

整数。例：123
ストリング。例：hello world
ブール値。 True または False。
キャラクター。例：c
[スイッチ]。 True または False。
ダブル。例: 1.023。
日付と時刻。例：YYYY-MM-DD HH:mm:ss
ファイルパス。 System.IO.FileInfo クラスに渡すパスを入力します。環境変数がサポートされています。パスには、次の文字を含めないでください： * ? < >。

注意:

最大 20 個のパラメータを設定できます。

name フィールドは、「switch」タイプのパラメータを除いて任意です。

PowerShell は部分的なパラメーター名をサポートしています。部分的なパラメータ名を使用するときは、名前が一意であることを確認してください。既存のパラメータ名と明確に区別してください。例:次のパラメーター名は PowerShell でも同じです：-t、-ti、-title。この場合、他のパラメータと区別できるように、パラメータ名に十分な文字を指定します。

出力内:

出力ファイル。 タスクが出力するファイルを収集するかどうかを選択します。選択すると、タスクに対して生成されるレポートに出力ファイルの内容が含まれます。これにより、ユーザー環境で出力ファイルにアクセスしなくても、レポートに出力ファイルの内容を表示できます。

ハイライトを出力します。出力ファイルの内容とコンソール出力で、特定の内容をハイライト表示するかどうかを選択します。

キーワードを強調表示します。 レポートで強調表示するキーワードを指定します。複数のキーワードをカンマで区切って入力できます。キーワードを入力したら、 Enter キーを押して続行します。指定すると、キーワードに一致するレポートコンテンツが、生成されたレポートの [ 出力ファイルの内容 ] セクションと [コンソール出力 ] セクションで強調表示されます。
正規表現の一致を強調表示します。強調表示するコンテンツを表す正規表現を入力します。正規表現は、PCRE 互換の .NET 正規表現ライブラリ構文に準拠している必要があります。詳しくは、Microsoft社のドキュメントを参照してください：https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference。
- 正規表現。 強調表示するコンテンツを表す正規表現を入力します。
- 大文字と小文字を区別しません。コンテンツの大文字と小文字が正確に一致する必要があるかどうかを選択します。
- 複数行一致を使用します。複数行一致を使用するかどうかを選択します。 ^ と $ は、出力コンテンツ全体の先頭と末尾ではなく、各行の先頭と末尾に一致します。
- 名前付きグループのみをキャプチャします。名前付きグループのみをキャプチャするかどうかを選択します。キャプチャされたグループは、正規表現パターンで括弧を使用して定義されます。名前付きグループには、(?<name> subexpression)構文によって名前または番号が明示的に割り当てられます。
- コンテキストの手がかりとして含める行数。コンテキストの手がかりとして、ハイライトに含める一致の前後の行数を指定します。サポートされる値は 1 ～ 10 です。
- レポートには正規表現の一致のみを含めます。出力コンテンツ全体をレポートに含めるか、正規表現に一致するコンテンツのみを含めるかを制御します。このオプションを有効にすると、Citrix Cloud に送信されるデータ量が減少します。このオプションを有効にすると、キーワードの強調表示機能には、指定されたキーワードに関係なく表示するコンテンツがありません。

詳細オプション。

ランタイムエラーが発生しても出力を収集します。タスクの実行中にエラーが発生した場合でも、出力ファイルの内容とコンソール出力を収集するかどうかを制御します。

スクリプト化されたタスクのレポートを表示する

[ スクリプト化されたタスクの設定] ページで、スクリプト化されたタスクを探して省略記号を選択し、[ レポートの表示] を選択します。その結果、[ Monitoring] > [Reports ] ページが表示され、タスクに関連するレポート (存在する場合) が表示されます。省略記号をクリックすると、詳細情報が表示されます。詳しくは、「レポート」を参照してください。

この情報は役に立ちましたか?