配布設定
[配布] > [設定] ページを使用して、アプリのリターン コードのマッピングを構成します。 実行可能ファイルおよびスクリプト パッケージのアクションは、終了時にさまざまな結果を示す正または負の数値コードを返す場合があります。 これらのリターン コードはアプリの状態に影響し、アクションが成功したのか、失敗したのか、再起動が必要なのかを決定します。
カスタムのリターン コード マッピングを使用して、EXE アクション、MSI アクション、スクリプト アクションの結果をカスタマイズします。 たとえば、Microsoft の robocopy ユーティリティには、成功を示すリターン コードがいくつかあります。 既定では、実行可能ファイルに関するゼロ以外のリターン コードは失敗を示します。 これらのゼロ以外のリターン コードを「成功」にマップする、robocopy 用のカスタム リターン コード マッピングを作成すると、パッケージ処理を続行させることができます。
リターン コードは、各配布の一部としてデバイス上のログに保存されます。 ログとログへのアクセス方法の詳細については、「検出ルールとアクション ロギング」をご参照ください。
数値のリターン コードをログに保存するだけでなく、それらのリターン コードを情報文字列にマップすることもできます。 リターン コードを記述するこれらの文字列もログに表示されます。
リターン コード テンプレートには次の3つのタイプがあります。
- ユーザが作成する新しいテンプレート。
- 既存のテンプレートの複製。 既存のテンプレートを複製するには、そのテンプレートの右側にあるオプション メニュー (
) を使用します。
- 1つを既定のテンプレートとしてマークすること以外、編集や削除はできない既定のテンプレート。 複製されたほうを編集できます。
これらは既定のリターン コード テンプレートです。 これらのテンプレート内のマップされていないリターン コードに対する既定の動作は、失敗です。
- システム テンプレート - 既定の MSI: MSI リターン コードの標準化されたセットが含まれています。 これらは事前構成されています。
- システム テンプレート - 既定の EXE: 成功を示す数値0のリターン コード マッピングが1つ含まれています。
- システム テンプレート - 既定の PowerShell: 2つのリターン コード マッピングが含まれています。 数値0は成功を示し、数値1は失敗を示します。
MSI、EXE、PowerShell の各テンプレート タイプのいずれかを既定としてマークできます。 [リターン コードのマッピング] リストには、どのテンプレートが既定であるかを示す列があります。 既定を変更するには、テンプレートを編集し、そのオプションを選択します。
リターン コード テンプレートをサポートするパッケージ アクションを作成すると、既定が事前に選択されます。 既定を使用したくない場合は、そのアクション タイプの他のテンプレートから選択できます。 テンプレートに加えた変更は、次回配布エンジンがクライアント上で実行されたときに有効になります。
MSI リターン コード テンプレートには、3010、成功 - 再起動が必要というリターン コード マッピングが含まれています。 この結果は「成功」と同じですが、その配布に関するデバイスのログには、ある時点で再起動が必要になるというメモが記録されます。 配布ステータスには、このパッケージについて「成功 (再起動が必要です)」も表示されます。
リターン コード テンプレートを作成または編集するには
- [新規作成] と、必要なテンプレート タイプを選択するか、既存のテンプレートを選択します。 事前構成されたシステム テンプレートは読み取り専用です。
- [テンプレート名] と [説明] を入力します。
- このテンプレートを、選択したテンプレート タイプ (EXE や PowerShell など) の既定にしたい場合は、[これを既定のテンプレートにする] で、[True] を選択します。
- マップされていないリターン コードの [既定の結果] を選択します。 既定は [失敗]です。 選択した結果は、アクションから返される、リターン コード リストに記載されていないすべてのリターン コードに対して発生する結果です。 たとえば、 [失敗] (推奨) を選択した場合、リストにないリターン コードはどれも、アクションが失敗として返される原因となります。 [成功] を選択すると、他のすべてのリターン コードが成功として返されます。
- 選択した既定のマップされていないリターン コード結果に対して表示される [既定のメッセージ] テキストを指定します。
- [+ リターン コードを追加] を選択します。
- [リターン コード] の数値または数値範囲を整数形式 (小数点以下なし) で入力し、[結果] ([失敗] または [成功]) と、リターン コードとともにログに記録する [メッセージ] テキストを入力します。 数値範囲を入力するには、15..30のように数値を2つのピリオドで区切ります。
- [保存] をクリックします。
- 必要なリターン コードごとに手順7と8を繰り返します。
- 完了後、[新規マッピングを追加] パネルを閉じて、[保存] を選択します。
