Depurar remotamente o ASP.NET num computador IIS remoto

Para depurar um aplicativo ASP.NET que foi implantado no IIS, instale e execute as ferramentas remotas no computador onde você implantou seu aplicativo e, em seguida, anexe ao seu aplicativo em execução do Visual Studio.

Este guia explica como instalar e configurar um aplicativo Visual Studio ASP.NET MVC 4.8, implantá-lo no IIS e anexar o depurador remoto do Visual Studio.

Observação

Para realizar depuração remota no ASP.NET Core, consulte Remote Debug ASP.NET Core num computador IIS. Para o Serviço de Aplicações do Azure, consulte Depuração remota ASP.NET Core no Azure ou, para o Visual Studio Enterprise, use o Depurador de Instantâneos (necessário .NET 4.6.1).

Pré-requisitos

O Visual Studio 2019 ou uma versão posterior é necessário para seguir as etapas mostradas neste artigo.

Estes procedimentos foram testados nestas configurações de servidor:

• Windows Server 2022 e IIS 10
• Windows Server 2012 R2 e IIS 8 (para Windows Server 2008 R2, as etapas do servidor são diferentes)

Requisitos de rede

O depurador remoto é suportado no Windows Server a partir do Windows Server 2008 Service Pack 2. Para obter uma lista completa de requisitos, consulte Requisitos.

Observação

Não há suporte para depuração entre dois computadores conectados por meio de um proxy. A depuração através de uma ligação de alta latência ou baixa largura de banda, como a Internet de acesso telefónico, ou através da Internet entre países/regiões não é recomendada e pode falhar ou ser inaceitavelmente lenta.

O aplicativo já está em execução no IIS?

Este artigo inclui etapas sobre como configurar uma configuração básica do IIS no servidor Windows e implantar o aplicativo do Visual Studio. Essas etapas estão incluídas para garantir que o servidor tenha os componentes necessários instalados, que o aplicativo possa ser executado corretamente e que você esteja pronto para a depuração remota.

• Se o seu aplicativo estiver sendo executado no IIS e você quiser apenas baixar o depurador remoto e iniciar a depuração, vá para Baixar e instalar as ferramentas remotas no Windows Server.

• Se você quiser ajuda para garantir que seu aplicativo seja configurado, implantado e executado corretamente no IIS para que possa depurar, siga todas as etapas neste artigo.

Criar o aplicativo ASP.NET 4.8 no computador Visual Studio

1. Crie um novo aplicativo MVC ASP.NET.

   No Visual Studio, escolha Ficheiro>janela de Início para abrir a janela de Início e, em seguida, escolha Criar um novo projeto. Na caixa de pesquisa, digite asp.net frameworke escolha ASP.NET Aplicativo Web (.NET Framework). Na caixa de diálogo exibida, nomeie o projeto MyASPApp, escolha ASP.NET Framework 4.8e, em seguida, escolha Criar.

   Selecione MVC e escolha Criar.

2. Abra o arquivo HomeController.cs na pasta Controllers e defina um ponto de interrupção na instrução return View; no método Privacy.

   Em modelos mais antigos, abra o arquivo Privacy.cshtml.cs e defina um ponto de interrupção no método OnGet.

Instalar e configurar o IIS no Windows Server

Estas etapas mostram apenas uma configuração básica do IIS. Para obter informações mais detalhadas ou para instalar em uma máquina de área de trabalho Windows, consulte Publicação no IIS ou IIS 8.0 usando ASP.NET 3.5 e ASP.NET 4.5.

Para sistemas operativos Windows Server, utilize o assistente Adicionar Funções e Recursos através do link Gerir ou do link Painel no Gestor de Servidores. Na etapa , em Funções de Servidor, selecione a caixa de seleção para Servidor Web (IIS).

(Windows Server 2022) Na caixa de diálogo exibida, escolha Adicionar Recursos para adicionar o Console de Gerenciamento do IIS.

Na etapa Serviços de função, selecione os serviços de função do IIS desejados ou aceite os serviços de função padrão fornecidos. Se você quiser habilitar a implantação usando as configurações de publicação e a Implantação da Web, verifique se os seguintes recursos estão selecionados:

• Scripts e ferramentas de gestão do IIS
• Serviço de Gestão
• Console de Gerenciamento do IIS

Prossiga com as etapas de confirmação para instalar a função de servidor Web e os serviços. Uma reinicialização do servidor/IIS não é necessária após a instalação da função Servidor Web (IIS).

Atualizar as configurações de segurança do navegador no Windows Server

Se estiver a utilizar uma versão mais antiga do Windows Server, poderá ter de adicionar alguns domínios como sites fidedignos para lhe permitir transferir alguns dos componentes do servidor Web. Adicione os sites confiáveis acessando Opções da Internet > Segurança > Sites Confiáveis > Sites. Adicione os seguintes domínios.

• microsoft.com
• go.microsoft.com
• download.microsoft.com
• iis.net

Ao baixar o software, você pode receber solicitações para conceder permissão para carregar vários scripts e recursos de sites. Alguns desses recursos não são necessários, mas para simplificar o processo, selecione Adicionar quando solicitado.

Instalar o ASP.NET 4.8 no Windows Server

Se desejar obter informações mais detalhadas para instalar o ASP.NET no IIS, consulte IIS 8.0 usando o ASP.NET 3.5 e o ASP.NET 4.5.

Observação

O Web Platform Installer chegou ao fim da vida útil em 7/1/22. Para obter mais informações, consulte Web Platform Installer - Fim do suporte e descontinuação do feed de produtos/aplicações. Você pode instalar diretamente o ASP.NET 4.8 a partir do IIS.

1. No painel esquerdo do Gerenciador do Servidor, selecione IIS. Clique com o botão direito do mouse no servidor e selecione Adicionar funções e recursos.

2. No assistente, avance para a secção de Funcionalidades e instale o ASP.NET 4.8.

   

   Observação

   Se você estiver usando o Windows Server 2008 R2, instale o ASP.NET 4 usando este comando:

   C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

3. Reinicie o sistema (ou execute net stop was /y seguido por net start w3svc a partir de um prompt de comando para aplicar uma alteração ao PATH do sistema).

Escolha uma opção de implantação

Se precisar de ajuda para implantar o aplicativo no IIS, considere estas opções:

• Implante criando um arquivo de configurações de publicação no IIS e importando as configurações no Visual Studio. Em alguns cenários, essa é uma maneira rápida de implantar seu aplicativo. Quando você cria o arquivo de configurações de publicação, as permissões são configuradas automaticamente no IIS.

• Implante publicando em uma pasta local e copiando a saída por um método preferencial para uma pasta de aplicativo preparada no IIS.

(Opcional) Implantar usando um arquivo de configurações de publicação

Você pode usar essa opção para criar um arquivo de configurações de publicação e importá-lo para o Visual Studio.

Observação

Se desejar configurar o Web Deploy manualmente em vez de importar as configurações de publicação, será necessário certificar-se de que um diretório de aplicação no servidor esteja configurado com os valores e permissões corretos (consulte Configurar o sítio ASP.NET).

Instalar e configurar o Web Deploy no Windows Server

O Web Deploy fornece funcionalidades de configuração adicionais que permitem a criação do ficheiro de definições de publicação a partir da interface do utilizador.

Observação

O Web Platform Installer chegou ao fim da vida útil em 7/1/22. Para obter mais informações, consulte Web Platform Installer - Fim do suporte e descontinuação do feed de produtos/aplicações. Você pode instalar diretamente o Web Deploy 4.0 para criar o arquivo de configurações de publicação.

1. Se ainda não instalaste Scripts e Ferramentas de Gestão do IIS, instala-o agora.

   Vá para Selecione funções de servidor>Servidor Web (IIS)>Ferramentas de Gerenciamentoe, em seguida, selecione a função Scripts e Ferramentas de Gerenciamento do IIS, clique em Avançare instale a função.

   

   Os scripts e ferramentas são necessários para permitir a geração do arquivo de configurações de publicação.

   Certifique-se também de instalar o Serviço de Gerenciamento e o Console de Gerenciamento do IIS (eles podem já estar instalados).

2. No Windows Server, faça o download do Web Deploy 4.0.

3. Execute o programa de instalação do Web Deploy e certifique-se de selecionar a instalação completa em vez de uma instalação típica.

   Com uma instalação completa, você obtém os componentes necessários para gerar um arquivo de configurações de publicação. (Se você escolher personalizado, poderá ver a lista de componentes, conforme mostrado na ilustração a seguir.)

   

4. (Opcional) Verifique se a Implantação da Web está sendo executada corretamente abrindo os Serviços de Ferramentas > do Windows do Sistema e Segurança > do Painel de Controle >e verifique se:

   • O serviço do Serviço do Agente de Implantação da Web está em execução (o nome do serviço é diferente em versões mais antigas).

   • Serviço de Gestão da Web está em execução.

   Se um dos serviços do agente não estiver em execução, reinicie o Web Deployment Agent Service.

   Se o Serviço do Web Deployment Agent não estiver presente, vá para Painel de Controlo > Programas > Desinstalar um programa, localize Microsoft Web Deploy <versão>. Escolha Alterar a instalação e certifique-se de escolher que será instalado no disco rígido local para os componentes de implantação da Web. Conclua as etapas de instalação da alteração.

Criar o arquivo de configurações de publicação no IIS no Windows Server

1. Feche e reabra o Console de Gerenciamento do IIS para mostrar opções de configuração atualizadas na interface do usuário.

2. No IIS, clique com o botão direito do rato no Site Padrão, escolha Web Deploy>Configurar Publicação do Web Deploy.

   

   Se não vires o menu Deploy, consulta a secção anterior para verificar se o Web Deploy está em execução.

3. Na caixa de diálogo Configurar de Publicação de Implantação da Web, examine as configurações.

4. Clique em Configuração.

   No painel Resultados , a saída mostra que os direitos de acesso são concedidos ao usuário especificado e que um arquivo com uma .publishsettings extensão de arquivo foi gerado no local mostrado na caixa de diálogo.

   <?xml version="1.0" encoding="utf-8"?>
   <publishData>
     <publishProfile
       publishUrl="https://myhostname:8172/msdeploy.axd"
       msdeploySite="Default Web Site"
       destinationAppUrl="http://myhostname:80/"
       profileName="Default Settings"
       publishMethod="MSDeploy"
       userName="myhostname\myusername" />
   </publishData>
   

   Dependendo da configuração do Windows Server e do IIS, você verá valores diferentes no arquivo XML. Aqui estão alguns detalhes sobre os valores que você vê:

   • O ficheiro msdeploy.axd referenciado no atributo publishUrl é um ficheiro de manipulador HTTP gerado dinamicamente para o Web Deploy. (Para fins de teste, http://myhostname:8172 geralmente funciona também.)

   • A porta publishUrl é definida como porta 8172, que é o padrão para Web Deploy.

   • A porta destinationAppUrl é definida como porta 80, que é o padrão para o IIS.

   • Se, em etapas posteriores, você não conseguir se conectar ao host remoto do Visual Studio usando o nome do host, teste o endereço IP do servidor no lugar do nome do host.

     Observação

     Se você estiver publicando no IIS em execução em uma VM do Azure, deverá abrir uma porta de entrada para Implantação da Web e IIS no grupo Segurança de Rede. Para obter informações detalhadas, consulte Abrir portas para uma máquina virtual.

5. Copie este arquivo para o computador onde você está executando o Visual Studio.

Importar as configurações de publicação no Visual Studio e implantar

1. No computador onde você tem o projeto ASP.NET aberto no Visual Studio, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e escolha Publicar.

   Se você configurou anteriormente quaisquer perfis de publicação, o painel Publicar será exibido. Clique Novo ou Criar perfil novo.

2. Selecione a opção para importar um perfil.

   Na caixa de diálogo Publicar, clique em Importar Perfil.

   

3. Navegue até o local do arquivo de configurações de publicação que você criou na seção anterior.

4. Na caixa de diálogo Importar Arquivo de Configurações de Publicação, navegue para o perfil que criou na seção anterior, selecione-o e clique em Abrir.

   Clique Concluir para salvar o perfil de publicação e, em seguida, clique em Publicar.

   O Visual Studio inicia o processo de implantação e a janela Saída mostra o progresso e os resultados.

   Se você receber algum erro de implantação, clique em Mais ações>Editar para editar as configurações. Modifique as configurações e clique em Validar para testar novas configurações. Se o nome do host não for encontrado, tente o endereço IP em vez do nome do host nos campos URL do servidor e do destino .

   

Depois que o aplicativo for implantado com êxito, ele deve ser iniciado automaticamente. Se o aplicativo não iniciar após a implantação, inicie o aplicativo no IIS para verificar se ele é executado corretamente.

Quando estiver pronto, mude para uma configuração de depuração.

Importante

Se optar por depurar uma configuração de Release, desativará a depuração no arquivo web.config ao publicar.

1. Selecione Mais Opções>Editar para editar o perfil e, em seguida, selecione Configurações.
2. Selecione uma configuração de Depuração e, em seguida, selecione Remover arquivos adicionais no destino nas opções de Publicação de Arquivos.
3. Selecione Salvar e publique novamente o aplicativo.

Advertência

Usar credenciais de nome de usuário e senha (autenticação básica) não é o método mais seguro de autenticação. Sempre que possível, utilize métodos alternativos. Por exemplo, considere publicar em um pacote do Visual Studio e, em seguida, use WebDeploy.exe de uma linha de comando para implantar o pacote. Com este método, pode usar o Gestor de IIS para configurar utilizadores autorizados do Windows que podem publicar no servidor web e executar WebDeploy.exe sob essa conta de utilizador do Windows. Consulte Instalando e configurando a implantação da Web no IIS 8.0 ou posterior. Se você usar credenciais de senha, certifique-se de usar uma senha forte e proteja a senha de ser vazada ou compartilhada.

(Opcional) Implantar publicando em uma pasta local

Você pode usar essa opção para implantar seu aplicativo se quiser copiar o aplicativo para o IIS usando PowerShell, RoboCopy ou se quiser copiar manualmente os arquivos.

Configurar o site ASP.NET no computador Windows Server

1. Abra o Windows Explorer e crie uma nova pasta, C:\Publish, onde você implantará posteriormente o projeto ASP.NET.

2. Se ainda não estiver aberto, abra o Gerenciador dos Serviços de Informações da Internet (IIS). (No painel esquerdo do Gerenciador do Servidor, selecione IIS. Clique com o botão direito do mouse no servidor e selecione Gerenciador dos Serviços de Informações da Internet (IIS).)

3. No painel à esquerda, em Conexões, vá para Sites.

4. Selecione o Site Padrão, escolha Configurações Básicase defina o Caminho físico como C:\Publish.

5. Clique com o botão direito do mouse no nó Site Web Padrão e selecione Adicionar Aplicação.

6. Defina o campo Alias para MyASPApp, aceite o Pool de Aplicações padrão (DefaultAppPool) e defina o caminho físico para C:\Publish.

7. Em Connections, selecione Application Pools. Abra DefaultAppPool e defina o campo Pool de aplicativos como ASP.NET v4.0 (ASP.NET 4.5 não é uma opção para o pool de aplicativos).

8. Com o site selecionado no Gerenciador do IIS, escolha Editar Permissõese verifique se IUSR, IIS_IUSRS ou o usuário configurado para o Pool de Aplicativos é um usuário autorizado com direitos de Leitura & Execução.

   Se você não vir um desses usuários com acesso, siga as etapas para adicionar IUSR como um usuário com direitos de Leitura & Execução.

Importante

Para obter informações de segurança relacionadas às contas internas, consulte Noções básicas sobre Built-In contas de usuário e grupo no IIS 7.

Publicar e implantar o aplicativo publicando em uma pasta local do Visual Studio

Você também pode publicar e implantar o aplicativo usando o sistema de arquivos ou outras ferramentas.

Para ASP.NET 4.8, verifique se o arquivo web.config lista a versão correta do .NET.

• Se estiver a focar o ASP.NET 4.8, verifique se esse valor de versão está listado no ficheiro web.config.

      <system.web>
        <compilation debug="true" targetFramework="4.8" />
        <httpRuntime targetFramework="4.8" />
        <httpModules>
          <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
        </httpModules>
      </system.web>
      ```
  
  

• Se você instalar o ASP.NET 4 em vez de 4.8, o valor da versão deve ser especificado como 4.0 no arquivo web.config.

Siga estas etapas para publicar e implantar o aplicativo:

1. No Explorador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Publicar (para Web Forms, Publicar Aplicação Web).

   Se você configurou anteriormente quaisquer perfis de publicação, o painel Publicar será exibido. Clique em Novo perfil.

2. Na caixa de diálogo Publicar, selecione Pasta, clique em Procurare crie uma nova pasta C:\Publish.

   

   Clique Concluir para salvar o perfil de publicação.

3. Alterne para uma configuração de depuração.

   Escolha Editar para alterar o perfil e, em seguida, escolha Configurações. Escolha uma configuração de de depuração de e, em seguida, escolha Remover arquivos adicionais no de destino nas opções de de publicação de arquivo.

   

   Observação

   Se utilizar um build de Release, desativa a depuração no ficheiro web.config ao publicar.

4. Clique Publicar.

   A aplicação publica uma configuração Debug do projeto na pasta local. O progresso é exibido na janela Saída.

5. Copie o diretório ASP.NET do projeto do computador Visual Studio para o diretório local configurado para o aplicativo ASP.NET (neste exemplo, C:\Publish) no computador Windows Server. Neste tutorial, assumimos que você está copiando manualmente, mas pode usar outras ferramentas como PowerShell, Xcopy ou Robocopy.

   Atenção

   Se precisar fazer alterações no código ou reconstruir, publique novamente e repita esta etapa. O executável copiado para a máquina remota deve corresponder exatamente à origem e aos símbolos locais. Se você não fizer isso, você receberá um aviso de cannot find or open the PDB file no Visual Studio quando você tentar depurar o processo.

6. No Windows Server, verifique se você pode executar o aplicativo corretamente abrindo o aplicativo em seu navegador.

   Se o aplicativo não for executado corretamente, pode haver uma incompatibilidade entre a versão do ASP.NET instalada no servidor e na máquina do Visual Studio ou você pode ter um problema com a configuração do IIS ou do site. Verifique novamente as etapas anteriores.

Baixe e instale as ferramentas remotas no Windows Server

Baixe a versão das ferramentas remotas que corresponde à sua versão do Visual Studio.

No dispositivo remoto ou servidor em que você deseja depurar, em vez da máquina do Visual Studio, baixe e instale a versão correta das ferramentas remotas a partir dos links na tabela a seguir.

• Baixe a atualização mais recente das ferramentas remotas para sua versão do Visual Studio. As ferramentas remotas para Visual Studio 2022 e 2026 podem ser usadas com qualquer versão do Visual Studio. No entanto, as versões de ferramentas remotas anteriores ao Visual Studio 2022 não são compatíveis com versões posteriores do Visual Studio. (Por exemplo, se você estiver usando o Visual Studio 2019, baixe a atualização mais recente das ferramentas remotas para o Visual Studio 2019. Nesse cenário, não baixe as ferramentas remotas para o Visual Studio 2022.)

• Transfira as ferramentas remotas que têm a mesma arquitetura da máquina em que as vai instalar. Por exemplo, se você quiser depurar aplicativos x86 em um computador remoto executando um sistema operacional x64, instale as ferramentas remotas x64. Para depurar aplicativos x86, ARM ou x64 em um sistema operacional ARM64, instale as ferramentas remotas ARM64.

Versão	Ligação	Observações
Visual Studio 2022	Ferramentas remotas	Compatível com todas as versões do Visual Studio 2022. Descarregue a versão correspondente ao sistema operativo do seu dispositivo (x86, x64 (AMD64), ou ARM64). Em versões mais antigas do Windows Server, consulte Desbloquear o download de arquivos para obter ajuda com o download das ferramentas remotas.
Visual Studio 2019	Ferramentas remotas	Ferramentas remotas para Visual Studio 2019 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. Descarregue a versão correspondente ao sistema operativo do seu dispositivo (x86, x64 (AMD64), ou ARM64). Em versões mais antigas do Windows Server, consulte Desbloquear o download de arquivos para obter ajuda com o download das ferramentas remotas.
Visual Studio 2017	Ferramentas remotas	Ferramentas remotas para Visual Studio 2017 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. Descarregue a versão correspondente ao sistema operativo do seu dispositivo (x86, x64 (AMD64), ou ARM64). Em Windows Server, consulte Desbloquear o download do ficheiro para obter ajuda com o download das ferramentas remotas.
2015 Visual Studio	Ferramentas remotas	Ferramentas remotas para Visual Studio 2015 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. Em Windows Server, consulte Desbloquear o download do ficheiro para obter ajuda com o download das ferramentas remotas.
Visual Studio 2013	Ferramentas remotas	Página de download na documentação do Visual Studio 2013
Visual Studio 2012	Ferramentas remotas	Página de download na documentação do Visual Studio 2012

Você pode executar o depurador remoto copiando msvsmon.exe para o computador remoto, em vez de instalar as ferramentas remotas. No entanto, o Assistente de Configuração do Depurador Remoto (rdbgwiz.exe) está disponível somente quando você instala as ferramentas remotas. Talvez seja necessário usar o assistente de configuração se pretender executar o depurador remoto como um serviço. Para obter mais informações, consulte (opcional) Configurar o depurador remoto como um serviço.

Observação

• Para depurar aplicativos do Windows 10 ou posteriores em dispositivos ARM, use o ARM64, que está disponível com a versão mais recente das ferramentas remotas.
• Para depurar aplicativos do Windows 10 em dispositivos Windows RT, utilize a arquitetura ARM, que está disponível apenas no download da ferramenta remota do Visual Studio 2015.
• Para depurar aplicativos x64 em um sistema operacional ARM64, execute o msvsmon.exe x64 instalado com as ferramentas remotas ARM64.

Configurar o depurador remoto no Windows Server

1. No computador remoto, localize e inicie o do Depurador Remoto no menu Iniciar.

   Se não tiver permissões administrativas no computador remoto, clique com o botão direito do rato na aplicação Depurador Remoto e selecione Executar como administrador . Caso contrário, basta iniciá-lo normalmente.

   Se estiver a planear anexar-se a um processo que está a ser executado como administrador, ou que está a ser executado numa conta de utilizador diferente (como o IIS), clique com o botão direito do Depurador Remoto e selecione Executar como administrador. Para obter mais informações, consulte Executar o depurador remoto como administrador.

2. Na primeira vez que iniciar o depurador remoto (ou antes de o configurar), o assistente de Configuração de Depuração Remota aparece.

   Na maioria dos cenários, escolha Avançar até chegar à página Configurar o Firewall do Windows do assistente.

   pt-PT:

3. Selecione pelo menos um tipo de rede no qual você deseja usar as ferramentas remotas. Se os computadores estiverem conectados através de um domínio, você deverá escolher o primeiro item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou grupo doméstico, escolha o segundo ou terceiro item conforme apropriado.

   Em seguida, escolha Finalizar para iniciar o depurador remoto.

4. Quando a configuração estiver concluída, a janela Remote Debugger será exibida.

   

   O depurador remoto está agora à espera de uma ligação. Use o nome do servidor e o número da porta mostrados para definir a configuração de conexão remota no Visual Studio.

Para parar o depurador remoto, selecione Arquivo>Sair. Você pode reiniciá-lo a partir do menu Iniciar ou da linha de comando:

<Remote debugger installation directory>\msvsmon.exe

Observação

Se você precisar adicionar permissões para usuários adicionais, alterar o modo de autenticação ou o número da porta para o depurador remoto, consulte Configurar o depurador remoto.

Para obter informações sobre como executar o depurador remoto como um serviço, consulte executar o depurador remoto como um serviço.

Anexar ao aplicativo ASP.NET a partir do computador Visual Studio

A partir do Visual Studio 2022 versão 17.10 Preview 2, a caixa de diálogo Anexar ao Processo foi alterada. Se você precisar de instruções que correspondam à caixa de diálogo mais antiga, alterne para o modo de exibição Visual Studio 2019 (seletor de versão no canto superior esquerdo no artigo).

1. No computador do Visual Studio, abra a solução que você está tentando depurar (MyASPApp se você estiver seguindo todas as etapas neste artigo).

2. No Visual Studio, selecione Depurar > Anexar ao Processo (Ctrl + Alt + P).

   Dica

   No Visual Studio 2017 e versões posteriores, você pode reanexar ao mesmo processo anexado anteriormente usando Debug > Reattach to Process... (Shift + Alt + P).

3. Defina o Tipo de Conexão como Remoto (Windows).

   A opção Connection Target é exibida.

   Defina o Destino da Conexão para o nome do computador remoto <> e pressione Enter.

   Verifique se o Visual Studio adiciona a porta necessária ao nome do computador, que aparece no formato: <nome do computador remoto>:porta

   No Visual Studio 2022, você deve ver <nome do computador remoto>:4026

   A porta de rede é necessária. Se não vir o número da porta, adicione-o manualmente.

4. Selecione Atualizar.

   Você verá alguns processos aparecerem na janela Processos Disponíveis.

   Se você não vir nenhum processo, tente usar o endereço IP em vez do nome do computador remoto (a porta é necessária). Você pode usar ipconfig em uma linha de comando para obter o endereço IPv4.

   Se você quiser usar o botão Localizar, talvez seja necessário porta UDP de saída 3702 no servidor.

5. Selecione Mostrar processos de todos os utilizadores.

6. Digite a primeira letra do nome de um processo para encontrar rapidamente w3wp.exe para ASP.NET 4.5.

   Se você tiver vários processos mostrando w3wp.exe, verifique a coluna Nome de usuário. Em alguns cenários, a coluna Nome de Usuário mostra o nome do pool de aplicativos, como IIS APPPOOL\DefaultAppPool. Se você vir o Pool de Aplicativos, uma maneira fácil de identificar o processo correto é criar um novo Pool de Aplicativos nomeado para a instância do aplicativo que você deseja depurar e, em seguida, poderá encontrá-lo facilmente na coluna Nome de Usuário.

   

7. Selecione Anexar.

8. Abra o site do computador remoto. Em um navegador, vá para http://<nome do computador remoto>.

   Deverá ver a página ASP.NET na web.

9. No aplicativo ASP.NET em execução, selecione o link para a página Privacy.

   O ponto de interrupção deve ser atingido no Visual Studio.

   Se não conseguir ligar ou atingir o ponto de interrupção, consulte Resolução de problemas de depuração remota.

Solução de problemas de implantação do IIS

• Se você não conseguir se conectar ao host usando o nome do host, tente o endereço IP.
• Verifique se as portas necessárias estão abertas no servidor remoto.
• Verifique se a versão do ASP.NET usado em seu aplicativo é a mesma que você instalou no servidor. Para a sua aplicação, pode visualizar e definir a versão na página Propriedades do . Para definir o aplicativo para uma versão diferente, essa versão deve ser instalada.
• Se o aplicativo tentou abrir, mas você vê um aviso de certificado, escolha confiar no site. Se você já fechou o aviso, você pode editar o perfil de publicação, um arquivo *.pubxml, em seu projeto e adicionar o seguinte elemento (apenas para teste): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Depois de implantado, inicie o aplicativo no IIS para testar se ele foi implantado corretamente.
• Verifique a janela Saída no Visual Studio para obter informações de estado e verifique as suas mensagens de erro.

Abrir portas necessárias no Windows Server

Na maioria das configurações, as portas necessárias são abertas pela instalação do ASP.NET e do depurador remoto. No entanto, talvez seja necessário verificar se as portas estão abertas.

Observação

Em uma VM do Azure, você deve abrir portas por meio do grupo de segurança Rede .

Portas necessárias:

• 80: Necessário para o IIS.

• 4026: Necessário para depuração remota do Visual Studio 2022 (consulte Remote Debugger Port Assignments para obter mais informações).

• 4024: Necessário para depuração remota do Visual Studio 2019 (consulte as Atribuições de Porta do Depurador Remoto para mais informações).

• UDP 3702: (Opcional) A porta de descoberta permite aceder ao botão Localizar ao anexar ao depurador remoto no Visual Studio.

Além disso, essas portas já devem ser abertas pela instalação ASP.NET:

• 8172: (Opcional) Necessário para o Web Deploy implantar a aplicação a partir do Visual Studio.

Abrir uma porta

1. Para abrir uma porta no Windows Server, abra o menu Iniciar, pesquise por Firewall do Windows Defender ou Firewall do Windows com Segurança Avançada.

   Para do Firewall do Windows Defender, escolha Configurações avançadas.

2. Em seguida, escolha Regras de Entrada > Nova Regra > Porta. Escolha Seguinte e, em Portas locais específicas, introduza o número da porta, selecione Seguinte, Permitir a ligação, selecione Seguinte, e adicione o nome (IIS, Web Deployou msvsmon) para a Regra de Entrada.

   Se quiser obter mais detalhes sobre como configurar o Firewall do Windows, consulte Configurar o Firewall do Windows para Depuração Remota.

3. Crie mais regras para as outras portas necessárias.