servermanagercmd

  • Article

S’applique à : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Installe et supprime des rôles, des services de rôle et des fonctionnalités. Affiche également la liste de tous les rôles, services de rôle et fonctionnalités disponibles, et indique ceux qui sont installés sur cet ordinateur.

Important

Cette commande, servermanagercmd, a été déconseillée et il n’est pas garanti qu’elle soit prise en charge dans les versions ultérieures de Windows. Nous vous recommandons plutôt d’utiliser les applets de commande Windows PowerShell disponibles pour Gestionnaire de serveur. Pour plus d'informations, voir Installer ou désinstaller des rôles, des services de rôle ou des fonctionnalités.

Syntaxe

servermanagercmd -query [[[<drive>:]<path>]<query.xml>] [-logpath [[<drive>:]<path>]<log.txt>]
servermanagercmd -inputpath  [[[<drive>:]<path>]<answer.xml>] [-resultpath <result.xml> [-restart] | -whatif] [-logpath [[<drive>:]<path>]<log.txt>]
servermanagercmd -install <id> [-allSubFeatures] [-resultpath [[<drive>:]<path>]<result.xml> [-restart] | -whatif] [-logpath [[<Drive>:]<path>]<log.txt>]
servermanagercmd -remove <id> [-resultpath <result.xml> [-restart] | -whatif] [-logpath  [[<drive>:]<path>]<log.txt>]
servermanagercmd [-help | -?]
servermanagercmd -version

Paramètres

Paramètre Description
-query [[[<drive>:]<path>]<query.xml>] Affiche la liste de tous les rôles, services de rôle et fonctionnalités installés et disponibles pour l’installation sur le serveur. Vous pouvez également utiliser la forme abrégée de ce paramètre, -q. Si vous souhaitez enregistrer les résultats de la requête dans un fichier XML, spécifiez un fichier XML pour remplacer <query.xml>.
-inputpath [[[<drive>:]<path>]<answer.xml>] Installe ou supprime les rôles, les services de rôle et les fonctionnalités spécifiés dans un fichier de réponses XML représenté par <answer.xml>. Vous pouvez également utiliser la forme abrégée de ce paramètre, -q.
-install <id> Installe le rôle, le service de rôle ou la fonctionnalité spécifié par <id>. Les identificateurs ne respectent pas la casse. Plusieurs rôles, services de rôle et fonctionnalités doivent être séparés par des espaces. Les paramètres facultatifs suivants sont utilisés avec le paramètre -install :
  • -setting<SettingName>=<SettingValue> - Spécifie les paramètres requis pour l’installation.
  • -allSubFeatures - Spécifie l’installation de tous les services et fonctionnalités subordonnés, ainsi que le rôle parent, le service de rôle ou la fonctionnalité nommée dans la valeur <id>.

    REMARQUE
    Certains conteneurs de rôles n’ont pas d’identificateur de ligne de commande pour autoriser l’installation de tous les services de rôle. C’est le cas lorsque les services de rôle ne peuvent pas être installés dans la même instance de la commande Gestionnaire de serveur. Par exemple, le service de rôle de service de fédération des services de fédération active directory et le service de rôle proxy de service de fédération ne peuvent pas être installés à l’aide de la même instance de commande Gestionnaire de serveur.

  • -resultpath<result.xml> - Enregistre les résultats de l’installation dans un fichier XML représenté par <result.xml>. Vous pouvez également utiliser la forme abrégée de ce paramètre, -r.

    REMARQUE
    Vous ne pouvez pas exécuter servermanagercmd avec le paramètre -resultpath et le paramètre -whatif spécifiés.

  • -restart - Redémarre automatiquement l’ordinateur lorsque l’installation est terminée (si le redémarrage est requis par les rôles ou fonctionnalités installés).
  • -whatif - Affiche toutes les opérations spécifiées pour le paramètre -install. Vous pouvez également utiliser la forme abrégée du paramètre -whatif, -w. Vous ne pouvez pas exécuter servermanagercmd avec le paramètre -resultpath et le paramètre -whatif spécifiés.
  • -logpath<[[<drive>:]<path>]<log.txt>> - Spécifie un nom et un emplacement pour le fichier journal, autres que la valeur par défaut, %windir%\temp\servermanager.log.
-remove <id> Supprime le rôle, le service de rôle ou la fonctionnalité spécifié par <id>. Les identificateurs ne respectent pas la casse. Plusieurs rôles, services de rôle et fonctionnalités doivent être séparés par des espaces. Les paramètres facultatifs suivants sont utilisés avec le paramètre -remove :
  • -resultpath<[[<drive>:]<path>]result.xml> - Enregistre les résultats de suppression dans un fichier XML représenté par <result.xml>. Vous pouvez également utiliser la forme abrégée de ce paramètre, -r.

    REMARQUE
    Vous ne pouvez pas exécuter servermanagercmd avec les paramètres -resultpath et -whatif spécifiés.

  • -restart - Redémarre automatiquement l’ordinateur lorsque la suppression est terminée (si le redémarrage est requis par les rôles ou fonctionnalités restants).
  • -whatif - Affiche toutes les opérations spécifiées pour le paramètre -remove. Vous pouvez également utiliser la forme abrégée du paramètre -whatif, -w. Vous ne pouvez pas exécuter servermanagercmd avec les paramètres -resultpath et -whatif spécifiés.
  • -logpath<[[<Drive>:]<path>]<log.txt>> - Spécifie un nom et un emplacement pour le fichier journal, autres que la valeur par défaut, %windir%\temp\servermanager.log.
-version Affiche le numéro de version Gestionnaire de serveur. Vous pouvez également utiliser la forme abrégée, -v.
-help Affiche l’aide dans la fenêtre d’invite de commandes. Vous pouvez également utiliser la forme abrégée, -?.

Exemples

Pour afficher la liste de tous les rôles, services de rôle et fonctionnalités disponibles, et quels rôles, services de rôle et fonctionnalités sont installés sur l’ordinateur, tapez :

servermanagercmd -query

Pour installer le rôle Serveur web (IIS) et enregistrer les résultats de l’installation dans un fichier XML représenté par installResult.xml, tapez :

servermanagercmd -install Web-Server -resultpath installResult.xml

Pour afficher des informations détaillées sur les rôles, les services de rôle et les fonctionnalités qui seraient installés ou supprimés, en fonction des instructions spécifiées dans un fichier de réponses XML représenté par install.xml, tapez :

servermanagercmd -inputpath install.xml -whatif