BizTalk Server 2020：启用REST APIs配置失败原因及服务器级解决方法

问题说明 #

按照官方配置步骤启用BizTalk Server 2020的REST APIs功能时，配置向导的REST APIs选项卡无内容显示，且出现依赖Microsoft.Web.Administration组件的错误。服务器为已运行数月的现有环境，未安装Visual Studio，无法直接通过NuGet获取组件。

服务器层面解决方案 #

方法1：手动安装IIS管理库（推荐） #

Microsoft.Web.Administration是IIS管理核心库，默认随IIS管理工具安装，若缺失可通过Windows功能手动添加：

• 打开服务器管理器，点击添加角色和功能
• 依次进入功能页面，找到Web服务器（IIS）下的管理工具，勾选IIS管理脚本和工具以及IIS管理控制台
• 完成安装后重启BizTalk配置向导，检查REST APIs选项卡是否恢复正常

方法2：手动复制并注册组件文件 #

从同版本的正常BizTalk Server环境或已安装该组件的机器上，复制以下文件到目标服务器对应路径：

• 将Microsoft.Web.Administration.dll复制到C:\Windows\System32\inetsrv目录
• 若存在Microsoft.Web.Administration.xml，一并复制到同一目录
• 以管理员身份打开命令提示符，执行注册命令：

  regsvr32 C:\Windows\System32\inetsrv\Microsoft.Web.Administration.dll
  

• 注册完成后重启BizTalk配置向导

方法3：通过离线NuGet包提取组件 #

1. 在有网络的机器上，下载与服务器.NET框架版本匹配的Microsoft.Web.Administration离线NuGet包（BizTalk 2020通常对应.NET Framework 4.8）
2. 将下载的.nupkg文件重命名为.zip并解压
3. 从解压后的lib\net48（对应版本）目录中取出Microsoft.Web.Administration.dll
4. 将文件复制到目标服务器的C:\Windows\System32\inetsrv目录，执行方法2中的注册命令
5. 重启BizTalk配置向导

验证操作 #

完成上述任一方法后，重新打开BizTalk Server配置向导，切换到REST APIs选项卡，确认内容正常显示后，即可继续完成REST APIs的配置步骤。

内容的提问来源于stack exchange，提问作者FMFF