msdeploy（Web 部署）因 401 身份验证问题而失败

Question

我正在尝试安装并设置 msdeploy。我已在 Web 服务器上安装了远程服务，但所有测试均给出 401 未经授权的错误。服务器是Windows 2008 R2。

我正在测试一个非常简单的 msdeploy 命令：

msdeploy -verb:dump -source:contentPath=c:\inetpub\wwwroot\MyApp,computerName=<IP HERE>,userName=Domain\msdeploy,password=MyPassword

错误：

Error: Object of type 'contentPath' and path 'c:\inetpub\wwwroot\MonApp' cannot be created.
Error: Remote agent (URL http://<IP HERE>/MSDEPLOYAGENTSERVICE) could not be contacted.  Make sure the remote agent service is installed and started on the target computer.
Error: An unsupported response was received. The response header 'MSDeploy.Response' was '' but 'v1' was expected.
Error: The remote server returned an error: (401) Unauthorized.
Error count: 1.

我创建了一个名为 msdeploy 的用户，并将其添加到服务器上的本地管理员组中。

我已经检查过：

• 该服务安装正确，并且我启动了它
• 不使用用户名的域部分并添加 authType=Basic 的各种组合
• 为每个人提供对该文件夹的完全权限
• 在 IIS 中允许远程连接
• 添加了管理服务委派规则我的 contentPath 和 iisApp 的“msdeploy”用户（大致基于阅读 这个）
• 尝试使用我用于 RDC 到服务器的不同管理员帐户...
• 尝试使用不同的 contentPaths 和不同的 msdeploy 命令
• 创建一个特定帐户，并将该帐户添加到 IIS_Users。将该用户添加到我的网站“IIS 管理器权限”，并为所有提供商设置“管理服务委派”。

Answer 1

我假设您已按照本文正确配置了 WebDeploy 2.0 的服务器：

配置 Web部署（IIS.NET）

注意：MS 已经发布了 Web Deploy 2.0 的更新版本，原始链接不再有效。我已经更新了此内容，但我认为随着时间的推移，它将成为一个移动目标。

您还需要在您的开发/构建/CI 计算机上安装 Web Deploy 2.0。

如果您仍在使用 1.0 那么我建议升级，2.0 中有一些巨大的改进。

使用 Visual Studio 2010 的发布功能：

Visual Studio 可以通过右键单击网站并选择“发布”来发布网站。这将显示以下对话框：

Visual Studio 2010 和 WebDeploy 2.0 有一些问题。首先，VS2010 不支持 WebDeploy/MSDeploy 2.0。因此，如果您尝试发布，您将收到如下错误：

错误 1 ​​Web 部署任务
失败。((04/02/2011 12:30:40) 错误
当请求发生时发生
在远程计算机上处​​理。）

您还将在失败的请求跟踪中看到以下错误：服务器上的 Web 管理服务位于 C:\inetpub\logs\wmsvc\TracingLogFiles\W3SVC1 假设您已打开此服务：

AspNetModuleDiagErrorEvent
URI /msdeploy.axd
事件数据追踪
部署代理异常。请求ID
”。请求时间戳：'02/04/2011
System.UnauthorizedAccessException：对路径“D:\”的访问被拒绝。

驱动器号将根据 IIS 站点所在的驱动器而有所不同。

GUI 内的发布机制开箱即用，默认使用错误版本的 MSDeploy (1.0)。我们想要告诉 VS2010 使用 MSDeploy 2.0。您可以通过编辑 Visual Studio 2010 的 devenv.exe.config 文件来执行此操作（假设您执行了默认的 c:\ 驱动器安装）：

对于 64 位系统：c:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE
对于 32 位系统：c:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE

在您最喜欢的 XML 编辑器中打开 devenv.exe.config（我刚刚使用 Visual Studio 2010 本身）并复制以下 xml：

<dependentAssembly>
  <assemblyIdentity 
    name="Microsoft.Web.Deployment" 
    publicKeyToken="31bf3856ad364e35" culture="neutral"/>
  <bindingRedirect oldVersion="7.1.0.0" newVersion="8.0.0.0"/>
</dependentAssembly>

将其添加到 /configuration/runtime/ assemblyBinding 部分：

完成此操作后，请关闭 Visual Studio 2010 的所有实例以使此更改生效。重新启动VS2010，打开一个Web项目，然后再次尝试发布。这次应该会成功。

使用构建包发布：

Visual Studio 可以生成可以从命令行执行的构建包。这是使用 Project -> 生成的构建部署包。方便持续集成等（也可以使用带有 /t:Package 开关的 msbuild 生成包）。

包的输出文件夹通常默认为 obj\Package。

不幸的是，Visual Studio 2010 遇到了一些错误，并生成了一个针对 1.0 的 msdeploy 包装批处理脚本，并针对服务器而不是站点级别的部署。

除了创建自己的 msdeploy.exe 命令行之外，没有快速解决此问题的方法。我将其分成几行，以使其更具可读性。：

"C:\Program Files\IIS\Microsoft Web Deploy v2\\msdeploy.exe"
  -source:archiveDir='d:\sites\DemoApp\obj\Package\Archive' 
  -dest:
       auto,
       computerName='https://yoursite.com:8172/msdeploy.axd?site=yoursitename',
       userName='demosite',
       password='somepassword',
       authtype='basic',
       includeAcls='False' 
  -verb:sync 
  -disableLink:AppPoolExtension 
  -disableLink:ContentExtension 
  -disableLink:CertificateExtension 
  -setParamFile:"d:\sites\DemoApp\obj\Package\Archive.SetParameters.xml"   
  -allowuntrusted

首先要注意的是 msdeploy.exe 的路径。 Visual Studio 生成版本 1.0 的路径。我已经将其更改为使用 2.0。

值得注意的参数：

-source:archiveDir= 告诉 msdeploy 我们正在部署包并提供本地位置

computerName='https://yoursite.com:8172 /msdeploy.axd?site=yoursitename' - 这告诉 MSDEPLOY 部署到 IIS7 上的特定站点。 yoursitename 应与 IIS 中的站点名称完全匹配。

userName 和 password 是网站委派管理员用户的名称。这是使用站点级别的“IIS 管理器权限”功能进行配置的。该帐户必须是本地 Windows 用户帐户。

-authtype='basic' - 这会强制进行基本身份验证，否则会尝试 NTLM 身份验证。

-allowuntrusted - 如果您使用内置的自签名 SSL 证书，则会忽略任何 SSL 证书错误。

如果您使用该命令行，那么您应该能够成功部署到远程 IIS7 服务器。

发布原始内容：

有时我们只想直接从本地文件夹发布一些静态内容（甚至可能是经典 ASP 或 PHP 站点）。我们可以使用以下 msdeploy.exe 命令行来执行此操作：

"C:\Program Files\IIS\Microsoft Web Deploy v2\\msdeploy.exe" 
  -source:contentPath='d:\websites\mysite' 
  -dest:
     contentPath='yoursitename',
     computerName='https://yoursite.com:8172/msdeploy.axd?site=yoursitename',
     userName='demosite',
     password='somepassword',
     authtype='basic',
     includeAcls='False' 
-verb:sync 
-allowuntrusted 

对于 -dest:contentPath 和 computerName 再次应用与之前相同的规则。

我相信 MSDeploy 版本问题将在 SP1 中得到解决（我还没有机会查看）。

最后一个 VS2010 问题：

使用 Visual Studio 2010 进行发布时，“发布”构建包会导致网站匿名帐户的 ACL 对所有文件和文件夹更改为只读，>App_Data 文件夹已更改为“读取”和“写入”。

可以通过将以下设置添加到每个 ：

<IncludeSetAclProviderOnDestination>False</IncludeSetAclProviderOnDestination>

或者如果您使用的是 msbuild：

msbuild.exe myproject.csproj /t:Package /p:IncludeSetAclProviderOnDestination=False

我从这里发现了有用的金块：

跳过在 Visual Studio 2010 部署包中设置 ACL（WayBackMachine 链接，因为原始内容不再可用）

Answer 2

对我来说，发布在 Visual Studio 中工作，但当我运行 .deploy.cmd 脚本时它不起作用。

通过在 .csproj 中设置 true，您可以强制 VS 使用 msdeploy.exe 而不是 MSBuild 任务。然后通过调高日志记录级别（工具 > 选项 > 项目和解决方案 > 构建和运行 > MSBuild 项目构建输出详细程度），您可以看到 VS 使用的命令行。

我的 .deploy.cmd 的问题是：

• 我的 IIS 用户只有该站点的权限，因此我需要 computerName< 中的 ?site= /代码>。
• 我需要在 -dest: 参数中使用 AuthType='Basic' 。

Answer 3

我们面临着与您类似的问题。

为此，您需要在服务中启动远程代理服务。
我们使用 PC 名称是因为 IP 地址出错。所以尝试使用电脑名称、用户名和密码。

Answer 4

最后，我从未弄清楚我的部署用户帐户缺少哪些权限 - 但发现如果我使用计算机管理员帐户，部署就会成功。目前我正在使用管理员帐户进行部署。

感谢 Kev 对设置 MS 部署 2 所做的精彩而内容丰富的总结:)

Answer 5

为了它的价值。发布对我来说很有效，然后有一天我遇到了同样的问题（401 未经授权的错误），重新启动 VS2012 解决了该问题。希望在尝试其他所有解决方案之前我已经尝试过这一点。