Share via

servermanagercmd

  • 發行項

適用於：Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012

安裝及移除角色、角色服務和功能。 也會顯示所有可用的角色、角色服務和功能清單，並顯示此電腦上已安裝的內容。

重要

此命令 servermanagercmd 已被取代，且在未來的 Windows 版本中也不保證提供支援。 建議您改用適用於伺服器管理員的 Windows PowerShell Cmdlet。 如需詳細資訊，請參閱 Install or Uninstall Roles, Role Services, or Features。

語法

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

參數

參數 描述
-query [[[<drive>:]<path>]<query.xml>] 顯示伺服器上已安裝且可用於安裝的所有角色、角色服務和功能清單。 您也可以使用此參數的簡短形式，-q。 如果您想要將查詢結果儲存至 XML 檔案，請指定要取代 <query.xml> 的 XML 檔案。
-inputpath [[[<drive>:]<path>]<answer.xml>] 安裝或移除 <answer.xml> 所表示在 XML 回應檔案中指定的角色、角色服務和功能。 您也可以使用此參數的簡短形式，-p。
-install <id> 安裝 <id> 所指定的角色、角色服務或功能。 識別碼不區分大小寫。 多個角色、角色服務和功能必須以空格分隔。 下列選擇性參數會與 -install 參數搭配使用：
  • <SettingName>=<SettingValue>-setting - 指定安裝的必要設定。
  • -allSubFeatures - 指定所有次級服務和功能的安裝，以及值 <id> 中命名的父系角色、角色服務或功能。

    注意
    某些角色容器沒有命令列識別碼可允許安裝所有角色服務。 當角色服務無法安裝在伺服器管理員命令的相同執行個體時，就會發生這種情況。 例如，使用相同的伺服器管理員命令執行個體，無法安裝 Active Directory Federation Services 和 Federation Service Proxy 角色服務的同盟服務角色服務。

  • <result.xml>-resultpath - 將安裝結果儲存至 <result.xml> 所表示的 XML 檔案。 您也可以使用此參數的簡短形式，-r。

    注意
    您無法同時使用指定的 -resultpath 參數和 -whatif 參數來執行 servermanagercmd。

  • -restart - 安裝完成時自動重新啟動電腦 (如果已安裝的角色或功能需要重新啟動)。
  • -whatif - 顯示 -install 參數指定的任何作業。 您也可以使用 -whatif 參數的簡短形式，-w。 您無法同時使用指定的 -resultpath 參數和 -whatif 參數來執行 servermanagercmd。
  • <[[<drive>:]<path>]<log.txt>>-logpath - 指定記錄檔的名稱和位置，而不是預設值 %windir%\temp\servermanager.log。
-remove <id> 移除 <id> 所指定的角色、角色服務或功能。 識別碼不區分大小寫。 多個角色、角色服務和功能必須以空格分隔。 下列選擇性參數會與 -remove 參數搭配使用：
  • <[[<drive>:]<path>]result.xml>-resultpath - 將移除結果儲存至 <result.xml> 所表示的 XML 檔案。 您也可以使用此參數的簡短形式，-r。

    注意
    您無法同時使用指定的 -resultpath 和 -whatif 參數來執行 servermanagercmd。

  • -restart - 移除完成時自動重新啟動電腦 (如果剩餘的角色或功能需要重新啟動)。
  • -whatif - 顯示為 -remove 參數指定的任何作業。 您也可以使用 -whatif 參數的簡短形式，-w。 您無法同時使用指定的 -resultpath 和 -whatif 參數來執行 servermanagercmd。
  • <[[<Drive>:]<path>]<log.txt>>-logpath - 指定記錄檔的名稱和位置，而不是預設值 %windir%\temp\servermanager.log。
-version 顯示伺服器管理員版本號碼。 您也可以使用簡短形式，-v。
-help 在 [命令提示字元] 視窗中顯示說明。 您也可以使用簡短形式，-?。

範例

若要顯示所有可用角色、角色服務和功能的清單，以及電腦上已安裝哪些角色、角色服務和功能，請輸入：

servermanagercmd -query

若要安裝網頁伺服器 (IIS) 角色，並將安裝結果儲存至以 installResult.xml 表示的 XML 檔案，請輸入：

servermanagercmd -install Web-Server -resultpath installResult.xml

若要根據以 install.xml 表示在 XML 回應檔案中指定的指示，顯示要安裝或移除的角色、角色服務和功能的詳細資訊，請輸入：

servermanagercmd -inputpath install.xml -whatif