Assessment Platform のコマンドライン構文
評価プラットフォームは、スクリプトからジョブを自動化し、リソースの使用を最小限に抑えることができるコマンドライン ツール AXE.exe を使用して、コマンドラインから利用できます。 また、コマンドライン オプションを使用すると、Windows Assessment Console では使用できないパラメーターにアクセスできます。
AXE.exe には制限があります。事前に構成されたジョブの実行に使用したり、Windows Assessment Toolkit で提供される 1 つの評価を実行することはできません。 また、AXE.exe を使用してジョブを作成または変更することもできません。ジョブを作成または変更するには、Windows Assessment Console を使用する必要があります。
AXE.exe は、Windows Assessment Toolkit と共にインストールされ、既定では以下のフォルダーにインストールされます:
%ProgramFiles(x86)%\Windows Kits\10\Assessment and Deployment Kit\Windows Assessment Toolkit<em>architecture</p>
ここで、architecture は、amd64、arm、arm64、x86 のいずれかです。
コマンド ライン オプション
AXE.exe は、次の構文を使用します:
axe job_file /Timeout seconds] [/NoPublish] [/PublishPath folder_path] [/RemoveRestart] [/DisplayLog ETL_file] [/NoWarnings] [/JobParameter parameter=value] [/Pause]
axe /Analyze results_file [/Job job_file] [/Assessment assessment_file]
次の表では、これらのオプションについて説明します。 これらのオプションの名前は大文字と小文字が区別されません。
| オプション | 説明 |
|---|---|
| Help または /? | 使用可能な AXE.exe のコマンドラインオプションに関する情報を表示します。 |
| job_file | 実行するジョブ (.jobx) ファイルを指定します。job_file には相対パスを指定できます。 ジョブ ファイルが AXE.exe を実行しているディレクトリにある場合、パスは必要ありません。 Windows Assessment Console でジョブを作成すると、そのジョブは既定で %USERPROFILE%\Documents\Windows Assessment Console\Jobs\ に保存されます。 注: このオプションは、アクションを実行する他のパラメーターが指定されていない場合に必要です。 例: axe C:\\Assessments\\MyJobs\\Job1\.jobx |
| /Job job_file | 結果ファイル内の再分析に評価を検索するときに使用する、ジョブ ファイル (job_file) のパスとファイル名を指定します。 |
| /Analyze results_file | Results_file によって指定されたジョブ (.jobx) ファイルの結果を再分析します。 このオプションでは、再分析する評価を見つけるために、パッケージまたは評価マニフェストから直接ジョブを実行する必要があります。 |
| /Assessment assessment_file | 指定された結果ファイルで再分析するために、評価マニフェスト (assessment_file) のパスとファイル名を指定します。 |
| /Timeoutseconds | 別のジョブ完了の待機時間を秒単位で指定します。この時間が経過すると、エラーで終了します。 待機時間を 0 に設定すると、別のジョブが既に実行されている場合、既定でジョブは実行されずにすぐに終了します。 例: axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30 |
| /NoPublish | ジョブ ファイルで指定された場所に結果ファイルを発行しないように指定します。 このオプションを使用すると、結果は既定で %LOCALAPPDATA%\Microsoft\Axe\Results\ に保存されます。 例: axe C:\\Assessments\\myJobs\\Job1\.jobx /NoPublish |
| /PublishToSource | /Analyze の実行時に、AXE.exe が元の結果フォルダーを更新するよう指定します。 /PublishToSource の使用はオプションであり、ジョブの実行時には無視されます。 /PublishToSource は発行パスと組み合わせることができますが、発行パスは、AXE.exe の元の結果フォルダーに発行できない場合にのみ使用されます。 |
| /PublishPathfolder_path | 結果ファイルを発行する場所を指定します。 folder_path で指定されたパスは、ジョブ ファイルで指定されている公開パス ResultsPublishPath よりも優先されます。 このオプションは、/NoPublish と組み合わせた場合には無視されます。 例: axe C:\\Assessments\\myJobs\\Job1\.jobx /PublishPathC:\\Assessments\\myResults |
| /DisplayLogETL_file | ETL_file によって指定されたイベント トレース ログ (ETL) ファイルの内容を表示します。このファイルには、パスとファイル名にワイルドカード文字を含めることができます。 AXE.exe は、ジョブの実行時に ETL ファイルを書き込み、コンソール ウィンドウにそのパスを表示します。 ログファイルの既定の場所は %LOCALAPPDATA%\Microsoft\Axe\Logs\GUID\ です。GUID は、新しいジョブごとにランダムに生成される GUID です。 SessionLogFiles ノードのジョブ結果ファイルにも完全な場所が含まれています。 このノードは、すべてのログ ファイルを指定します。 注: すべての ETL ファイルは、結果ディレクトリに保存される 1 つの AxeLog.txt ファイルに自動的に変換されます。 このファイルはメモ帳を使用して開くことができます。 例: axe /DisplayLog %LOCALAPPDATA%\\Microsoft\\Axe\\Logs\\E5A6CB43\-C1CE\-4FC1\-8170\-13B002E250B36\\AxeLog\-000\.etl |
| /RemoveRestart | 既存の保留中のジョブ再起動タスクをすべて削除するように指定します。 注: このオプションを使用する場合、/JobFile オプションは必要ありません。 ジョブを実行すると、停電などのシステム障害が発生した場合にジョブを再開するタスクが評価によって作成されます。 このオプションを使用すると、タスクはタスク スケジューラから削除されます。 ジョブ再開タスクが保留されていない場合、評価はタスクが存在しないことを通知するエラーを返します。 例: axe /RemoveRestart |
| /NoWarnings | 警告メッセージを表示しません。 これは省略可能なパラメーターです。 例: axe C:\\Assessments\\myJobs\\Job1\.jobx /NoWarnings |
| /Pause | ジョブの完了後に AXE.exe を一時停止します。 AXE.exe が終了し、コンソールが閉じる前に、コンソールにエラーやその他の情報が表示されます。 キーを押すと、終了が続行されます。 例: axe C:\\Assessments\\myJobs\\Job1\.jobx /Pause |
| /JobParameter parameter=value | ジョブ マニフェストに存在する可能性のあるジョブ パラメーターをオーバーライドする値を指定します。 /JobParameter を 100 回まで使用して、複数のジョブ パラメーターを指定できます。 重複するパラメーター名が表示される場合、評価では、その名前に指定された最後の値が使用されます。 /JobParameter はオプションです。 このオプションで ResultsPublishPath のジョブ パラメーターを設定するよりも、/PublishPath オプションが優先されます。 例: axe C:\\Assessments\\myJobs\\Job1\.jobx /JobParameter iterations=1 |