servermanagercmd

安装和删除角色、角色服务和功能。 还显示所有可用角色、角色服务和功能的列表,并显示安装在此计算机上的内容。

重要

此命令 (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

参数

参数 说明
-查询 [[[<drive>:]<path>]<query.xml>] 显示在服务器上的已安装和可安装的所有角色、角色服务和功能的列表。 还可以使用此参数的缩写形式 -q。 如果要将查询结果保存到 XML 文件,请指定要替换 <query.xml> 的 XML 文件。
-inputpath [[[<drive>:]<path>]<answer.xml>] 安装或删除 <answer.xml> 表示的 XML 答案文件中指定的角色、角色服务和功能。 还可以使用此参数的缩写形式 -p。
-安装 <id> 安装由 <id> 指定的角色、角色服务或功能。 标识符区分大小写。 多个角色、角色服务和功能必须用空格分隔。 下列可选参数与 -install 参数一起使用:
  • -setting<SettingName>=<SettingValue> - 指定安装所需的设置。
  • -allSubFeatures - 指定所有从属服务和功能的安装,以及在 <id> 值中命名的父角色、角色服务或功能。

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

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

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

  • -restart - 安装完成后自动重启计算机(如果安装的角色或功能需要重启计算机)。
  • -whatif - 显示为 -install 参数指定的任何操作。 也可使用 -whatif 参数的缩写形式 -w。 不能在同时指定 -resultpath 参数和 -whatif 参数的情况下运行 servermanagercmd
  • -logpath<[[<drive>:]<path>]<log.txt>> - 指定日志文件的名称和位置,而不是默认值 %windir%\temp\servermanager.log
-删除 <id> 删除由 <id> 指定的角色、角色服务或功能。 标识符区分大小写。 多个角色、角色服务和功能必须用空格分隔。 下列可选参数与 -remove 参数一起使用:
  • -resultpath<[[<drive>:]<path>]result.xml> - 将删除结果保存到由该 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
-版本 显示服务器管理器的版本号。 还可以使用缩写形式 -v。
-帮助 在“命令提示符”窗口中显示帮助。 还可以使用缩写形式 -?。

示例

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

servermanagercmd -query

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

servermanagercmd -install Web-Server -resultpath installResult.xml

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

servermanagercmd -inputpath install.xml -whatif