Sintassi della riga di comando della piattaforma di valutazione
La piattaforma di valutazione è disponibile per l'uso dalla riga di comando usando AXE.exe, uno strumento da riga di comando che è possibile usare per automatizzare i processi da uno script e ridurre al minimo l'utilizzo delle risorse. Inoltre, le opzioni della riga di comando forniscono l'accesso ai parametri non disponibili tramite Windows Assessment Console.
AXE.exe presenta limitazioni: non è possibile usarlo per eseguire un processo preconfigurato o una delle singole valutazioni fornite da Windows Assessment Toolkit. Non è inoltre possibile creare o modificare un processo usando AXE.exe; per la creazione o la modifica di un processo, è necessario usare windows Assessment Console.
AXE.exe viene installato con Windows Assessment Toolkit e per impostazione predefinita viene installato nella cartella seguente:
%ProgramFiles(x86)%\Windows Kits\10\Assessment and Deployment Kit\Windows Assessment Toolkit<em>architecture</p>
dove architecture è uno dei seguenti: amd64, arm, arm64, x86.
Opzioni della riga di comando
AXE.exe usa la sintassi seguente:
axe job_file /Timeout seconds] [/NoPublish] [/PublishPath folder_path] [/RemoveRestart] [/DisplayLog ETL_file] [/NoWarnings] [/JobParameter parameter=value] [/Pause] [/Pause]
axe /Analyze results_file [/Job job_file] [/Assessment assessment_file]
Queste opzioni sono descritte nella tabella riportata di seguito. I nomi di queste opzioni non fanno distinzione tra maiuscole e minuscole.
| Opzione | Descrizione |
|---|---|
| Guida o /? | Visualizza informazioni sulle opzioni disponibili AXE.exe della riga di comando. |
| job_file | Specifica il file di processo (con estensione jobx) che si desidera eseguire e job_file può specificare un percorso relativo. Se il file di processo si trova nella directory da cui si esegue AXE.exe, non è necessario alcun percorso. Per impostazione predefinita, quando si crea un processo nella Console di valutazione di Windows, viene salvato in %USERPROFILE%\Documents\Windows Assessment Console\Jobs\. Nota: questa opzione è obbligatoria se non viene specificato alcun altro parametro che esegue un'azione. Esempio: axe C:\\Assessments\\MyJobs\\Job1\.jobx |
| /Job job_file | Specifica il percorso e il nome file del file di processo, job_file, da usare per individuare le valutazioni da rianazzare all'interno del file dei risultati. |
| /Analyze results_file | Rianalise i risultati da un file di processo (con estensione jobx) specificato da results_file. Questa opzione richiede un processo da un manifesto di pacchetto o valutazione direttamente per individuare le valutazioni da rianalisi. |
| /Assessment assessment_file | Specifica il percorso e il nome del file di un manifesto di valutazione, assessment_file, da rianalicare nel file dei risultati specificato. |
| /Timeoutseconds | Specifica la quantità di tempo in secondi in cui il processo attenderà il completamento di un altro processo prima di uscire con un errore. Quando secondi è zero, il valore predefinito, il processo verrà chiuso immediatamente senza eseguire se un altro processo è già in esecuzione. Esempio: axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30 |
| /NoPublish | Specifica di non pubblicare il file dei risultati nel percorso specificato nel file di processo. Quando si usa questa opzione, i risultati vengono salvati nel percorso predefinito, %LOCALAPPDATA%\Microsoft\Axe\Results\. Esempio: axe C:\\Assessments\\myJobs\\Job1\.jobx /NoPublish |
| /PublishToSource | Specifica che AXE.exe aggiornare la cartella dei risultati originale durante l'esecuzione di /Analyze. L'uso di /PublishToSource è facoltativo e viene ignorato durante l'esecuzione di un processo. /PublishToSource può essere combinato con il percorso di pubblicazione, ma il percorso di pubblicazione verrà usato solo se AXE.exe non può pubblicare nella cartella dei risultati originale. |
| /PublishPathfolder_path | Specifica un percorso in cui pubblicare il file dei risultati. Il percorso specificato da folder_path esegue l'override del percorso della pubblicazione, ResultsPublishPath, specificato nel file di processo. Questa opzione viene ignorata se viene combinata con /NoPublish. Esempio: axe C:\\Assessments\\myJobs\\Job1\.jobx /PublishPathC:\\Assessments\\myResults |
| /DisplayLogETL_file | Visualizza il contenuto di un file ETL (Event Trace Log) specificato da ETL_file, che può contenere caratteri jolly nel percorso e nel nome del file. AXE.exe scrive un file ETL durante l'esecuzione di un processo e visualizza il percorso nella finestra della console. Il percorso predefinito del file di log è %LOCALAPPDATA%\Microsoft\Axe\Logs\GUID\, dove GUID è un GUID generato in modo casuale per ogni nuovo processo. Il file dei risultati del processo nel nodo SessionLogFiles contiene anche il percorso completo. Questo nodo specifica tutti i file di log. Nota: tutti i file ETL vengono convertiti automaticamente in un singolo file AxeLog.txt salvato nella directory dei risultati. È possibile aprire il file con il Blocco note. Esempio: axe /DisplayLog %LOCALAPPDATA%\\Microsoft\\Axe\\Logs\\E5A6CB43\-C1CE\-4FC1\-8170\-13B002E250B36\\AxeLog\-000\.etl |
| /RemoveRestart | Specifica che qualsiasi attività di riavvio del processo in sospeso esistente deve essere rimossa. Nota: l'opzione /JobFile non è necessaria quando si usa questa opzione. Quando si esegue un processo, la valutazione crea un'attività per riavviare il processo in caso di errore di sistema, ad esempio una perdita di energia. Quando si usa questa opzione, l'attività viene rimossa dall'Utilità di pianificazione. Se non è in sospeso alcuna attività di riavvio del processo, la valutazione restituirà un errore per segnalare che l'attività non esiste. Esempio: axe /RemoveRestart |
| /NoWarnings | Elimina i messaggi di avviso. Questo è un parametro opzionale. Esempio: axe C:\\Assessments\\myJobs\\Job1\.jobx /NoWarnings |
| /Pausa | Sospende AXE.exe al termine del processo. È quindi possibile visualizzare eventuali errori o altre informazioni nella console prima che AXE.exe venga chiusa e la console venga chiusa. L'uscita continua quando si preme un tasto. Esempio: axe C:\\Assessments\\myJobs\\Job1\.jobx /Pause |
| /JobParameter parameter=value | Specifica un valore per eseguire l'override di un parametro di processo che può esistere nel manifesto del processo. È possibile usare /JobParameter fino a 100 volte per specificare più parametri di processo. Se vengono visualizzati nomi di parametri duplicati, la valutazione usa l'ultimo valore fornito per tale nome. L'uso di /JobParameter è facoltativo. L'opzione /PublishPath ha la precedenza sull'impostazione del parametro del processo ResultsPublishPath con questa opzione. Esempio: axe C:\\Assessments\\myJobs\\Job1\.jobx /JobParameter iterations=1 |