Procedura di installazione singola per gli esempi di Windows Communication Foundation

  • Articolo

La maggior parte degli esempi di Windows Communication Foundation (WCF) è ospitata in Internet Information Services (IIS) ed eseguita da una directory virtuale comune. Questa procedura di installazione monouso crea una cartella sul disco; aggiunge anche una directory virtuale a IIS denominata ServiceModelSamples.

La directory virtuale ServiceModelSamples viene utilizzata per la compilazione e l'esecuzione di tutti gli esempi che utilizzano un servizio ospitato in IIS. Si tratta della sola directory virtuale richiesta per eseguire gli esempi. La compilazione di un esempio determinerà la sostituzione dei servizi distribuiti in precedenza in questa directory virtuale. Solo l'esempio compilato più di recente verrà distribuito e reso disponibile in tale directory.

Nota

  • Tutti i comandi devono essere eseguiti con un account di amministratore locale. Se si utilizza Windows 7, Windows Vista o Windows Server 2008 R2, sarà inoltre necessario eseguire il prompt dei comandi con privilegi elevati. A tale scopo, fare clic con il pulsante destro del mouse sull'icona del prompt dei comandi, quindi scegliere Esegui come amministratore.
  • Tutti i comandi illustrati in questo articolo devono essere eseguiti in un prompt dei comandi che dispone delle impostazioni del percorso appropriate. Il modo più semplice per garantire che questo requisito venga soddisfatto consiste nell'utilizzare il prompt dei comandi per gli sviluppatori per Visual Studio.

Procedura di installazione singola per esempi WCF

  1. Assicurarsi che ASP.NET sia configurato. Per altre informazioni su come configurare ASP.NET, vedere Istruzioni per l'hosting del servizio informazioni Internet.

  2. Assicurarsi che .NET Framework 4+ sia installato. Cercare la directory seguente per la versione v4.0 (o successiva): \Windows\Microsoft.NET\Framework

  3. Assicurarsi che Visual Studio 2012 o versione successiva sia installato o che il sistema operativo sia Windows Server 2008 SP2 o versione successiva.

  4. Eseguire i comandi seguenti. Per altre informazioni sul motivo per cui eseguire questi comandi, vedere Il Servizio ospitato IIS non funziona.

    Avviso

    Se IIS viene reinstallato, nei comandi seguenti sarà necessario eseguirlo nuovamente.

    "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable
"%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r

    Avviso

    L'esecuzione del comando aspnet_regiis –i –enable consentirà l'esecuzione del pool di app predefinito con .NET Framework 4, che potrebbe causare problemi di incompatibilità per altre applicazioni nello stesso computer.

  5. Seguire le istruzioni del firewall per abilitare le porte usate dagli esempi.

  6. Eseguire il file batch Setupvroot.bat. Vengono eseguiti questi passaggi:

    • In IIS verrà creata una directory virtuale denominata ServiceModelSamples.

    • Vengono create nuove directory su disco denominate %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples and %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Se si preferisce configurare queste directory manualmente, vedere le Istruzioni di installazione della directory virtuale. Per ripristinare tutte le modifiche apportate in questo passaggio, eseguire cleanupvroot.bat dopo aver terminato di utilizzare gli esempi.

    Nota

    Questa procedura deve essere eseguita solo una volta in un computer, a meno che non venga eseguito cleanupvroot.bat.

  7. All'account con cui vengono compilati gli esempi e all'utente con account Servizio di rete è necessario concedere le autorizzazioni per la modifica di %SystemDrive%\inetpub\wwwroot. Durante la compilazione, alcuni esempi ospitati sul Web potrebbero tentare di copiare i file binari compilati nel percorso indicato in precedenza e se non sono state impostate le autorizzazioni appropriate, la compilazione si interromperà. In alternativa, è possibile lasciare invariate le autorizzazioni ed eseguire il prompt dei comandi dell'SDK o il prompt dei comandi di Visual Studio (2012) come amministratore oppure compilare gli esempi in Visual Studio 2012, anche come amministratore.

    Nota

    Se questo passaggio non viene completato, tutti gli esempi ospitati in IIS genereranno un errore durante la compilazione. Assicurarsi di impostare correttamente le autorizzazioni oppure eseguire il prompt dei comandi SDK e il prompt dei comandi di Visual Studio come amministratore.

  8. Creare una directory C:\logs nel computer perché alcuni esempi potrebbero prevederne l'esistenza. Verificare che l'account appropriato disponga dell'accesso in scrittura a questa cartella. Per Windows 7, Windows Vista e Windows Server 2008 R2, questo account è Servizio di rete. Per Windows Server 2008, l'account è NT Authority\Network Service. Per Windows XP e Windows Server 2003, l'account è ASPNET.

  9. Eseguire il file Setupcerttool.bat. Questo script esegue le attività seguenti:

    • Compila lo strumento FindPrivateKey.

    • Crea una directory denominata %ProgramFiles%\ServiceModelSampleTools.

    • Copia il nuovo strumento FindPrivateKey in questa directory.

    Questo strumento è necessario per gli esempi che utilizzano certificati e sono ospitati in IIS.

    Nota

    Per motivi di sicurezza, ricordarsi di rimuovere la definizione della directory virtuale e le autorizzazioni concesse nei passaggi di installazione precedenti eseguendo il file batch denominato cleanupvroot.bat dopo aver completato gli esempi.

  10. Per gli esempi indipendenti (non ospitati in IIS) è necessaria un'autorizzazione per la registrazione degli indirizzi HTTP nel computer in ascolto. L'autorizzazione per una prenotazione dello spazio dei nomi HTTP viene dall'account utente utilizzato per eseguire l'esempio. Per impostazione predefinita, gli account amministratore dispongono delle autorizzazioni per registrare qualsiasi indirizzo HTTP. Agli account non amministratore è necessario concedere l'autorizzazione per gli spazi dei nomi HTTP utilizzati da questi esempi. Per altre informazioni su come configurare le prenotazioni dello spazio dei nomi, vedere Configuring HTTP and HTTPS (Configurazione di HTTP e HTTPS).

  11. Alcuni esempi richiedono Accodamento messaggi. Per istruzioni sull'installazione, vedere Installazione di Accodamento messaggi (MSMQ).

    Nota

    Assicurarsi di avviare il servizio MSMQ prima di eseguire gli esempi per i quali è necessario Accodamento messaggi.

  12. Alcuni esempi richiedono l'utilizzo di certificati. Vedere le Istruzioni di installazione certificato server IIS (Internet Information Services).