Azure App Service迁移助手运行崩溃，提示需安装Web Deploy

Hey there, let's work through this issue step by step—since you're not a developer, I'll keep things straightforward and skip unnecessary technical jargon. The core problem here is that the Azure Migration Assistant relies entirely on Web Deploy (MS Deploy) to pull your IIS site's content, configuration, and dependencies, so we need to make sure it's properly installed first.

Step 1: Uninstall any existing/old Web Deploy versions #

• Open Control Panel > Programs and Features on your Windows 2012 R2 web server.
• Look for any entries named Microsoft Web Deploy (older versions like 3.0 might be incompatible). Uninstall all of them.
• Restart your server after uninstalling—this ensures leftover files and settings are fully cleared.

Step 2: Install the compatible Web Deploy version #

• For Windows 2012 R2 and IIS 8.5, Web Deploy 3.6 is the most stable and compatible version.
• When running the installer, select the Complete installation option (don't choose custom—this ensures all required components are installed without missing anything).
• After installation, restart IIS to apply changes: open Command Prompt as administrator and run:

  iisreset
  

Step 3: Verify Web Deploy is working correctly #

• Open IIS Manager on your web server.
• Right-click any of your IIS sites, go to Deploy > Export Application....
• If the export wizard pops up without errors, Web Deploy is functioning properly. If not, re-run the installer with admin rights to fix any missing components.

Step 4: Re-run the Azure Migration Assistant #

• Launch the assistant as an administrator (right-click the shortcut > Run as administrator)—it needs elevated permissions to access IIS and system settings.
• If it still crashes, check the migration assistant logs for more details:
  • Logs are stored at C:\Users\<Your Username>\AppData\Local\Azure App Service Migration Assistant\Logs
  • Look for entries mentioning missing components or permission failures—this can help narrow down any remaining issues.

Bonus: Quick note on your SQL Database #

Once the migration assistant is working, it should automatically detect your SQL Server 2014 connection. You'll be given options to migrate the database to Azure SQL Database or Azure SQL Managed Instance—just follow the wizard's prompts, no advanced SQL knowledge needed.

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