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 参数一起使用：
  • -setting<SettingName>=<SettingValue> - 指定此安装所需的设置。
  • -allSubFeatures - 指定所有从属服务和功能的安装，以及在 <id> 值中命名的父角色、角色服务或功能。

    注意
    一些角色容器没有允许安装所有角色服务的命令行标识符。 当角色服务无法安装在服务器管理器命令的相同实例中时，就属于这种情况。 例如，Active Directory 联合身份验证服务的“联合身份验证服务”角色服务与“联合身份验证服务代理”角色服务不能使用相同的服务器管理器命令实例进行安装。

  • -resultpath<result.xml> - 将安装结果保存到 <result.xml> 表示的 XML 文件。 也可使用此参数的缩写形式 -r。

    注意
    不能在同时指定 -resultpath 参数和 -whatif 参数的情况下运行 servermanagercmd。

  • -restart - 安装完成后自动重启计算机（如果安装的角色或功能需要重启计算机）。
  • -whatif - 显示为 -install 参数指定的任何操作。 也可使用 -whatif 参数的缩写形式 -w。 不能在同时指定 -resultpath 参数和 -whatif 参数的情况下运行 servermanagercmd。
  • -logpath<[[<drive>:]<path>]<log.txt>> - 指定日志文件的名称和位置，而不是默认值 %windir%\temp\servermanager.log。
-remove <id> 删除由 <id> 指定的角色、角色服务或功能。 标识符区分大小写。 多个角色、角色服务和功能必须用空格分隔。 下列可选参数与 -remove 参数一起使用：
  • -resultpath<[[<drive>:]<path>]result.xml> - 将删除结果保存到 <result.xml> 表示的 XML 文件。 也可使用此参数的缩写形式 -r。

    注意
    不能在同时指定 -resultpath 和 -whatif 参数的情况下运行 servermanagercmd。

  • -restart - 删除完成后自动重启计算机（如果剩余角色或功能需要重启计算机）。
  • -whatif - 显示为 -remove 参数指定的任何操作。 也可使用 -whatif 参数的缩写形式 -w。 不能在同时指定 -resultpath 和 -whatif 参数的情况下运行 servermanagercmd。
  • -logpath<[[<Drive>:]<path>]<log.txt>> - 指定日志文件的名称和位置，而不是默认值 %windir%\temp\servermanager.log。
-version 显示服务器管理器的版本号。 还可以使用缩写形式 -v。
-help 在“命令提示符”窗口中显示帮助。 还可以使用缩写形式 -?。

示例

若要显示所有角色、角色服务和可用功能的列表以及计算机上安装的具体角色、角色服务和功能，请键入：

servermanagercmd -query

若要安装 Web 服务器 (IIS) 角色，并将安装结果保存到由 installResult.xml 表示的 XML 文件，请键入：

servermanagercmd -install Web-Server -resultpath installResult.xml

若要根据 install.xml 表示的 XML 答案文件中指定的说明来显示有关将要安装或删除的角色、角色服务和功能的详细信息，请键入：

servermanagercmd -inputpath install.xml -whatif