Procédure d'installation unique pour les exemples Windows Communication Foundation
La plupart des exemples Windows Communication Foundation (WCF) sont hébergés dans Internet Information Services (IIS) et sont exécutés à partir d'un répertoire virtuel commun. Cette procédure d'installation unique crée un dossier sur le disque ; elle ajoute aussi un répertoire virtuel, nommé ServiceModelSamples, à IIS.
Le répertoire virtuel ServiceModelSamples est utilisé pour générer et exécuter tous les exemples qui utilisent des services hébergés par IIS. Il s'agit du seul répertoire virtuel requis pour exécuter les exemples. La génération d'un exemple remplace tout service déployé précédemment dans ce répertoire ; seul le dernier exemple généré sera déployé et disponible dans ce répertoire virtuel.
.gif "ms751527.note(fr-fr,VS.100).gif") Remarque : |
|---|
| Vous devez exécuter toutes les commandes sous un compte d'administrateur local. Si vous utilisez Windows 7, Windows Vista ou Windows Server 2008 R2, vous devez également exécuter l'invite de commandes avec des privilèges élevés. Pour ce faire, cliquez avec le bouton droit sur l'icône de l'invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Toutes les commandes qui figurent dans cette rubrique doivent être exécutées dans une invite de commandes disposant des paramètres de chemin d'accès appropriés. Le moyen le plus simple de vous en assurer consiste à utiliser l'invite de commandes de Visual Studio. Pour ouvrir cette invite, cliquez sur Démarrer, sélectionnez Tous les programmes, faites défiler vers le bas jusqu'à Visual Studio 2010, sélectionnez Visual Studio Tools, cliquez avec le bouton droit sur Invite de commandes de Visual Studio (2010), et cliquez sur Exécuter en tant qu'administrateur. Si l'une des éditions Visual Studio Express est installée, cette invite de commandes n'est pas disponible ; il vous faut ajouter « C:\Windows\Microsoft.Net\Framework\v4.0 » au chemin d'accès système. |
Procédure d'installation unique pour les exemples WCF
Assurez-vous que ASP.NET est installé. Pour plus d'informations sur le sujet suivant l'installation de ASP.NET, consultez Instructions relatives à l'hébergement dans les Services Internet (IIS).
Vérifiez que .NET Framework version 4 est installé. Recherchez le répertoire suivant pour la version 4.0 (ou ultérieure) : \Windows\Microsoft.NET\Framework
Si Visual Studio 2010 n'est pas installé et que votre système d'exploitation n'est pas Windows Server 2008 SP2 ou version ultérieure, installez le correctif logiciel 251798.
Exécutez les commandes suivantes. Pour plus d'informations sur les raisons pour lesquelles ces commandes doivent être exécutées, consultez IIS Hosted Service Fails.
.gif "ms751527.Warning(fr-fr,VS.100).gif")
Attention :Si vous avez réinstallé IIS, réexécutez les commandes suivantes. "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r Attention :Exécuter la commande aspnet_regiis –i –enable entraîne l'exécution du pool d'applications par défaut à l'aide de .NET Framework 4, ce qui peut provoquer des problèmes d'incompatibilité pour d'autres applications installées sur le même ordinateur. Conformez-vous aux instructions figurant dans la rubrique Instructions sur les pare-feu pour activer les ports utilisés par les exemples.
Vérifiez le contenu du répertoire par défaut suivant : <LecteurInstall>:\WF_WCF_Samples. Si les exemples ont été installés précédemment, il s'agit du répertoire par défaut.
Si les exemples ne sont pas installés, vous pouvez les installer à partir de l'emplacement de téléchargement des exemples Visual C# ou Visual Basic.
Après avoir installé les exemples, accédez à : <LecteurInstall>:\WF_WCF_Samples\WCF\Setup\
Exécutez le fichier de commandes Setupvroot.bat. Les étapes suivantes sont exécutées :
Un répertoire virtuel, nommé ServiceModelSamples, est créé dans IIS.
Des répertoires de disque nommés %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples et %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin sont créés.
Si vous préférez installer ces répertoires manuellement, consultez Instructions d'installation du répertoire virtuel. Pour annuler toutes les modifications apportées lors de cette étape, exécutez cleanupvroot.bat une fois que vous aurez terminé d'utiliser les exemples.
Remarque :Cette procédure doit être effectuée une fois seulement sur un ordinateur, sauf si cleanupvroot.bat est exécuté. Vous devez accorder au compte utilisé pour générer les exemples et à l'utilisateur du service réseau des autorisations de modification sur le répertoire %SystemDrive%\inetpub\wwwroot. Lors de la génération, certains exemples hébergés par le Web peuvent tenter de copier les fichiers binaires compilés dans l'emplacement mentionné précédemment. Si vous n'avez pas défini les autorisations requises, leur génération échoue. Vous pouvez également laisser les autorisations telles quelles et exécuter l'invite de commandes du Kit de développement logiciel (SDK) ou de Visual Studio (2010) en tant qu'administrateur, ou générer les exemples dans Visual Studio 2010, également en tant qu'administrateur.
Remarque :Si vous ne procédez pas à cette étape, tous les exemples hébergés par IIS échouent lors de la génération. Veillez à définir les autorisations correctement ou exécutez l'invite de commandes du Kit de développement logiciel (SDK) et de Visual Studio (2010) en tant qu'administrateur. Créez sur l'ordinateur un répertoire C:\logs ; certains exemples peuvent en avoir besoin. Assurez-vous que le compte approprié dispose d'un accès en écriture sur ce dossier. Pour Windows 7 Windows Vista et Windows Server 2008 R2, ce compte est Service réseau. Pour Windows Server 2008, le compte est Autorité NT\Service réseau. Pour Windows XP et Windows Server 2003, le compte est ASPNET.
Exécutez le fichier Setupcerttool.bat. Ce fichier se trouve dans le dossier <CheminInstall>\WF_WCF_Samples\WCF\Setup\. Ce script effectue les tâches suivantes :
génération de l'outil FindPrivateKey ;
création d'un répertoire nommé %ProgramFiles%\ServiceModelSampleTools ;
copie du nouvel outil FindPrivateKey dans ce répertoire.
Cet outil est requis pour les exemples qui utilisent des certificats et sont hébergés dans IIS.
Remarque :Pour des raisons de sécurité, n'oubliez pas de supprimer la définition de répertoire virtuel et les autorisations accordées au cours des étapes d'installation ci-dessus lorsque vous en avez terminé avec les exemples en exécutant le fichier de commandes Cleanupvroot.bat. Les exemples auto-hébergés (non hébergés dans IIS) doivent être autorisés à enregistrer des adresses HTTP sur l'ordinateur pour pouvoir écouter les données. Ces autorisations (qui permettent de réserver les espaces de noms HTTP) dépendent directement des autorisations dont les comptes d'utilisateurs utilisés pour exécuter ces exemples disposent. Par défaut, les comptes d'administrateur sont autorisés à enregistrer n'importe quelle adresse HTTP. L'autorisation pour les espaces de noms HTTP utilisés par les exemples doit être accordée aux comptes qui ne sont pas administrateur. Pour plus d'informations sur le sujet suivant la configuration des réservations d'espaces de noms, consultez Configuration de HTTP et HTTPS.
Certains exemples nécessitent Message Queuing. Pour obtenir les instructions d'installation, consultez Installation de Message Queuing (MSMQ).
Remarque :Veillez à démarrez le service MSMQ avant d'exécuter un exemple qui requiert Message Queuing. Certains exemples requièrent des certificats. Consultez Instructions d'installation du certificat de serveur des services Internet (IIS).