Eseguire il debug remoto di ASP.NET su un computer IIS remoto

Per eseguire il debug di un'applicazione ASP.NET distribuita in IIS, installare ed eseguire gli strumenti remoti nel computer in cui è stata distribuita l'app e quindi connettersi all'app in esecuzione da Visual Studio.

Questa guida illustra come configurare e configurare un'applicazione di Visual Studio ASP.NET MVC 4.8, distribuirla in IIS e collegare il debugger remoto da Visual Studio.

Nota

Per eseguire il debug remoto ASP.NET Core, vedere invece Remote Debug ASP.NET Core in un computer IIS. Per il Servizio App di Azure, vedere Debug remoto ASP.NET Core in Azure o, per Visual Studio Enterprise, usare lo Snapshot Debugger () (.NET 4.6.1 richiesto).

Prerequisiti

Visual Studio 2019 o una versione successiva è necessario per seguire i passaggi illustrati in questo articolo.

Queste procedure sono state testate in queste configurazioni del server:

• Windows Server 2022 e IIS 10
• Windows Server 2012 R2 e IIS 8 (per Windows Server 2008 R2, i passaggi del server sono diversi)

Requisiti di rete

Il debugger remoto è supportato in Windows Server a partire da Windows Server 2008 Service Pack 2. Per un elenco completo dei requisiti, vedere requisiti .

Nota

Il debug tra due computer connessi tramite un proxy non è supportato. Il debug su una connessione a latenza elevata o a larghezza di banda ridotta, ad esempio connessione Internet remota o su Internet tra paesi/aree geografiche non è consigliato e potrebbe non riuscire o essere inaccettabile lento.

App già in esecuzione in IIS?

Questo articolo include i passaggi per configurare una configurazione di base di IIS in Windows Server e la distribuzione dell'app da Visual Studio. Questi passaggi sono inclusi per assicurarsi che il server abbia componenti necessari installati, che l'app possa essere eseguita correttamente e che si sia pronti per il debug remoto.

• Se l'app è in esecuzione in IIS e si vuole solo scaricare il debugger remoto e avviare il debug, passare a Scaricare e installare gli strumenti remoti in Windows Server.

• Se si vuole assistenza per assicurarsi che l'app sia configurata, distribuita e in esecuzione correttamente in IIS in modo da poter eseguire il debug, seguire tutti i passaggi descritti in questo articolo.

Creare l'applicazione ASP.NET 4.8 nel computer di Visual Studio

1. Creare una nuova applicazione ASP.NET MVC.

   In Visual Studio scegliere finestra File>finestra Start per aprire la finestra Start e quindi scegliere Crea un nuovo progetto. Nella casella di ricerca digitare asp.net frameworke quindi scegliere Applicazione Web ASP.NET (.NET Framework). Nella finestra di dialogo visualizzata assegnare al progetto il nome MyASPApp, scegliere ASP.NET Framework 4.8e quindi scegliere Crea.

   Selezionare MVC e scegliere Crea.

2. Aprire il file HomeController.cs nella cartella Controllers e impostare un punto di interruzione nell'istruzione return View; nel metodo Privacy.

   Nei modelli precedenti aprire il file Privacy.cshtml.cs e impostare un punto di interruzione nel metodo OnGet.

Installare e configurare IIS in Windows Server

Questi passaggi mostrano solo una configurazione di base di IIS. Per informazioni più approfondite o per l'installazione in un computer Desktop di Windows, vedere Pubblicazione in IIS o IIS 8.0 Tramite ASP.NET 3.5 e ASP.NET 4.5.

Per i sistemi operativi Windows Server, usare la procedura guidata Aggiungi ruoli e funzionalità tramite il collegamento Gestisci o il collegamento Dashboard in Server Manager. Nel passaggio Ruoli del Server, selezionare la casella per Server Web (IIS).

(Windows Server 2022) Nella finestra di dialogo visualizzata scegliere Aggiungi funzionalità per aggiungere la Console di gestione IIS.

Al passaggio Servizi ruolo, seleziona i servizi ruolo IIS che desideri o accetta i servizi ruolo predefiniti forniti dal sistema. Se si vuole abilitare la distribuzione usando le impostazioni di pubblicazione e distribuzione Web, assicurarsi che siano selezionate le funzionalità seguenti:

• Strumenti e Script di Gestione IIS
• Servizio di gestione
• Console di gestione di IIS

Procedere con i passaggi di conferma per installare il ruolo e i servizi del server Web. Un riavvio server/IIS non è necessario dopo l'installazione del ruolo Server Web (IIS).

Aggiornare le impostazioni di sicurezza del browser in Windows Server

Se si usa una versione precedente di Windows Server, potrebbe essere necessario aggiungere alcuni domini come siti attendibili per consentire di scaricare alcuni componenti del server Web. Aggiungere i Siti attendibili passando a Opzioni Internet > Sicurezza > Siti attendibili > Siti. Aggiungere i domini seguenti.

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

Quando si scarica il software, è possibile che vengano richieste di concedere l'autorizzazione per caricare vari script e risorse del sito Web. Alcune di queste risorse non sono necessarie, ma per semplificare il processo, selezionare Aggiungi quando richiesto.

Installare ASP.NET 4.8 in Windows Server

Per informazioni più dettagliate sull'installazione di ASP.NET in IIS, vedere IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

Nota

Il programma di installazione della piattaforma Web ha raggiunto la fine del supporto il 7/1/22. Per altre informazioni, vedere Programma di installazione della piattaforma Web - Fine del supporto e chiusura del feed di prodotti/applicazioni. È possibile installare direttamente ASP.NET 4.8 da IIS.

1. Nel riquadro sinistro di Server Manager selezionare IIS. Fare clic con il pulsante destro del mouse sul server e selezionare Aggiungi ruoli e funzionalità.

2. Nella procedura guidata, avanzare alla sezione funzionalità e installare ASP.NET 4.8.

   

   Nota

   Se si usa Windows Server 2008 R2, installare ASP.NET 4 usando questo comando:

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

3. Riavviare il sistema oppure eseguire net stop was /y seguito da net start w3svc da un prompt dei comandi per applicare una modifica al percorso di sistema.

Scegliere un'opzione di distribuzione

Se è necessaria assistenza per la distribuzione dell'app in IIS, prendere in considerazione queste opzioni:

• Eseguire la distribuzione creando un file di impostazioni di pubblicazione in IIS e importando le impostazioni in Visual Studio. In alcuni scenari, si tratta di un modo rapido per distribuire l'app. Quando si crea il file delle impostazioni di pubblicazione, le autorizzazioni vengono configurate automaticamente in IIS.

• Distribuire pubblicando in una cartella locale e copiando l'output utilizzando un metodo preferito in una cartella dell'app preparata su IIS.

(Facoltativo) Eseguire la distribuzione usando un file di impostazioni di pubblicazione

È possibile usare questa opzione per creare un file di impostazioni di pubblicazione e importarlo in Visual Studio.

Nota

Se si vuole configurare distribuzione Web manualmente anziché importare le impostazioni di pubblicazione, è necessario assicurarsi che una cartella dell'app nel server sia configurata con i valori e le autorizzazioni corretti (vedere Configurare ASP.NET sito Web).

Installare e configurare distribuzione Web in Windows Server

Web Deploy offre funzionalità di configurazione aggiuntive che consentono la creazione del file delle impostazioni di pubblicazione dall'interfaccia utente.

Nota

Il programma di installazione della piattaforma Web ha raggiunto la fine della vita il 7/1/22. Per altre informazioni, vedere Programma di installazione della piattaforma Web - Fine del supporto e chiusura del feed di prodotti/applicazioni. È possibile installare direttamente Distribuzione Web 4.0 per creare il file delle impostazioni di pubblicazione.

1. Se non è già stato installato IIS Management Scripts and Tools, installarlo ora.

   Passare a Selezionare i ruoli del server>Server Web (IIS)>Strumenti di gestione, quindi selezionare il ruolo script e strumenti di gestione IIS, fare clic su Avantie quindi installare il ruolo.

   

   Gli script e gli strumenti sono necessari per abilitare la generazione del file delle impostazioni di pubblicazione.

   Assicurarsi di installare anche il servizio di gestione e la Console di gestione IIS (potrebbero essere già installati).

2. Su Windows Server scaricare Web Deploy 4.0.

3. Eseguire il programma di installazione di Web Deploy e assicurarsi di selezionare l'installazione completa anziché un'installazione tipica.

   Con un'installazione completa, si ottengono i componenti necessari per generare un file di impostazioni di pubblicazione. Se si sceglie personalizzato, è possibile visualizzare l'elenco dei componenti, come illustrato nella figura seguente.

   

4. (Facoltativo) Verificare che Distribuzione Web sia in esecuzione correttamente aprendo Pannello di controllo > Sistema e sicurezza > Strumenti di amministrazione > Servicese quindi assicurarsi che:

   • servizio agente di distribuzione Web è in esecuzione (il nome del servizio è diverso nelle versioni precedenti).

   • Web Management Service è in esecuzione.

   Se uno dei servizi dell'agente non è in esecuzione, riavviare il servizio agente di distribuzione Web .

   Se il servizio agente di distribuzione Web non è presente, vai a Pannello di controllo > Programmi > Disinstalla un programma, trova Microsoft Web Deploy <versione>. Scegliere di Modificare l'installazione e assicurarsi di scegliere Verrà installato nel disco rigido locale per i componenti di Web Deploy. Completare i passaggi di installazione delle modifiche.

Creare il file delle impostazioni di pubblicazione in IIS in Windows Server

1. Chiudere e riaprire la Console di gestione IIS per visualizzare le opzioni di configurazione aggiornate nell'interfaccia utente.

2. In IIS, fare clic con il pulsante destro del mouse su sito Web predefinito, scegliere Deploy>Configura Publicazione Web Deploy.

   

   Se non viene visualizzato il menu Distribuisci, vedere la sezione precedente per verificare che Web Deploy sia in esecuzione.

3. Nella finestra di dialogo Configura pubblicazione di Distribuzione Web, esaminare le impostazioni.

4. Fare clic su Setup.

   Nel pannello Risultati l'output mostra che i diritti di accesso vengono concessi all'utente specificato e che un file con estensione .publishsettings è stato generato nel percorso visualizzato nella finestra di dialogo.

   <?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>
   

   A seconda della configurazione di Windows Server e IIS, nel file XML vengono visualizzati valori diversi. Ecco alcuni dettagli sui valori visualizzati:

   • Il file msdeploy.axd a cui si fa riferimento nell'attributo publishUrl è un file del gestore HTTP generato dinamicamente per distribuzione Web. (A scopo di test, http://myhostname:8172 funziona anche in genere.)

   • La porta publishUrl è impostata sulla porta 8172, ovvero l'impostazione predefinita per Distribuzione Web.

   • La porta destinationAppUrl è impostata sulla porta 80, ovvero l'impostazione predefinita per IIS.

   • Se, nei passaggi successivi, non è possibile connettersi all'host remoto da Visual Studio usando il nome host, testare l'indirizzo IP del server al posto del nome host.

     Nota

     Se si esegue la pubblicazione in IIS in una macchina virtuale di Azure, è necessario aprire una porta in ingresso per Distribuzione Web e IIS nel gruppo Sicurezza di rete. Per informazioni dettagliate, vedere Aprire le porte a una macchina virtuale.

5. Copiare questo file nel computer in cui si esegue Visual Studio.

Importare le impostazioni di pubblicazione in Visual Studio e distribuire

1. Nel computer in cui è aperto il progetto ASP.NET in Visual Studio fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Pubblica.

   Se in precedenza sono stati configurati profili di pubblicazione, viene visualizzato il riquadro Pubblica. Fare clic su Nuovo o Crea nuovo profilo.

2. Selezionare l'opzione per importare un profilo.

   Nella finestra di dialogo Pubblica, fare clic su Importa profilo.

   

3. Passare al percorso del file delle impostazioni di pubblicazione creato nella sezione precedente.

4. Nella finestra di dialogo Importa file di impostazioni di pubblicazione passare a e selezionare il profilo creato nella sezione precedente e fare clic su Apri.

   Fare clic su Fine per salvare il profilo di pubblicazione e quindi su Pubblica.

   Visual Studio avvia il processo di distribuzione e la finestra Output mostra lo stato di avanzamento e i risultati.

   Se si verificano errori di distribuzione, fare clic su Altre azioni>Modifica per modificare le impostazioni. Modificare le impostazioni e fare clic su Convalida per testare le nuove impostazioni. Se il nome host non viene trovato, provare l'indirizzo IP anziché il nome host nei campi server e url di destinazione .

   

Dopo che l'app viene distribuita correttamente, dovrebbe essere avviata automaticamente. Se l'app non viene avviata dopo la distribuzione, avviare l'app in IIS per verificare che venga eseguita correttamente.

Quando si è pronti, passare a una configurazione di debug.

Importante

Se si sceglie di eseguire il debug di una configurazione di versione, si disabilita il debug nel file web.config durante la pubblicazione.

1. Selezionare Altre opzioni>Modifica per modificare il profilo e quindi selezionare Impostazioni.
2. Selezionare una configurazione debug e quindi selezionare Rimuovi file aggiuntivi nella di destinazione nelle opzioni Pubblicazione file.
3. Selezionare Salva e quindi ripubblicare l'app.

Avvertimento

L'uso di credenziali di nome utente e password (autenticazione di base) non è il metodo di autenticazione più sicuro. Quando possibile, usare metodi alternativi. Si consideri ad esempio la pubblicazione in un pacchetto da Visual Studio e quindi usare WebDeploy.exe da una riga di comando per distribuire il pacchetto. Con questo metodo, è possibile usare Gestione IIS per configurare gli utenti windows autorizzati che possono pubblicare nel server Web ed eseguire WebDeploy.exe con tale account utente di Windows. Vedere Installazione e configurazione della distribuzione Web in IIS 8.0 o versioni successive. Se utilizzi le credenziali della password, assicurati di usare una password complessa e proteggere la password da perdite o condivisioni.

(Facoltativo) Eseguire la distribuzione pubblicando in una cartella locale

È possibile usare questa opzione per distribuire l'app se si vuole copiare l'app in IIS usando PowerShell, RoboCopy o si desidera copiare manualmente i file.

Configurare il sito Web ASP.NET nel computer Windows Server

1. Apri Esplora File e crea una nuova cartella, C:\Pubblica, dove distribuirai successivamente il progetto ASP.NET.

2. Se non è già aperto, apri il Gestore di Internet Information Services (IIS). Nel riquadro sinistro di Server Manager selezionare IIS. Fare clic con il pulsante destro del mouse sul server e selezionare Gestione di Servizi di Informazione Internet (IIS).)

3. In Connessioni nel riquadro sinistro, vai a Siti.

4. Selezionare sito Web predefinito, scegliere Impostazioni di basee impostare il percorso fisico su C:\Publish.

5. Fare clic con il pulsante destro del mouse sul nodo sito Web predefinito e selezionare Aggiungi applicazione.

6. Impostare il campo Alias su MyASPApp, accettare il pool di applicazioni predefinito (DefaultAppPool) e impostare il percorso fisico su C:\Publish.

7. In Connessioniselezionare pool di applicazioni . Aprire DefaultAppPool e impostare il campo Pool di applicazioni su ASP.NET v4.0 (ASP.NET 4.5 non è un'opzione per il pool di applicazioni).

8. Con il sito selezionato in Gestione IIS, scegliere Modifica autorizzazionie assicurarsi che IUSR, IIS_IUSRS o che l'utente configurato per il pool di applicazioni sia un utente autorizzato con diritti Lettura & Esecuzione.

   Se uno di questi utenti non viene visualizzato con accesso, seguire la procedura per aggiungere IUSR come utente con diritti di lettura & Esecuzione.

Importante

Per informazioni sulla sicurezza correlate agli account predefiniti, vedere Understanding Built-In User and Group Accounts in IIS 7.

Pubblicare e distribuire l'app pubblicando in una cartella locale da Visual Studio

È anche possibile pubblicare e distribuire l'app usando il file system o altri strumenti.

Per ASP.NET 4.8, assicurarsi che nel file web.config sia elencata la versione corretta di .NET.

• Se la destinazione è ASP.NET 4.8, assicurarsi che questo valore di versione sia elencato nel file 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 si installa ASP.NET 4 anziché 4.8, il valore della versione deve essere specificato come 4.0 nel file web.config.

Seguire questa procedura per pubblicare e distribuire l'app:

1. In Esplora soluzioni , clic destro sul nodo del progetto e seleziona Pubblica (per Web Forms, Pubblica applicazione Web).

   Se in precedenza sono stati configurati profili di pubblicazione, viene visualizzato il riquadro Pubblica. Fare clic su Nuovo profilo.

2. Nella finestra di dialogo Pubblica, selezionare Cartella, fare clic su Sfogliae creare una nuova cartella C:\Pubblica.

   

   Fare clic su Fine per salvare il profilo di pubblicazione.

3. Passare a una configurazione di debug.

   Scegliere Modifica per modificare il profilo e quindi scegliere Impostazioni. Scegliere una configurazione di Debug e quindi scegliere Rimuovi file aggiuntivi nella destinazione, nelle opzioni di Pubblicazione file.

   

   Nota

   Se si usa una build di rilascio, si disabilita il debug nel file web.config durante la pubblicazione.

4. Fare clic su Pubblica.

   L'applicazione pubblica una configurazione Debug del progetto nella cartella locale. Lo stato di avanzamento viene visualizzato nella finestra Output.

5. Copiare la directory del progetto ASP.NET dal computer Visual Studio nella directory locale configurata per l'app ASP.NET (in questo esempio C:\Publish) nel computer Windows Server. In questa esercitazione si presuppone che si stia copiando manualmente, ma è possibile usare altri strumenti come PowerShell, Xcopy o Robocopy.

   Cautela

   Se è necessario apportare modifiche al codice o alla ricompilazione, è necessario ripubblicare e ripetere questo passaggio. Il file eseguibile copiato nel computer remoto deve corrispondere esattamente all'origine locale e ai simboli. Se non si esegue questa operazione, verrà visualizzato un avviso cannot find or open the PDB file in Visual Studio quando si tenta di eseguire il debug del processo.

6. In Windows Server verificare che sia possibile eseguire correttamente l'app aprendo l'app nel browser.

   Se l'app non viene eseguita correttamente, potrebbe verificarsi una mancata corrispondenza tra la versione di ASP.NET installata nel server e il computer di Visual Studio oppure potrebbe verificarsi un problema con la configurazione del sito Web o IIS. Ricontrollare i passaggi precedenti.

Scaricare e installare gli strumenti remoti in Windows Server

Scaricare la versione degli strumenti remoti che corrisponde alla versione di Visual Studio.

Nel dispositivo remoto o nel server in cui si vuole eseguire il debug, anziché nel computer di Visual Studio, scaricare e installare la versione corretta degli strumenti remoti dai collegamenti nella tabella seguente.

• Scaricare l'aggiornamento più recente degli strumenti remoti per la versione di Visual Studio. Le versioni precedenti degli strumenti remoti non sono compatibili con le versioni successive di Visual Studio. Ad esempio, se si usa Visual Studio 2019, scaricare l'aggiornamento più recente degli strumenti remoti per Visual Studio 2019. In questo scenario non scaricare gli strumenti remoti per Visual Studio 2022.
• Scaricare gli strumenti remoti con la stessa architettura del computer in cui si stanno installando. Ad esempio, se si vuole eseguire il debug di applicazioni x86 in un computer remoto che esegue un sistema operativo x64, installare gli strumenti remoti x64. Per eseguire il debug di applicazioni x86, ARM o x64 in un sistema operativo ARM64, installare gli strumenti remoti ARM64.

Versione	Collegamento	Note
Visual Studio 2022	Strumenti remoti	Compatibile con tutte le versioni di Visual Studio 2022. Scaricare la versione corrispondente al sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. Nelle versioni precedenti di Windows Server, vedere sbloccare il download del file per informazioni sul download degli strumenti remoti.
Visual Studio 2019	Strumenti remoti	Gli strumenti remoti per Visual Studio 2019 sono disponibili da My.VisualStudio.com. Se richiesto, partecipa al programma gratuito di Visual Studio Dev Essentials oppure accedi con l'ID della sottoscrizione di Visual Studio. Scaricare la versione corrispondente al sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. Nelle versioni precedenti di Windows Server, consultare Sbloccare il download del file per assistenza con il download degli strumenti remoti.
Visual Studio 2017	Strumenti remoti	Gli strumenti remoti per Visual Studio 2017 sono disponibili da My.VisualStudio.com. Se richiesto, partecipate al programma gratuito di Visual Studio Dev Essentials oppure accedete con l'ID di sottoscrizione di Visual Studio. Scaricare la versione corrispondente al sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. Su Windows Server, consulta Come sbloccare il download del file per assistenza sul download degli strumenti remoti.
Visual Studio 2015	Strumenti remoti	Gli strumenti remoti per Visual Studio 2015 sono disponibili da My.VisualStudio.com. Se richiesto, partecipa al programma gratuito Visual Studio Dev Essentials oppure accedi con l'ID della sottoscrizione di Visual Studio. In Windows Server, vedi Sbloccare il download del file per informazioni sul download degli strumenti remoti.
Visual Studio 2013	Strumenti remoti	Pagina di download nella documentazione di Visual Studio 2013
Visual Studio 2012	Strumenti remoti	Pagina di download nella documentazione di Visual Studio 2012

È possibile eseguire il debugger remoto copiando msvsmon.exe nel computer remoto, anziché installando gli strumenti remoti. Tuttavia, la procedura guidata di configurazione del debugger remoto (rdbgwiz.exe) è disponibile solo quando si installano gli strumenti remoti. Potrebbe essere necessario usare la procedura guidata per la configurazione se si vuole eseguire il debugger remoto come servizio. Per altre informazioni, vedere (facoltativo) Configurare il debugger remoto come servizio.

Nota

• Per eseguire il debug di app di Windows 10 o versioni successive nei dispositivi ARM, usare ARM64, disponibile con la versione più recente degli strumenti remoti.
• Per eseguire il debug delle app di Windows 10 nei dispositivi Windows RT, usare ARM, disponibile solo nel download degli strumenti remoti di Visual Studio 2015.
• Per eseguire il debug di app x64 in un sistema operativo ARM64, eseguire il msvsmon.exe x64 installato con gli strumenti remoti ARM64.

Configurare il debugger remoto in Windows Server

1. Nel computer remoto, individuare e avviare il debugger remoto dal menu Start.

   Se non si dispone di autorizzazioni amministrative sul computer remoto, fare clic con il pulsante destro del mouse sull'app Debugger Remoto e selezionare Esegui come amministratore. In caso contrario, inizialo normalmente.

   Se si prevede di connettersi a un processo in esecuzione come amministratore o in esecuzione con un account utente diverso, ad esempio IIS, fare clic con il pulsante destro del mouse sull'app Debugger remoto e selezionare Esegui come amministratore. Per ulteriori informazioni, vedere eseguire il debugger remoto come amministratore.

2. La prima volta che si avvia il debugger remoto (o prima di averla configurata), viene visualizzata la configurazione di debug remoto procedura guidata.

   Nella maggior parte degli scenari scegliere Avanti finché non si arriva alla pagina Configura windows Firewall della procedura guidata.

   

3. Selezionare almeno un tipo di rete su cui si vogliono usare gli strumenti remoti. Se i computer sono connessi tramite un dominio, è necessario scegliere il primo elemento. Se i computer sono connessi tramite un gruppo di lavoro o un gruppo home, scegliere il secondo o il terzo elemento in base alle esigenze.

   Selezionare quindi Fine per avviare il debugger remoto.

4. Al termine della configurazione, viene visualizzata la finestra Debugger Remoto.

   

   Il debugger remoto è ora in attesa di una connessione. Usare il nome del server e il numero di porta visualizzati per impostare la configurazione della connessione remota in Visual Studio.

Per arrestare il debugger remoto, seleziona File>Esci. È possibile riavviarlo dal menu Start o dalla riga di comando:

<Remote debugger installation directory>\msvsmon.exe

Nota

Se è necessario aggiungere autorizzazioni per altri utenti, modificare la modalità di autenticazione o il numero di porta per il debugger remoto, vedere Configurare il debugger remoto.

Per informazioni sull'esecuzione del debugger remoto come servizio, vedere Eseguire il debugger remoto come servizio.

Connettersi all'applicazione ASP.NET dal computer di Visual Studio

A partire da Visual Studio 2022 versione 17.10 Preview 2, la finestra di dialogo Collega a processo è stata modificata. Se sono necessarie istruzioni che corrispondono alla finestra di dialogo precedente, passare alla visualizzazione Visual Studio 2019 (selettore della versione superiore sinistra nell'articolo).

1. Nel computer di Visual Studio aprire la soluzione di cui si sta tentando di eseguire il debug (MyASPApp se si seguono tutti i passaggi descritti in questo articolo).

2. In Visual Studio selezionare Debug > Collega al processo (CTRL+ ALT+P).

   Consiglio

   In Visual Studio 2017 e versioni successive è possibile ricollegare lo stesso processo a cui è stato precedentemente collegato usando Debug > Ricollega a processo... (MAIUSC + ALT + P).

3. Impostare il tipo di connessione su Remoto (Windows).

   Appare l'opzione destinazione connessione .

   Impostare la destinazione connessione su <nome computer remoto> e premere INVIO.

   Verificare che Visual Studio aggiunga la porta richiesta al nome del computer, che appare nel formato: <nome del computer remoto>:porta

   In Visual Studio 2022, dovrebbe essere visualizzato <nome del computer remoto>:4026

   La porta è obbligatoria. Se non viene visualizzato il numero di porta, aggiungerlo manualmente.

4. Selezionare Aggiorna.

   Dovresti vedere alcuni processi apparire nella finestra Processi Disponibili.

   Se non vengono visualizzati processi, provare a usare l'indirizzo IP anziché il nome del computer remoto (la porta è obbligatoria). È possibile usare ipconfig in una riga di comando per ottenere l'indirizzo IPv4.

   Se si vuole usare il pulsante trova , potrebbe essere necessario aprire la porta UDP 3702 in uscita nel server.

5. Seleziona Mostra processi di tutti gli utenti.

6. Digitare la prima lettera di un nome di processo per trovare rapidamente w3wp.exe per ASP.NET 4.5.

   Se sono presenti più processi che mostrano w3wp.exe, controllare la colonna Nome utente. In alcuni scenari, la colonna Nome utente mostra il nome del pool di app, ad esempio IIS APPPOOL\DefaultAppPool. Se viene visualizzato il pool di app, un modo semplice per identificare il processo corretto consiste nel creare un nuovo pool di app denominato per l'istanza dell'app di cui si vuole eseguire il debug e quindi è possibile trovarlo facilmente nella colonna Nome utente.

   

7. Selezionare Allegare.

8. Aprire il sito Web del computer remoto. In un browser vai a http://<nome del computer remoto>.

   Verrà visualizzata la pagina Web ASP.NET.

9. Nell'applicazione ASP.NET in esecuzione selezionare il collegamento alla pagina Privacy.

   Il punto di interruzione deve essere raggiunto in Visual Studio.

   Se non è possibile collegarsi o raggiungere il punto di interruzione, vedere Risolvere i problemi di debug remoto.

Risoluzione dei problemi relativi alla distribuzione di IIS

• Se non è possibile connettersi all'host usando il nome host, provare invece l'indirizzo IP.
• Assicurarsi che le porte necessarie siano aperte nel server remoto.
• Verificare che la versione di ASP.NET usata nell'app corrisponda alla versione installata nel server. Per la tua app, puoi visualizzare e impostare la versione nella pagina proprietà. Per impostare l'app su una versione diversa, è necessario installare tale versione.
• Se l'app ha tentato di aprire, ma viene visualizzato un avviso del certificato, scegliere di considerare attendibile il sito. Se l'avviso è già stato chiuso, è possibile modificare il profilo di pubblicazione, un file *.pubxml, nel progetto e aggiungere l'elemento seguente (solo per il test): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Dopo la distribuzione, avviare l'app in IIS per verificare che sia stata distribuita correttamente.
• Controllare la finestra Output in Visual Studio per informazioni sullo stato e controllare i messaggi di errore.

Aprire le porte richieste su Windows Server

Nella maggior parte delle configurazioni, le porte richieste vengono aperte dall'installazione di ASP.NET e dal debugger remoto. Potrebbe tuttavia essere necessario verificare che le porte siano aperte.

Nota

In una macchina virtuale di Azure è necessario aprire le porte tramite il gruppo di sicurezza di rete .

Porte obbligatorie:

• 80: obbligatorio per IIS.

• 4026: obbligatorio per il debug remoto da Visual Studio 2022 (vedere Remote Debugger Port Assignments per altre informazioni).

• 4024: obbligatorio per il debug remoto da Visual Studio 2019 (vedere Remote Debugger Port Assignments per altre informazioni).

• UDP 3702: (facoltativo) La porta di individuazione consente di utilizzare il pulsante Trova quando si collega al debugger remoto in Visual Studio.

Inoltre, queste porte devono essere già aperte dall'installazione di ASP.NET:

• 8172: (facoltativo) Obbligatorio per la distribuzione Web per distribuire l'app da Visual Studio.

Aprire una porta

1. Per aprire una porta in Windows Server, aprire il menu start , cercare Windows Defender Firewall o Windows Firewall con sicurezza avanzata.

   Per Windows Defender Firewall, scegliere Impostazioni avanzate.

2. Quindi, scegli Regole in ingresso > Nuova regola > Porta. Scegliere Avanti e sotto Porte locali specifiche, immettere il numero di porta, selezionare Avanti, quindi Consenti la connessione, selezionare Avanti e aggiungere il nome (IIS, Web Deployo msvsmon) per la regola in ingresso.

   Per altri dettagli sulla configurazione di Windows Firewall, vedere Configurare Windows Firewall per il debug remoto.

3. Creare ulteriori regole per le altre porte necessarie.