适用于: Windows Server (半年通道) ,Windows Server 2019,Windows Server 2016,Windows Server 2012 R2,Windows Server 2012
安装和删除角色、角色服务和功能。 还显示了可用的所有角色、角色服务和功能的列表,并显示在此计算机上安装的。
Important: 此命令 servermanagercmd.exe 已被弃用,且在未来版本的 Windows 中不能保证不受支持。 我们建议改为使用可用于服务器管理器的 Windows PowerShell cmdlet。 有关详细信息,请参阅安装或卸载角色、角色服务或功能。
语法
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 文件中,请指定要替换的 XML 文件 <query.xml> 。 |
-inputpath [[[<drive>:]<path>]<answer.xml>] |
安装或删除由表示的 XML 应答文件中指定的角色、角色服务和功能 <answer.xml> 。 你还可以使用此参数的缩写形式 -p。 |
-install <id> |
安装由指定的角色、角色服务或功能 <id> 。 标识符区分大小写。 多个角色、角色服务和功能必须由空格分隔。 以下可选参数与 -install 参数一起使用:<ul><li>-设置 <SettingName>=<SettingValue> -指定安装所需的设置。</li><li>-allSubFeatures -指定所有从属服务和功能的安装以及在值中命名的父角色、角色服务或功能 <id> 。注意有些角色容器没有允许安装所有角色服务的命令行标识符。 当角色服务无法安装在服务器管理器命令的相同实例中时,就属于这种情况。 例如,active directory 联合身份验证服务和联合身份验证服务代理角色服务的联合身份验证服务角色服务不能使用相同的服务器管理器命令实例来安装。</li><li>-resultpath <result.xml> -将安装结果保存到由表示的 XML 文件 <result.xml> 。 你还可以使用此参数的缩写形式 -r。注意不能同时指定 -resultpath 参数和 -whatif 参数运行 servermanagercmd.exe。</li><li>-重新启动 -安装完成后自动重新启动计算机 (如果) 上安装的角色或功能需要重新启动。</li><li>-whatif -显示为 -install 参数指定的任何操作。 还可以使用 -whatif 参数的缩写形式 -w。 不能同时指定 -resultpath 参数和 -whatif 参数运行 servermanagercmd.exe 。</li><li>-logpath <[[<drive>:]<path>]<log.txt>> -指定日志文件的名称和位置,而不是默认值 %windir%\temp\servermanager.log 。</li></ul> |
-remove <id> |
删除由指定的角色、角色服务或功能 <id> 。 标识符区分大小写。 多个角色、角色服务和功能必须由空格分隔。 以下可选参数与 -remove 参数一起使用:<ul><li>-resultpath <[[<drive>:]<path>]result.xml> -将删除结果保存到由表示的 XML 文件 <result.xml> 。 你还可以使用此参数的缩写形式 -r。注意不能同时指定 -resultpath 和 -whatif 参数运行 servermanagercmd.exe。</li><li>-重新启动 -删除完成后自动重新启动计算机 (如果剩余角色或功能) 需要重新启动。</li><li>-whatif -显示为-remove 参数指定的任何操作。 还可以使用-whatif 参数的缩写形式 -w。 不能同时指定 -resultpath 和 -whatif 参数运行 servermanagercmd.exe。</li><li>-logpath <[[<Drive>:]<path>]<log.txt>>-指定日志文件的名称和位置,而不是默认值 %windir%\temp\servermanager.log 。</li></ul> |
| -version | 显示服务器管理器的版本号。 还可以使用缩写形式 -v。 |
| -help | 在命令提示符窗口中显示帮助。 还可以使用缩写形式 -?。 |
示例
若要显示可用的所有角色、角色服务和功能的列表,以及计算机上安装的角色、角色服务和功能,请键入:
servermanagercmd -query
若要 (IIS) 角色中安装 Web 服务器,并将安装结果保存到 installResult.xml 表示的 XML 文件,请键入:
servermanagercmd -install Web-Server -resultpath installResult.xml
若要显示有关要安装或删除的角色、角色服务和功能的详细信息,请根据 install.xml 所表示的 XML 答案文件中指定的说明键入:
servermanagercmd -inputpath install.xml -whatif
其他参考
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 JasonGerend)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
