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 /PublishPathC:\\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 |