Поделиться через


Синтаксис командной строки платформы оценки

Платформа оценки доступна для использования из командной строки с помощью AXE.exe, средства командной строки, которое можно использовать для автоматизации заданий из скрипта и минимизации использования ресурсов. Кроме того, параметры командной строки предоставляют доступ к параметрам, которые недоступны через консоль оценки Windows.

AXE.exe имеет ограничения. Его нельзя использовать для выполнения предварительно настроенного задания или одной из отдельных оценок, предоставляемых набором средств оценки Windows. Вы также не можете создать или изменить задание с помощью AXE.exe; для создания или изменения задания необходимо использовать консоль оценки Windows.

AXE.exe устанавливается с набором средств оценки Windows и по умолчанию устанавливается в следующую папку:

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

где архитектура является одной из следующих: amd64, arm, arm64, x86.

Параметры командной строки

AXE.exe использует следующий синтаксис:

axe job_file /Timeout секунд] [/NoPublish] [/PublishPath folder_path] [/RemoveRestart] [/DisplayLog ETL_file] [/NoWarnings] [/JobParameter parameter=value] [/Pause] 

axe /Analyze results_file [/Job job_file] [/Assessment assessment_file]

Эти параметры описаны в следующей таблице. Имена этих параметров не учитывает регистр.

Вариант Описание
Справка или /? Отображает сведения о доступных параметрах командной строки AXE.exe.
job_file Указывает файл задания (.jobx), который требуется запустить, и job_file может указать относительный путь. Если файл задания находится в каталоге, из которого выполняется AXE.exe, путь не требуется.

По умолчанию при создании задания в консоли оценки Windows он сохраняется в папке %USERPROFILE%\Documents\Windows Assessment Console\Jobs\.

Примечание. Этот параметр требуется, если ни один другой параметр, выполняющий действие, не указан.

Пример:
axe C:\\Assessments\\MyJobs\\Job1\.jobx
/Job job_file Указывает путь и имя файла задания, job_file, чтобы использовать при поиске оценок для повторного анализа в файле результатов.
/Анализ results_file Перенализует результаты из файла задания (JOBX), указанного results_file. Для этого параметра требуется задание из манифеста пакета или оценки непосредственно для поиска оценок для повторного анализа.
/Assessment assessment_file Указывает путь и имя файла манифеста оценки assessment_file для повторного анализа в указанном файле результатов.
/Timeoutв секундах Указывает время в секундах, которое задание ожидает завершения другого задания, прежде чем оно завершится с ошибкой. Если секунды равны нулю, задание по умолчанию завершится немедленно, не выполняясь, если другое задание уже запущено.

Пример:
axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30
/NoPublish Указывает, что файл результатов не публикуется в расположении, указанном в файле задания. При использовании этого параметра результаты сохраняются в расположении по умолчанию %LOCALAPPDATA%\Microsoft\Axe\Results\.

Пример:
axe C:\\Assessments\\myJobs\\Job1\.jobx /NoPublish
/PublishToSource Указывает, что AXE.exe обновить исходную папку результатов при запуске /Analyze. Использование /PublishToSource является необязательным и игнорируется при выполнении задания.

/PublishToSource может сочетаться с путем публикации, но путь публикации будет использоваться только в том случае, если AXE.exe не удается опубликовать в исходной папке результатов.
/PublishPathfolder_path Указывает расположение для публикации файла результатов в. Путь, указанный folder_path переопределяет путь публикации, РезультатыPublishPath, указанный в файле задания. Этот параметр игнорируется, если он сочетается с /NoPublish.

Пример:
axe C:\\Assessments\\myJobs\\Job1\.jobx /PublishPath
C:\\Assessments\\myResults
/DisplayLogETL_file Отображает содержимое файла журнала трассировки событий (ETL), указанного ETL_file, который может содержать подстановочные знаки в имени пути и файла. 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
/Пауза Приостанавливает 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