Freigeben über


Befehlszeilensyntax für die Bewertungsplattform

Sie können die Bewertungsplattform mithilfe des Befehlszeilenprogramms AXE.exe verwenden, mit dem Sie Aufträge per Skript automatisieren und den Ressourcenverbrauch minimieren können. Darüber hinaus bieten Befehlszeilenoptionen Zugriff auf Parameter, die nicht über die Windows-Bewertungskonsole verfügbar sind.

AXE.exe hat Einschränkungen: Sie können es nicht verwenden, um einen vorkonfigurierten Auftrag oder eine der einzelnen Bewertungen auszuführen, die vom Windows-Bewertungstoolkit bereitgestellt werden. Sie können auch keinen Auftrag mithilfe von AXE.exe erstellen oder ändern; zum Erstellen oder Ändern eines Auftrags müssen Sie die Windows-Bewertungskonsole verwenden.

AXE.exe wird mit dem Windows-Bewertungstoolkit installiert, standardmäßig im folgenden Ordner:

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

dabei ist architektur einer der folgenden Werte: amd64, arm, arm64, x86.

Befehlszeilenoptionen

AXE.exe verwendet die folgende Syntax:

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]

Diese Optionen werden in der folgenden Tabelle beschrieben. Bei diesen Optionen wird keine Groß-/Kleinschreibung berücksichtigt.

Option Beschreibung
Help oder /? Zeigt Informationen zu den verfügbaren AXE.exe Befehlszeilenoptionen an.
job_file Gibt die Jobdatei (.jobx) an, die Sie ausführen möchten und kann einen relativen Pfad angeben. Wenn sich die Auftragsdatei im Verzeichnis befindet, aus dem Sie AXE.exe ausführen, ist kein Pfad erforderlich.

Wenn Sie einen Auftrag in der Windows-Bewertungskonsole erstellen, wird er standardmäßig in %BENUTZERPROFIL%\Dokumente\Windows Assessment Console\Jobs\ gespeichert.

Hinweis: Diese Option ist erforderlich, wenn kein anderer Parameter angegeben wird, der eine Aktion ausführt.

Beispiel:
axe C:\\Assessments\\MyJobs\\Job1\.jobx
/Job job_file Gibt den Pfad und Dateinamen der Auftragsdatei „job_file“ an, um die innerhalb der Ergebnisdatei erneut zu analysierenden Bewertungen zu finden.
/Analyze results_file Analysiert die Ergebnisse aus einer Auftragsdatei (.jobx), die durch results_file spezifiziert wird, erneut. Diese Option erfordert einen Auftrag direkt aus einem Paket- oder Bewertungsmanifest, um die Bewertungen zu finden, die erneut analysiert werden sollen.
/Assessment assessment_file Gibt den Pfad und Dateinamen eines Bewertungsmanifests „assessment_file“ an, um die angegebene Ergebnisdatei neu zu analysieren.
/Timeoutseconds Gibt die Zeit in Sekunden an, die der Auftrag auf den Abschluss eines anderen Auftrags wartet, bevor er mit einem Fehler beendet wird. Wenn seconds „0“ (die Ziffer Null) ist, wird der Auftrag sofort ohne Ausführung beendet, wenn bereits ein anderer Auftrag ausgeführt wird.

Beispiel:
axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30
/NoPublish Gibt an, dass die Ergebnisdatei nicht an dem Speicherort veröffentlicht wird, der in der Auftragsdatei angegeben ist. Wenn Sie diese Option verwenden, werden die Ergebnisse am Standardspeicherort %LOCALAPPDATA%\Microsoft\Axe\Results\ gespeichert.

Beispiel:
axe C:\\Assessments\\myJobs\\Job1\.jobx /NoPublish
/PublishToSource Gibt an, dass AXE.exe den ursprünglichen Ergebnisordner beim Ausführen von /Analyze aktualisiert. Die Verwendung von /PublishToSource ist optional und wird beim Ausführen eines Auftrags ignoriert.

/PublishToSource kann mit dem Veröffentlichungspfad kombiniert werden, der Veröffentlichungspfad wird jedoch nur verwendet, wenn AXE.exe den ursprünglichen Ergebnisordner nicht veröffentlichen kann.
/PublishPathfolder_path Gibt einen Speicherort an, in dem die Ergebnisdatei veröffentlicht werden soll. Der durch folder_path angegebene Pfad ersetzt den Veröffentlichungspfad ResultsPublishPath, der in der Auftragsdatei angegeben ist. Diese Option wird ignoriert, wenn sie mit /NoPublish kombiniert wird.

Beispiel:
axe C:\\Assessments\\myJobs\\Job1\.jobx /PublishPath
C:\\Assessments\\myResults
/DisplayLogETL_file Zeigt den Inhalt einer in ETL_file angegebenen Ereignisablaufverfolgungsprotokolldatei (ETL) an, die Wildcardzeichen im Pfad und Dateinamen enthalten kann. AXE.exe schreibt beim Ausführen eines Auftrags eine ETL-Datei und zeigt den Pfad im Konsolenfenster an.

Der Standardspeicherort der Protokolldatei ist %LOCALAPPDATA%\Microsoft\Axe\Logs\GUID\, wobei „GUID“ eine GUID ist, die zufällig für jeden neuen Auftrag generiert wird. Die Auftragsergebnisdatei im Knoten SessionLogFiles enthält auch den vollständigen Speicherort. Dieser Knoten gibt alle Protokolldateien an.

Hinweis: Alle ETL-Dateien werden automatisch in eine einzelne AxeLog.txt-Datei konvertiert, die im Ergebnisverzeichnis gespeichert wird. Sie können diese Datei mit dem Editor öffnen.

Beispiel:
axe /DisplayLog %LOCALAPPDATA%\\Microsoft\\Axe\\Logs\\E5A6CB43\-C1CE\-4FC1\-8170\-13B002E250B36\\AxeLog\-000\.etl
/RemoveRestart Gibt an, dass ausstehende Auftragsneustart-Aufgaben entfernt werden sollen (falls vorhanden).

Hinweis: Die Option "/JobFile " ist nicht erforderlich, wenn Sie diese Option verwenden.

Wenn Sie einen Auftrag ausführen, erstellt die Bewertung eine Aufgabe, um den Auftrag neu zu starten, wenn ein Systemausfall auftritt, z. B. durch einen Stromausfall. Wenn Sie diese Option verwenden, wird der Vorgang aus dem Vorgangsplaner entfernt. Wenn keine Auftragsneustart-Aufgabe aussteht, gibt die Bewertung einen Fehler zurück, um Sie darüber zu informieren, dass keine entsprechende Aufgabe vorhanden ist.

Beispiel:
axe /RemoveRestart
/NoWarnings Unterdrückt Warnmeldungen. Dies ist ein optionaler Parameter.

Beispiel:
axe C:\\Assessments\\myJobs\\Job1\.jobx /NoWarnings
/Pause Hält AXE.exe nach Abschluss des Auftrags an. Sie können dann Fehler oder andere Informationen in der Konsole sehen, bevor AXE.exe beendet wird und die Konsole geschlossen wird. Das Beenden wird fortgesetzt, wenn Sie eine Taste drücken.

Beispiel:
axe C:\\Assessments\\myJobs\\Job1\.jobx /Pause
/JobParameter parameter=value value gibt einen Wert an, der einen parameter eines Auftrags außer Kraft setzt, der im Auftragsmanifest vorhanden sein kann. Sie können /JobParameter bis zu 100 Mal verwenden, um mehrere Auftragsparameter anzugeben. Wenn doppelte Parameternamen angezeigt werden, verwendet die Bewertung den letzten für diesen Namen angegebenen Wert. Die Verwendung von /JobParameter ist optional.

Die Option /PublishPath hat Vorrang vor dem Festlegen des ResultsPublishPath-Auftragsparameters mit dieser Option.

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

Übersicht über die Windows-Bewertungskonsole