Interprétation de la sortie à partir des commandes du Gestionnaire de serveur

Remarques
La commande Servermanagercmd.exe est déconseillée et sa prise en charge n’est pas garantie dans les futures versions de Windows. Nous vous recommandons l’utilisation des applets de commande Windows PowerShell qui sont disponibles pour le Gestionnaire de serveur.

La commande du Gestionnaire de serveur, ServerManagerCmd.exe, produit des résultats concernant ses opérations et fait ressortir certaines parties de ces résultats à l’écran. Le Gestionnaire de serveur rédige également beaucoup plus de commentaires dans un fichier journal texte. Vous pouvez également configurer Gestionnaire de serveur de manière à rédiger les opérations de ligne de commande dans un fichier de résultats XML.

Cette section identifie et décrit les codes et les messages trouvés dans des fichiers de sortie de commande Gestionnaire de serveur.

Résultats d’opérations de ligne de commande du Gestionnaire de serveur

Par défaut, le Gestionnaire de serveur écrit des résultats de commande dans un fichier journal texte, logname.txt, situé dans %windir%\logs\ServerManager.log.

	Remarques
	Bien que ce journal stocke une sortie sur les opérations de la commande Gestionnaire de serveur, la sortie est très commentée et son format n’est pas convivial. Ce fichier journal se révèle utile si vous devez contacter les services de support technique de Microsoft concernant les opérations de Gestionnaire de serveur.

Vous pouvez modifier le nom et l’emplacement par défaut du fichier journal en ajoutant le paramètre -logPath à la ligne de commande du Gestionnaire de serveur, ServerManagerCmd.exe. Pour plus d’informations sur le paramètre -logPath et la syntaxe de ServerManagerCmd.exe, voir Vue d’ensemble des commandes du Gestionnaire de serveur.

En plus du fichier journal texte créé par défaut par Gestionnaire de serveur, vous pouvez demander à Gestionnaire de serveur de stocker les résultats de ses opérations dans un fichier XML avec un nom et un emplacement que vous fournissez. Le paramètre permettant de spécifier le nom et l’emplacement du fichier de résultats XML est -resultPath.

Les paramètres -logPath et -resultPath sont utilisés depuis la ligne de commande, que vous utilisiez un fichier de réponses avec la commande Gestionnaire de serveur pour spécifier une liste de rôles ou de fonctionnalités à supprimer, ou que vous installiez ou supprimiez un élément unique directement depuis la ligne de commande. Pour plus d’informations sur le fichier de réponses de ligne de commande Gestionnaire de serveur, voir Création d’un fichier de réponses pour les commandes du Gestionnaire de serveur.

Exemples

Les exemples suivants indiquent comment spécifier le nom et le chemin d’accès à un fichier de résultats XML dans la commande Gestionnaire de serveur.

Exemple de spécification de fichier de résultats dans une commande avec un fichier de réponses

ServerManagerCmd.exe -inputPath C:\CmdLine\Remove_roles.xml -resultPath C:\CmdLine\010107.xml

Dans l’exemple précédent, un administrateur a créé un fichier de réponses nommé Remove_roles.xml, contenant des commandes afin de supprimer plusieurs rôles d’un serveur. L’administrateur a spécifié un nom et un emplacement de fichier de résultats, C:\CmdLine\010107.xml.

Exemple de spécification de fichier de résultats dans une commande sans fichier de réponses

ServerManagerCmd.exe -install npas -allSubFeatures -r C:\CmdLine\Results\010107.xml -restart

Dans l’exemple précédent, un administrateur a donné l’instruction au Gestionnaire de serveur d’installer les services de stratégie et d’accès réseau. Notez que le nom de la commande pour le rôle, npas, ne respecte pas la casse.

Dans cet exemple, tous les services de rôle des services de stratégie et d’accès réseau sont installés, conformément à ce qui est demandé, avec le paramètre -allSubFeatures. L’administrateur utilise la forme abrégée du paramètre -resultPath, -r, pour spécifier le nom d’un fichier de résultats et son chemin d’accès. Enfin, l’administrateur utilise le paramètre -restart pour indiquer au Gestionnaire de serveur de redémarrer l’ordinateur, si nécessaire, une fois l’installation du rôle des services de stratégie et d’accès réseau terminée.

Descriptions de messages de sortie

Cette section décrit la sortie et les résultats renvoyés par Gestionnaire de serveur dans un fichier de résultats XML.

Messages de sortie

Le tableau ci-dessous identifie et décrit les messages que la commande Gestionnaire de serveur écrit dans la fenêtre de console et dans les fichiers de résultats.

Message	Code de sortie	Chaîne de texte	Remarques
Opération réussie, pas besoin de redémarrer	0	Opération réussie : installation réussie. Opération réussie : suppression réussie.	Deux messages différents peuvent varier légèrement selon que l’utilisateur a spécifié des rôles ou des fonctionnalités dans la commande.
Opération réussie, un redémarrage est requis	3010	Opération réussie : Installation réussie. Un redémarrage est requis. Opération réussie : Suppression réussie. Un redémarrage est requis.	Ce code est renvoyé lorsqu’un redémarrage est requis. Après le redémarrage de l’ordinateur, vous devrez peut-être exécuter le Gestionnaire de serveur dans l’interface utilisateur de Windows Server 2008 R2 pour procéder à la configuration requise des rôles ou des fonctionnalités.
Argument non valide	4	ArgumentNotValid : Argument non valide {argument} ArgumentNotValid : chemin d’accès au fichier de réponse manquant ArgumentNotValid : chemin d’accès au fichier journal manquant ArgumentNotValid : fonctionnalité non valide « {nom} ». Nom de la fonctionnalité introuvable. ArgumentNotValid : rôle non valide : « {nom} ». Nom du rôle introuvable. ArgumentNotValid : le nom suivant a déjà été spécifié dans le chemin d’accès d’entrée : {nom} ArgumentNotValid : le paramètre suivant a déjà été spécifié dans le chemin d’accès d’entrée : {paramètre} ArgumentNotValid : fonctionnalité non valide. « {nom} » est un rôle. ArgumentNotValid : fonctionnalité non valide. « {nom} » est un service de rôle. ArgumentNotValid : rôle non valide. « {nom} » est une fonctionnalité. ArgumentNotValid : rôle non valide. Le nom « {nom} » est pour un service de rôle. ArgumentNotValid : service de rôle non valide. « {nom} » est une fonctionnalité. ArgumentNotValid : service de rôle non valide. « {nom} » est un rôle.	Se produit lorsqu’un utilisateur fournit un argument inexistant ou qu’il omet une partie requise d’un argument spécifique dans la ligne de commande Gestionnaire de serveur. Différents messages s’affichent, selon l’argument qui nécessite une attention. {argument} représente l’argument incorrect spécifié par l’utilisateur. {nom} représente le nom incorrectement spécifié du rôle, du service de rôle ou de la fonctionnalité. {paramètre} représente le nom d’une référence spécifié ou dupliquée de manière incorrecte dans un paramètre de rôle, de service de rôle ou de fonctionnalité.
Erreur lors de l’ouverture ou de la lecture d’un fichier d’entrée	110	ReadError : le fichier de réponses n’existe pas. {0} ReadError : échec de la lecture du fichier de réponses : {0} ReadError : échec du chargement du fichier de réponse : {0}. {1}	Se produit si l’interface de ligne de commande de Gestionnaire de serveur ne peut lire ou localiser le fichier de réponses fourni par un utilisateur. Plusieurs messages s’affichent pour le même code d’erreur (110), selon la raison spécifique pour laquelle le fichier de réponses n’a pu être chargé. {0} représente le chemin d’accès et le nom spécifiés par l’utilisateur. {1} représente l’exception trouvée par Gestionnaire de serveur. Si ce message apparaît, le dépannage conseillé consiste à vérifier que vous avez fourni le nom et le chemin d’accès corrects à votre fichier de réponses XML, à vous assurer que le fichier de réponses est validé en fonction du schéma de fichier de réponses Gestionnaire de serveur et qu’il utilise la structure d’élément correcte. Pour plus d’informations sur l’installation et l’apparence correctes d’un fichier de réponses de commande Gestionnaire de serveur, voir Création d’un fichier de réponses pour les commandes du Gestionnaire de serveur.
Autorisations ou informations d’identification insuffisantes	5	Erreur : Gestionnaire de serveur peut être exécuté uniquement par un membre du groupe Administrateurs intégré sur l’ordinateur local. Vous devez installer et supprimer des rôles et des fonctionnalités uniquement avec des autorisations élevées.	Cette erreur se produit si les informations d’identification d’utilisateur fournies ne disposent pas de droits d’administration locaux sur le serveur, ou si un utilisateur n’a pas ouvert la fenêtre d’invite de commandes avec des autorisations élevées. Pour cela, cliquez avec le bouton droit sur le fichier exécutable Invite de commandes, ou sur Invite de commandes dans le menu Démarrer, puis cliquez sur Exécuter en tant qu’administrateur.
Aucune modification requise	1003	NoChange : aucune modification n’a été apportée car les rôles et fonctionnalités spécifiés dans le fichier de réponses sont déjà installés, ou ont déjà été supprimés de l’ordinateur local.	Se produit si les rôles, services de rôle ou fonctionnalités spécifiés dans le fichier de réponses à installer sont déjà installés sur l’ordinateur, ou si le fichier de réponses demande leur suppression et que Gestionnaire de serveur a trouvé qu’ils n’existaient pas sur l’ordinateur ou qu’ils avaient déjà été supprimés. En d’autres termes, ce message apparaît si les actions spécifiées dans la commande entraînent une opération null.
Une instance de l’Assistant Gestionnaire de serveur est déjà en cours d’exécution sur cet ordinateur	1004	Erreur : un autre utilisateur exécute un Assistant dans l’interface utilisateur de Gestionnaire de serveur.	Si l’un des Assistants de Gestionnaire de serveur (Ajout de rôles, Ajout de fonctionnalités, Ajout de services de rôle, Suppression de rôle, Suppression de fonctionnalités, Suppression de services de rôle) est déjà en cours d’exécution, les tentatives d’exécution de la ligne de commande Gestionnaire de serveur pour installer ou supprimer des rôles, des services de rôle ou des fonctionnalités échouent. Gestionnaire de serveur empêche les modifications par des utilisateurs conflictuels des packages logiciels installés sur un serveur en exécutant un seul outil à la fois. Les outils en ligne de commande ou un Assistant Gestionnaire de serveur peuvent être exécutés, mais pas simultanément.
Un échec s’est produit lors de la collecte de la liste des rôles et fonctionnalités installés ou pendant l’installation ou la suppression des éléments spécifiés par l’utilisateur.	1000	Erreur : L’installation d’au moins un rôle, un service de rôle ou une fonctionnalité a échoué. Consultez le fichier journal du Gestionnaire de serveur pour obtenir des informations supplémentaires, puis réessayez. Erreur : La suppression d’au moins un rôles, services de rôle ou fonctionnalités a échoué. Consultez le fichier journal du Gestionnaire de serveur pour obtenir des informations supplémentaires, puis réessayez.	Deux messages différents peuvent varier légèrement selon que l’utilisateur a spécifié des rôles ou des fonctionnalités dans la commande.
Idem à l’erreur 1000, sauf qu’un redémarrage est requis par cette erreur afin d’annuler toute modification apportée à l’ordinateur.	1001	Erreur : L’installation d’au moins un rôles, services de rôle ou fonctionnalités a échoué et un redémarrage est requis pour annuler les modifications apportées à l’ordinateur. Consultez le fichier journal du Gestionnaire de serveur pour obtenir des informations supplémentaires, puis réessayez. Erreur : La suppression d’au moins un rôles, services de rôle ou fonctionnalités a échoué et un redémarrage est requis pour annuler les modifications apportées à l’ordinateur. Consultez le fichier journal du Gestionnaire de serveur pour obtenir des informations supplémentaires, puis réessayez. Erreur : L’installation du rôle, service de rôle ou fonctionnalité a échoué car l’ordinateur doit être redémarré pour terminer une autre installation ou suppression. Après le redémarrage de l’ordinateur, essayez de réinstaller le rôle, service de rôle ou fonctionnalité. Erreur : La suppression du rôle, service de rôle ou fonctionnalité a échoué car l’ordinateur doit être redémarré pour terminer une autre installation ou suppression. Après le redémarrage de l’ordinateur, essayez de supprimer à nouveau le rôle, service de rôle ou fonctionnalité.	Les différents messages peuvent varier sensiblement, selon que l’utilisateur a spécifié des rôles ou des fonctionnalités dans la commande.
Erreur générique	1002	Erreur : Erreur générique. {0}	Il s’agit d’une erreur générique pour laquelle il n’existe aucune information de dépannage disponible. Si vous recevez cette erreur, il est conseillé de vérifier la syntaxe de votre commande, de vous assurer d’avoir ouvert une session sur l’ordinateur local en tant que membre du groupe Administrateurs et de réessayer la commande. {0} représente l’exception trouvée par Gestionnaire de serveur.

Fichier de résultats XML

Ci-dessous figure un exemple du fichier de résultats créé par Gestionnaire de serveur lorsque le paramètre -resultPath ou -r est ajouté à la ligne de commande Gestionnaire de serveur et qu’un nom et un emplacement sont fournis dans le paramètre.

< ServerManagerConfigurationResult
Action="Install"
Time="2006-11-29T14:26:39"
Language="en-US"
Success="true"
RequiresReboot="false"
xmlns="https://schemas.microsoft.com/sdm/Windows/ServerManager/Configuration/2007/1">
<Message Level="Information">Start Installing...</Message>
<Role DisplayName="DHCP Server"
Id="DHCP"
Success="true"
RequiresReboot="false"
RequestedBy="UserSpecified">
<Message Level="Information">Succeeded: [DHCP Server] </Message>
</Role>
<Message Level="Information">Install succeeded.</Message>
</ServerManagerConfigurationResult>

Le tableau suivant identifie et décrit les éléments du fichier de résultats.

Élément ou attribut	Description
ServerManagerCommandLineResult	Élément d’en-tête ; conteneur pour le fichier entier.
Action	Identifie si les résultats affichés sont destinés à une opération d’installation ou de suppression.
Time	Affiche la date et l’heure de fin de l’opération.
Language	Affiche le code de langue (dans cet exemple, il s’agit d’Anglais (États-Unis)) pour les messages localisés inclus dans les résultats.
Success	Affiche la valeur « true » si l’action a réussi pour tous les rôles, services de rôle et fonctionnalités spécifiés dans la commande ; « false » si l’action a échoué pour un ou plusieurs rôles, services de rôle ou fonctionnalités.
RequiresReboot	Affiche la valeur « true » si vous devez redémarrer l’ordinateur en raison de l’opération d’installation ou de suppression réussie ; « false » si aucun redémarrage n’est requis.
Xmlns	Cet attribut fait référence à la définition de schéma XML de ligne de commande Gestionnaire de serveur.
Message	Tous les messages d’information, d’avertissement et d’erreur sont inclus dans le corps du fichier XML. Un message général concernant la totalité de l’opération se trouve au niveau supérieur. Cependant, si un message s’applique à un rôle, service de rôle ou fonctionnalité spécifique, le message est contenu dans l’élément spécifique de cet élément. Les messages sont localisés dans la langue spécifiée par l’attribut de langue. Level Précise la nature du message : une erreur, un avertissement ou des informations à transmettre. Code Le cas échéant, affiche une erreur numérique ou un code de message. Les codes de message et d’erreur du Gestionnaire de serveur sont décrits dans cette rubrique, à la section Fichier journal au format texte.
Role, Role Service, or Feature	Des éléments de rôle, de service de rôle ou de fonctionnalité peuvent se produire plusieurs fois dans le fichier de résultats, selon les objets pour lesquels le fichier de réponses de la ligne de commande Gestionnaire de serveurdemande une installation ou une suppression. DisplayName Nom localisé du rôle, service de rôle ou fonctionnalité. Id Nom de la commande du rôle, service de rôle ou fonctionnalité. Une liste de nom de commande pour les rôles, services de rôle ou fonctionnalités est disponible dans Vue d’ensemble des commandes du Gestionnaire de serveur. RootParent Nom de l’objet parent pour la valeur spécifiée dans l’attribut DisplayName. Par exemple, l’objet parent du service de rôle Filtrage des demandes est Serveur Web. Success Affiche une valeur « true » si l’action spécifiée dans l’attribut Action a réussi pour l’objet spécifié dans DisplayName, et « false » si l’action a échoué. RequiresReboot Affiche une valeur « true » si l’installation ou la suppression de l’objet spécifié dans l’attribut DisplayName nécessite un redémarrage de l’ordinateur, et « false » si aucun redémarrage n’est requis. Skipped Affiche une valeur « true » si les rôles, services de rôle ou fonctionnalités spécifiés dans le fichier de réponses comme devant être installés sont déjà installés sur l’ordinateur, ou si le fichier de réponses demande leur suppression et que le Gestionnaire de serveur a trouvé qu’ils n’existaient pas sur l’ordinateur ou qu’ils avaient déjà été supprimés. En d’autres termes, cet attribut possède une valeur « true » uniquement si les actions spécifiées dans la commande entraînent une opération null. Affiche une valeur « false » si le Gestionnaire de serveur a effectué les actions spécifiées dans la commande. RequestedBy Affiche la raison de l’installation ou de la suppression d’un rôle, service de rôle ou fonctionnalité. Il existe quatre valeurs possibles. Demande directe d’un utilisateur Requis par la dépendance d’un autre rôle, service de rôle ou fonctionnalité Un objet de conteneur a été installé ou supprimé et cet objet est sélectionné par défaut Tous les objets enfants d’un conteneur de rôle, service de rôle ou fonctionnalité ont été sélectionnés (par exemple, l’utilisateur a ajouté le paramètre -allSubFeatures à la commande Gestionnaire de serveur) Message Voir la description du message à la ligne précédente. Les messages imbriqués dans des éléments de rôle, service de rôle ou fonctionnalité sont spécifiques à cet objet uniquement.

	Remarques
	La commande Servermanagercmd.exe est déconseillée et sa prise en charge n’est pas garantie dans les futures versions de Windows. Nous vous recommandons l’utilisation des applets de commande Windows PowerShell qui sont disponibles pour le Gestionnaire de serveur.