servermanagercmd

  • Artikel

Gilt für: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Installiert und entfernt Rollen, Rollendienste und Features. Zeigt außerdem die Liste aller verfügbaren Rollen, Rollendienste und Features an und zeigt an, welche auf diesem Computer installiert sind.

Wichtig

Der Befehl „servermanagercmd“ ist veraltet. Seine Unterstützung in zukünftigen Windows-Versionen wird nicht garantiert. Es wird empfohlen, stattdessen die Windows PowerShell-Cmdlets zu verwenden, die für Server-Manager verfügbar sind. Weitere Informationen finden Sie unter Installieren oder Deinstallieren von Rollen, Rollendiensten oder Features.

Syntax

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

Parameter

Parameter BESCHREIBUNG
-query [[[<drive>:]<path>]<query.xml>] Zeigt eine Liste aller Rollen, Rollendienste und Features an, die auf dem Server installiert und zur Installation verfügbar sind. Sie können auch die Kurzform dieses Parameters verwenden, -q. Wenn die Abfrageergebnisse in einer XML-Datei gespeichert werden sollen, geben Sie eine XML-Datei an, die <query.xml> ersetzen soll.
-inputpath [[[<drive>:]<path>]<answer.xml>] Installiert oder entfernt die Rollen, Rollendienste und Features, die in einer durch <answer.xml> dargestellten XML-Antwortdatei angegeben sind. Sie können auch die Kurzform dieses Parameters verwenden, -p.
-install <id> Installiert die von <id> angegebene Rolle, den Rollendienst oder das Feature. Bei den Bezeichnern wird die Groß-/Kleinschreibung beachtet. Mehrere Rollen, Rollendienste und Features müssen durch Leerzeichen getrennt werden. Die folgenden optionalen Parameter werden mit dem Parameter -install verwendet:
  • -setting<SettingName>=<SettingValue>: Gibt die erforderlichen Einstellungen für die Installation an.
  • -allSubFeatures: Gibt die Installation aller untergeordneten Dienste und Features zusammen mit der übergeordneten Rolle, dem Rollendienst oder dem Feature an, das im Wert <id> benannt ist.

    HINWEIS
    Einige Rollencontainer verfügen nicht über einen Befehlszeilenbezeichner, um die Installation aller Rollendienste zu ermöglichen. Dies ist der Fall, wenn Rollendienste nicht in derselben Instanz des Server-Manager-Befehls installiert werden können. Beispielsweise können der Verbunddienst-Rollendienst der Active Directory-Verbunddienste und der Verbunddienstproxy-Rollendienst nicht mit derselben Instanz des Server-Manager-Befehls installiert werden.

  • -resultpath<result.xml>: Speichert die Installationsergebnisse in einer XML-Datei, die durch <result.xml> dargestellt wird. Sie können auch die Kurzform dieses Parameters verwenden, -r.

    HINWEIS
    Sie können servermanagercmd nicht zugleich mit den angegebenen Parametern -resultpath und -whatif ausführen.

  • -restart: Startet den Computer automatisch neu, wenn die Installation abgeschlossen ist (wenn ein Neustart aufgrund der installierten Rollen oder Features erforderlich ist).
  • -whatif: Zeigt alle Vorgänge an, die für den Parameter -install angegeben sind. Sie können auch die Kurzform des Parameters -whatif verwenden, -w. Sie können servermanagercmd nicht zugleich mit den angegebenen Parametern -resultpath und -whatif ausführen.
  • -logpath<[[<drive>:]<path>]<log.txt>>: Gibt einen Namen und Speicherort für die Protokolldatei an, der vom Standardwert %windir%\temp\servermanager.log abweicht.
-remove <id> Entfernt die von <id> angegebene Rolle, den Rollendienst oder das Feature. Bei den Bezeichnern wird die Groß-/Kleinschreibung beachtet. Mehrere Rollen, Rollendienste und Features müssen durch Leerzeichen getrennt werden. Die folgenden optionalen Parameter werden mit dem Parameter -remove verwendet:
  • -resultpath<[[<drive>:]<path>]result.xml>: Speichert die Entfernungsergebnisse in einer XML-Datei, die durch <result.xml> dargestellt wird. Sie können auch die Kurzform dieses Parameters verwenden, -r.

    HINWEIS
    Sie können servermanagercmd nicht zugleich mit den angegebenen Parametern -resultpath und -whatif ausführen.

  • -restart: Startet den Computer automatisch neu, wenn die Entfernung abgeschlossen ist (wenn ein Neustart aufgrund der verbleibenden Rollen oder Features erforderlich ist).
  • -whatif: Zeigt alle Vorgänge an, die für den Parameter „-remove“ angegeben sind. Sie können auch die Kurzform des Parameters „-whatif“ verwenden, -w. Sie können servermanagercmd nicht zugleich mit den angegebenen Parametern -resultpath und -whatif ausführen.
  • -logpath<[[<Drive>:]<path>]<log.txt>>: Gibt einen Namen und Speicherort für die Protokolldatei an, der vom Standardwert %windir%\temp\servermanager.log abweicht.
-version Zeigt die Server-Manager-Versionsnummer an. Sie können auch die Kurzform -v verwenden.
-help Zeigt Hilfe im Eingabeaufforderungsfenster an. Sie können auch die Kurzform -? verwenden.

Beispiele

Geben Sie Folgendes ein, um eine Liste aller verfügbaren Rollen, Rollendienste und Features anzuzeigen und zu sehen, welche Rollen, Rollendienste und Features auf dem Computer installiert sind:

servermanagercmd -query

Geben Sie Folgendes ein, um die Rolle Webserver (IIS) zu installieren und die Installationsergebnisse in einer XML-Datei zu speichern, die durch installResult.xml dargestellt wird:

servermanagercmd -install Web-Server -resultpath installResult.xml

Geben Sie Folgendes ein, um detaillierte Informationen zu den Rollen, Rollendiensten und Features anzuzeigen, die installiert oder entfernt werden sollen, ausgehend von den Anweisungen, die in einer XML-Antwortdatei angegeben sind, die durch install.xml dargestellt wird:

servermanagercmd -inputpath install.xml -whatif