Share via


Sintaxis de línea de comandos de la plataforma de evaluación

La plataforma de evaluación está disponible para su uso desde la línea de comandos mediante AXE.exe, una herramienta de línea de comandos que puede usar para automatizar trabajos desde un script y minimizar el uso de recursos. Además, las opciones de línea de comandos proporcionan acceso a los parámetros que no están disponibles a través de la Consola de evaluación de Windows.

AXE.exe tiene limitaciones: no se puede usar para ejecutar un trabajo preconfigurado o una de las evaluaciones únicas proporcionadas por el Kit de herramientas de evaluación de Windows. Tampoco puede crear o modificar un trabajo mediante AXE.exe; para crear o modificar un trabajo, debe usar la Consola de evaluación de Windows.

AXE.exe se instala con windows Assessment Toolkit y, de forma predeterminada, se instala en la carpeta siguiente:

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

donde la arquitectura es una de las siguientes: amd64, arm, arm64, x86.

Opciones de línea de comandos

AXE.exe usa la sintaxis siguiente:

Hacha job_file/Timeout seconds] [/NoPublish] [/PublishPath folder_path] [/RemoveRestart] [/DisplayLog ETL_file] [/NoWarnings] [/JobParameterparameter=value] [/Pause]

Hacha /Analyzeresults_file [/Jobjob_file] [/Assessmentassessment_file]

Se describen en la siguiente tabla. Los nombres de estas opciones no distinguen mayúsculas de minúsculas.

Opción Descripción
Ayuda o /? Muestra información sobre las opciones de línea de comandos de AXE.exe disponibles.
job_file Especifica el archivo de trabajo (.jobx) que desea ejecutar y job_file puede especificar una ruta de acceso relativa. Si el archivo de trabajo está en el directorio desde el que se ejecuta AXE.exe, no se requiere ninguna ruta de acceso.

De forma predeterminada, al crear un trabajo en la Consola de evaluación de Windows, se guarda en %USERPROFILE%\Documents\Windows Assessment Console\Jobs\.

Nota: Esta opción es necesaria si no se especifica ningún otro parámetro que realice una acción.

Ejemplo:
axe C:\\Assessments\\MyJobs\\Job1\.jobx
/Jobjob_file Especifica la ruta de acceso y el nombre de archivo del archivo de trabajo, job_file, que se van a usar para buscar las evaluaciones que se van a volver a analizar en el archivo de resultados.
/Analyzeresults_file Vuelve a analizar los resultados de un archivo de trabajo (.jobx) especificado por results_file. Esta opción requiere un trabajo de un paquete o manifiesto de evaluación directamente para buscar las evaluaciones que se van a volver a analizar.
/Assessmentassessment_file Especifica la ruta de acceso y el nombre de archivo de un manifiesto de evaluación, assessment_file, que se va a volver a analizar en el archivo de resultados especificado.
/Timeoutseconds Especifica la cantidad de tiempo en segundos que el trabajo esperará a que finalice otro trabajo antes de que se cierre con un error. Cuando segundos es cero, el valor predeterminado, el trabajo se cerrará inmediatamente sin ejecutarse si ya se está ejecutando otro trabajo.

Ejemplo:
axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30
/NoPublish Especifica que no se publique el archivo de resultados en la ubicación especificada en el archivo de trabajo. Cuando se usa esta opción, los resultados se guardan en la ubicación predeterminada, %LOCALAPPDATA%\Microsoft\Axe\Results\.

Ejemplo:
axe C:\\Assessments\\myJobs\\Job1\.jobx /NoPublish
/PublishToSource Especifica que AXE.exe actualice la carpeta de resultados original al ejecutar /Analyze. El uso de /PublishToSource es opcional y se omite al ejecutar un trabajo.

/PublishToSource se puede combinar con la ruta de acceso de publicación, pero la ruta de acceso de publicación solo se usará si AXE.exe no se puede publicar en la carpeta de resultados original.
/PublishPathfolder_path Especifica una ubicación en la que se va a publicar el archivo de resultados. La ruta de acceso especificada por folder_path invalida la ruta de acceso de publicación, ResultsPublishPath, que se especifica en el archivo de trabajo. Esta opción se omite si se combina con /NoPublish.

Ejemplo:
axe C:\\Assessments\\myJobs\\Job1\.jobx /PublishPath
C:\\Assessments\\myResults
/DisplayLogETL_file Muestra el contenido de un archivo de registro de seguimiento de eventos (ETL) especificado por ETL_file, que puede contener caracteres comodín en la ruta de acceso y el nombre de archivo. AXE.exe escribe un archivo ETL al ejecutar un trabajo y muestra la ruta de acceso en la ventana de la consola.

La ubicación predeterminada del archivo de registro es %LOCALAPPDATA%\Microsoft\Axe\Logs\GUID\, donde GUID es un GUID que se genera aleatoriamente para cada trabajo nuevo. El archivo de resultados del trabajo en el nodo SessionLogFiles también contiene la ubicación completa. Este nodo especifica todos los archivos de registro.

Nota: Todos los archivos ETL se convierten automáticamente en un único archivo AxeLog.txt que se guarda en el directorio de resultados. Puede abrir este archivo mediante el Bloc de notas.

Ejemplo:
axe /DisplayLog %LOCALAPPDATA%\\Microsoft\\Axe\\Logs\\E5A6CB43\-C1CE\-4FC1\-8170\-13B002E250B36\\AxeLog\-000\.etl
/RemoveRestart Especifica que se debe quitar cualquier tarea existente pendiente de reinicio del trabajo.

Nota: La opción /JobFile no es necesaria cuando se usa esta opción.

Al ejecutar un trabajo, la evaluación crea una tarea para reiniciar el trabajo si se produce un error del sistema, como una pérdida de energía. Cuando se usa esta opción, la tarea se quita del Programador de tareas. Si no hay ninguna tarea de reinicio de trabajo pendiente, la evaluación devolverá un error para informarle de que la tarea no existe.

Ejemplo:
axe /RemoveRestart
/NoWarnings Suprime los mensajes de advertencia. Se trata de un parámetro opcional.

Ejemplo:
axe C:\\Assessments\\myJobs\\Job1\.jobx /NoWarnings
/Pausa Pausa AXE.exe una vez finalizado el trabajo. A continuación, puede ver los errores u otra información en la consola antes de que se cierre AXE.exe y se cierre la consola. La salida continúa al presionar una tecla.

Ejemplo:
axe C:\\Assessments\\myJobs\\Job1\.jobx /Pause
/JobParameterparameter=value Especifica un valor para invalidar un parámetro de trabajo que puede existir en el manifiesto del trabajo. Puede usar /JobParameter hasta 100 veces para especificar varios parámetros de trabajo. Si aparecen nombres de parámetro duplicados, la evaluación usa el último valor proporcionado para ese nombre. El uso de /JobParameter es opcional.

La opción /PublishPath tiene prioridad sobre cómo establecer el parámetro de trabajo ResultsPublishPath con esta opción.

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

Información general de la consola de evaluación de Windows