Syntaxe de ligne de commande de la plateforme d’évaluation
La plateforme d’évaluation est disponible pour une utilisation en ligne de commande en utilisant AXE.exe, un outil de ligne de commande que vous pouvez utiliser pour automatiser des tâches à partir d’un script et minimiser l’utilisation des ressources. De plus, les options de ligne de commande permettent d’accéder à des paramètres qui ne sont pas disponibles via Windows Assessment Console.
AXE.exe a des limitations : vous ne pouvez pas l’utiliser pour exécuter une tâche pré-configurée ou l’une des évaluations individuelles fournies par Windows Assessment Toolkit. Vous ne pouvez pas non plus créer ou modifier une tâche en utilisant AXE.exe ; pour créer ou modifier une tâche, vous devez utiliser Windows Assessment Console.
AXE.exe est installé avec Windows Assessment Toolkit et, par défaut, il est installé dans le dossier suivant :
%ProgramFiles(x86)%\Windows Kits\10\Assessment and Deployment Kit\Windows Assessment Toolkit<em>architecture</p>
où architecture est l’un des éléments suivants : amd64, arm, arm64, x86.
Options de ligne de commande
AXE.exe utilise la syntaxe suivante :
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]
Ces options sont décrites dans le tableau suivant : Les noms de ces options ne sont pas sensibles à la casse.
| Option | Description |
|---|---|
| Help ou /? | Affiche des informations sur les options de ligne de commande disponibles pour AXE.exe. |
| job_file | Spécifie le fichier de tâche (.jobx) que vous souhaitez exécuter, et job_file peut spécifier un chemin relatif. Si le fichier de tâche se trouve dans le répertoire à partir duquel vous exécutez AXE.exe, aucun chemin n’est requis. Par défaut, lorsque vous créez une tâche dans la Windows Assessment Console, elle est enregistrée dans %USERPROFILE%\Documents\Windows Assessment Console\Jobs\. Remarque : cette option est requise si aucun autre paramètre réalisant une action n’est spécifié. Exemple : axe C:\\Assessments\\MyJobs\\Job1\.jobx |
| /Job job_file | Spécifie le chemin et le nom de fichier du fichier de tâche, job_file, à utiliser pour localiser les évaluations à réanalyser dans le fichier de résultats. |
| /Analyze results_file | Réanalyse les résultats d’une tâche (fichier .jobx) spécifiée par results_file. Cette option nécessite une tâche d’un package ou d’un manifeste d’évaluation directement pour localiser les évaluations à réanalyser. |
| /Assessment assessment_file | Spécifie le chemin et le nom de fichier d’un manifeste d’évaluation, assessment_file, à réanalyser dans le fichier de résultats spécifié. |
| /Timeoutseconds | Spécifie en secondes le temps d’attente de la tâche pour qu’une autre tâche se termine avant de quitter avec une erreur. Lorsque seconds est égal à zéro, la valeur par défaut, la tâche quittera immédiatement sans s’exécuter si une autre tâche est déjà en cours d’exécution. Exemple : axe C:\\Assessments\\myJobs\\Job1\.jobx /Timeout 30 |
| /NoPublish | Spécifie de ne pas publier le fichier de résultats à l’emplacement spécifié dans le fichier de tâche. Lorsque vous utilisez cette option, les résultats sont enregistrés dans l’emplacement par défaut, %LOCALAPPDATA%\Microsoft\Axe\Results\. Exemple : axe C:\\Assessments\\myJobs\\Job1\.jobx /NoPublish |
| /PublishToSource | Spécifie qu’AXE.exe met à jour le dossier de résultats d’origine lors de l’exécution de /Analyze. L’utilisation de /PublishToSource est facultative et elle est ignorée lors de l’exécution d’une tâche. /PublishToSource peut être combiné avec le chemin de publication, mais le chemin de publication ne sera utilisé qu’AXE.exe ne peut pas publier dans le dossier de résultats d’origine. |
| /PublishPathfolder_path | Spécifie un emplacement pour publier le fichier de résultats. Le chemin spécifié par folder_path remplace le chemin de publication, ResultsPublishPath, spécifié dans le fichier de tâche. Cette option est ignorée si elle est combinée avec /NoPublish. Exemple : axe C:\\Assessments\\myJobs\\Job1\.jobx /PublishPathC:\\Assessments\\myResults |
| /DisplayLogETL_file | Affiche le contenu d’un fichier Event Trace Log (ETL) spécifié par ETL_file, qui peut contenir des caractères génériques dans le chemin et le nom de fichier. AXE.exe écrit un fichier ETL lors de l’exécution d’une tâche et affiche le chemin dans la fenêtre de la console. L’emplacement par défaut du fichier journal est %LOCALAPPDATA%\Microsoft\Axe\Logs\GUID\, où GUID est un GUID généré aléatoirement pour chaque nouvelle tâche. Le fichier de résultats de la tâche dans le nœud SessionLogFiles contient également l’emplacement complet. Ce nœud spécifie tous les fichiers journaux. Remarque : tous les fichiers ETL sont automatiquement convertis en un seul fichier AxeLog.txt qui est enregistré dans le répertoire de résultats. Vous pouvez ouvrir ce fichier à l’aide du Bloc-notes. Exemple : axe /DisplayLog %LOCALAPPDATA%\\Microsoft\\Axe\\Logs\\E5A6CB43\-C1CE\-4FC1\-8170\-13B002E250B36\\AxeLog\-000\.etl |
| /RemoveRestart | Spécifie que toute tâche de redémarrage de tâche en attente existante doit être supprimée. Remarque : l’option /JobFile n’est pas nécessaire lorsque vous utilisez cette option. Lorsque vous exécutez une tâche, l’évaluation crée une tâche pour redémarrer la tâche en cas de défaillance du système, comme une perte de puissance. Lorsque vous utilisez cette option, la tâche est supprimée du Planificateur de tâches. Si aucune tâche de redémarrage de tâche n’est en attente, l’évaluation renverra une erreur pour vous informer que la tâche n’existe pas. Exemple : axe /RemoveRestart |
| /NoWarnings | Supprime les messages d’avertissement. Il s'agit d'un paramètre facultatif. Exemple : axe C:\\Assessments\\myJobs\\Job1\.jobx /NoWarnings |
| /Pause | Met AXE.exe en pause après la fin de la tâche. Vous pouvez alors voir toutes les erreurs ou autres informations dans la console avant que AXE.exe ne se ferme et que la console se ferme. La sortie continue lorsque vous appuyez sur une touche. Exemple : axe C:\\Assessments\\myJobs\\Job1\.jobx /Pause |
| /JobParameter parameter=value | Spécifie une valeur pour remplacer un paramètre de tâche qui peut exister dans le manifeste de tâche. Vous pouvez utiliser /JobParameter jusqu’à 100 fois pour spécifier plusieurs paramètres de tâche. Si des noms de paramètres en double apparaissent, l’évaluation utilise la dernière valeur fournie pour ce nom. L’utilisation de /JobParameter est facultative. L’option /PublishPath a la priorité sur la définition du paramètre de tâche ResultsPublishPath avec cette option. Exemple : axe C:\\Assessments\\myJobs\\Job1\.jobx /JobParameter iterations=1 |