Sintaxe de linha de comando da plataforma de avaliação

A Plataforma de Avaliação está disponível para uso na linha de comando usando AXE.exe, uma ferramenta de linha de comando que você pode usar para automatizar trabalhos a partir de um script e minimizar o uso de recursos. Além disso, as opções de linha de comando fornecem acesso a parâmetros que não estão disponíveis por meio do Console de Avaliação do Windows.

O AXE.exe tem limitações: você não pode usá-lo para executar um trabalho pré-configurado ou uma das únicas avaliações fornecidas pelo Kit de Ferramentas de Avaliação do Windows. Você também não pode criar nem modificar um trabalho usando AXE.exe; para criar ou modificar um trabalho, você deve usar o Console de Avaliação do Windows.

O AXE.exe é instalado com o Kit de Ferramentas de Avaliação do Windows e, por padrão, é instalado na seguinte pasta:

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

sendo que architecture é uma das seguintes: amd64, arm, arm64, x86.

Opções de linha de comando

O AXE.exe usa a seguinte sintaxe:

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]

Essas opções estão descritas na tabela a seguir. Os nomes dessas opções não fazem distinção entre letras maiúsculas e minúsculas.

Opção	Descrição
Help ou /?	Exibe informações sobre as opções de linha de comando disponíveis do AXE.exe.
job_file	Especifica o arquivo de trabalho (.jobx) que você deseja executar e job_file pode especificar um caminho relativo. Se o arquivo de trabalho estiver no diretório do qual você está executando AXE.exe, nenhum caminho será necessário. Por padrão, quando você cria um trabalho no Console de Avaliação do Windows, ele é salvo em %USERPROFILE%\Documents\Windows Assessment Console\Jobs\. Observação: esta opção é necessária se nenhum outro parâmetro que executa uma ação for especificado. Exemplo: axe C:\\Assessments\\MyJobs\\Job1\.jobx
/Job job_file	Especifica o caminho e o nome do arquivo de trabalho, job_file, a serem usados na localização das avaliações a serem reanalisadas no arquivo de resultados.
/Analyze results_file	Reanalisa os resultados de um arquivo de trabalho (.jobx) especificado por results_file. Essa opção requer um trabalho de um pacote ou manifesto de avaliação diretamente para localizar as avaliações a serem reanalisadas.
/Assessment assessment_file	Especifica o caminho e o nome de arquivo de um manifesto de avaliação, assessment_file, a ser reanalisado no arquivo de resultados especificado.
/Timeoutseconds	Especifica a quantidade de tempo, em segundos, que o trabalho aguardará a conclusão de outro trabalho antes de ser encerrado com um erro. Quando segundos for igual a zero, o padrão, o trabalho será encerrado imediatamente sem execução se outro trabalho já estiver em execução. Exemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30
/NoPublish	Especifica para não publicar o arquivo de resultados no local especificado no arquivo de trabalho. Quando você usa essa opção, os resultados são salvos no local padrão, %LOCALAPPDATA%\Microsoft\Axe\Results\. Exemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /NoPublish
/PublishToSource	Especifica que o AXE.exe atualizará a pasta de resultados original ao executar /Analyze. O uso de /PublishToSource é opcional e é ignorado ao executar um trabalho. /PublishToSource pode ser combinado com o caminho de publicação, mas o caminho de publicação só será usado se o AXE.exe não puder publicar na pasta de resultados original.
/PublishPathfolder_path	Especifica um local para publicar o arquivo de resultados. O caminho especificado por folder_path substitui o caminho de publicação, ResultsPublishPath, especificado no arquivo de trabalho. Essa opção será ignorada se for combinada com /NoPublish. Exemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /PublishPath C:\\Assessments\\myResults
/DisplayLogETL_file	Exibe o conteúdo de um arquivo ETL (Log de Rastreamento de Eventos) especificado por ETL_file, que pode conter caracteres curinga no caminho e no nome do arquivo. O AXE.exe grava um arquivo ETL ao executar um trabalho e exibe o caminho na janela do console. O local padrão do arquivo de log é %LOCALAPPDATA%\Microsoft\Axe\Logs\GUID\, sendo que GUID é um GUID gerado aleatoriamente para cada novo trabalho. O arquivo de resultados do trabalho no nó SessionLogFiles também contém o local completo. Esse nó especifica todos os arquivos de log. Observação: Todos os arquivos ETL são convertidos automaticamente em um único arquivo AxeLog.txt que é salvo no diretório de resultados. Abra esse arquivo usando o Bloco de notas. Exemplo: axe /DisplayLog %LOCALAPPDATA%\\Microsoft\\Axe\\Logs\\E5A6CB43\-C1CE\-4FC1\-8170\-13B002E250B36\\AxeLog\-000\.etl
/RemoveRestart	Especifica que qualquer tarefa de reinicialização de trabalho pendente existente deve ser removida. Observação: a opção /JobFile não é necessária quando você usa essa opção. Quando você executa um trabalho, a avaliação cria uma tarefa para reiniciar o trabalho se houver uma falha do sistema, como uma perda de energia. Quando você usa essa opção, a tarefa é removida do Agendador de tarefas. Se nenhuma tarefa de reinicialização do trabalho estiver pendente, a avaliação retornará um erro para informá-lo de que a tarefa não existe. Exemplo: axe /RemoveRestart
/NoWarnings	Suprime mensagens de aviso. Esse é um parâmetro opcional. Exemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /NoWarnings
/Pause	Pausa o AXE.exe após a conclusão do trabalho. Em seguida, você pode ver quaisquer erros ou outras informações no console antes que o AXE.exe saia e o console seja fechado. Sair terá continuidade se você pressionar uma tecla. Exemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /Pause
/JobParameter parameter=value	Especifica um valor para substituir um parâmetro de trabalho que pode existir no manifesto do trabalho. Você pode usar /JobParameter até 100 vezes para especificar vários parâmetros de trabalho. Se aparecerem nomes de parâmetros duplicados, a avaliação usará o último valor fornecido para esse nome. O uso de /JobParameter é opcional. A opção /PublishPath tem precedência sobre a definição do parâmetro de trabalho ResultsPublishPath com essa opção. Exemplo: axe C:\\Assessments\\myJobs\\Job1\.jobx /JobParameter iterations=1

Tópicos relacionados

Visão geral do Console de Avaliação do Windows