Sintaxis de la 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 a través de AXE.exe, una herramienta de línea de comandos que se 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 ni modificar un trabajo con AXE.exe. Para crear o modificar un trabajo, debe usar la Consola de evaluación de Windows.
AXE.exe se instala con el kit de herramientas de evaluación de Windows 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 architecture es una de las siguientes: amd64, arm, arm64, x86.
Opciones de línea de comandos
AXE.exe usa la siguiente sintaxis:
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]
Se describen en la siguiente tabla. Los nombres de estas opciones no distinguen entre mayúsculas y minúsculas.
Opción | Descripción |
---|---|
Help o /? | Muestra información sobre las opciones de línea de comandos disponibles de AXE.exe. |
job_file | Especifica el archivo de trabajo (.jobx) que se 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 |
/Job job_file | Especifica la ruta de acceso y el nombre de archivo del archivo de trabajo, job_file, que se va a usar para buscar las evaluaciones que volverán a analizar dentro del archivo de resultados. |
/Analyze results_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. |
/Assessment assessment_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 salir con un error. Cuando seconds es cero, el valor predeterminado, el trabajo se cierra inmediatamente sin ejecutarse si ya se está ejecutando otro trabajo. Ejemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30 |
/NoPublish | Especifica que el archivo de resultados no se debe publicar 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 debe actualizar 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 esta solo se usará si AXE.exe no se puede publicar en la carpeta de resultados original. |
/PublishPathfolder_path | Especifica la 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 nuevo trabajo. 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 un problema de alimentación. Al usar 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 |
/Pause | 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 cierren AXE.exe y la consola. La salida continúa cuando se pulsa una tecla. Ejemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /Pause |
/JobParameter parameter=value | Especifica un ajuste value para invalidar el valor de parameter que puede existir en el manifiesto de 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 la configuración del parámetro de trabajo ResultsPublishPath con esta opción. Ejemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /JobParameter iterations=1 |