评估平台命令行语法

通过使用 AXE.exe,可以从命令行使用评估平台。AXE.exe 是一种命令行工具,可用来通过脚本自动执行作业并最大程度地减少资源使用。 此外,对于通过 Windows Assessment Console 不可用的参数,命令行选项还提供对它们的访问权限。

AXE.exe 具有局限性:不能用来运行预配置作业或 Windows 评估工具包提供的单项评估之一。 此外,也不能使用 AXE.exe 来创建或修改作业;若要创建或修改作业,必须使用 Windows Assessment Console。

AXE.exe 使用 Windows 评估工具包安装,默认安装在以下文件夹中:

%ProgramFiles(x86)%\Windows Kits\10\Assessment and Deployment Kit\Windows Assessment Toolkit<em>architecture</p>

其中,体系结构是下列值之一:amd64、arm、arm64x86

命令行选项

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 指定作业在退出显示错误之前等待另一个作业完成的时间量(以秒为单位)。 当秒数为零(默认值)时,如果另一个作业已在运行,则该作业将立即退出,不再运行。

示例:
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 /PublishPath
C:\\Assessments\\myResults
/DisplayLogETL_file 显示 ETL_file 指定的事件跟踪日志 (ETL) 文件的内容,其中可能包含路径和文件名中的通配符。 运行作业时,AXE.exe 将写入 ETL 文件,并在控制台窗口中显示路径。

日志文件的默认位置为 %LOCALAPPDATA%\Microsoft\Axe\Logs\GUID\,其中 GUID 是为每个新作业随机生成的 GUID。 SessionLogFiles 节点中的作业结果文件也包含完整位置。 此节点指定了所有日志文件。

注意:所有 ETL 文件都将自动转换为单个 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 是可选的。

/PublishPath 选项的优先级高于使用此选项设置 ResultsPublishPath 作业参数。

示例:
axe C:\\Assessments\\myJobs\\Job1\.jobx /JobParameter iterations=1

Windows Assessment Console 概述