One-Time Procedura di configurazione per gli esempi di Windows Communication Foundation

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 usata per la compilazione e l'esecuzione di tutti gli esempi che usano un servizio ospitato da IIS. Questa è l'unica directory virtuale necessaria per eseguire gli esempi. La compilazione di un esempio sostituirà qualsiasi servizio distribuito in precedenza in questa directory virtuale; solo l'esempio compilato più di recente verrà distribuito e disponibile in questa directory virtuale.

Annotazioni

• È necessario eseguire tutti i comandi con un account amministratore locale. Se usi Windows 7, Windows Vista o Windows Server 2008 R2, devi anche 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 e quindi scegliere Esegui come amministratore.
• Tutti i comandi in questo articolo devono essere eseguiti in un prompt dei comandi con le impostazioni del percorso appropriate. Il modo più semplice per garantirlo è utilizzare il Prompt dei Comandi degli Sviluppatori per Visual Studio.

Procedura di configurazione monouso per gli esempi WCF

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

2. Assicurarsi che .NET Framework 4+ sia installato. Cercare nella directory seguente la versione 4.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 Iis Hosted Service Fails.

   Avvertimento

   Se IIS viene reinstallato, sarà necessario eseguire di nuovo i comandi seguenti.

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

   Avvertimento

   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 batchSetupvroot.bat. Vengono eseguiti i passaggi seguenti:

   • Viene creata una directory virtuale in IIS denominata ServiceModelSamples.

   • Vengono create nuove directory disco denominate %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples e %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 al termine dell'uso degli esempi.

   Annotazioni

   Questa procedura deve essere eseguita una sola volta in un computer, a meno che non si esegua cleanupvroot.bat.

7. È necessario concedere l'autorizzazione per modificare per %SystemDrive%\inetpub\wwwroot all'account con cui si creano gli esempi e l'utente del servizio di rete. 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 verrà interrotta. 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.

   Annotazioni

   Se questo passaggio non viene completato, tutti gli esempi ospitati da IIS avranno esito negativo durante la compilazione. Assicurarsi di impostare correttamente le autorizzazioni oppure di eseguire sia il prompt dei comandi dell'SDK che il prompt dei comandi di Visual Studio come amministratore.

8. Creare una directory C:\logs sul computer perché alcuni esempi potrebbero aspettarselo. Assicurarsi che all'account appropriato sia concesso l'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. Esegui il fileSetupcerttool.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 è richiesto dagli esempi che usano certificati e sono ospitati in IIS.

   Annotazioni

   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. Gli esempi self-hosted (non ospitati in IIS) richiedono l'autorizzazione per registrare gli indirizzi HTTP nel computer per l'ascolto. L'autorizzazione per una prenotazione dello spazio dei nomi HTTP proviene dall'account utente usato per eseguire l'esempio. Per impostazione predefinita, gli account amministratore dispongono dell'autorizzazione per registrare qualsiasi indirizzo HTTP. Ai profili non amministratore deve essere concessa l'autorizzazione per i namespaces HTTP utilizzati dagli esempi. Per altre informazioni su come configurare le prenotazioni dello spazio dei nomi, vedere Configurazione di HTTP e HTTPS.

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

    Annotazioni

    Assicurarsi di avviare il servizio MSMQ prima di eseguire tutti gli esempi che richiedono accodamento messaggi.

12. Alcuni esempi richiedono certificati. Vedere Istruzioni per l'installazione del certificato del server Internet Information Services (IIS).