Instructions d'installation du répertoire virtuel
Les exemples WCF (Windows Communication Foundation) ont pour but de partager un répertoire virtuel commun nommé servicemodelsamples, qui est mappé au dossier %SystemDrive%\inetpub\wwwroot\servicemodelsamples.
Notes
%SystemDrive% correspond généralement à C: ou D:, en fonction de l'emplacement de lecteur où Internet Information Services (IIS) est installé.
Pour créer le répertoire virtuel, vous pouvez exécuter les fichiers Setupvroot.bat et Cleanupvroot.bat de la Procédure d’installation unique pour les exemples Windows Communication Foundation. Si vous préférez créer le répertoire virtuel manuellement, exécutez les procédures suivantes.
Procédures
Pour créer un répertoire virtuel dans IIS 7.0 ou 7.5
Dans le menu Démarrer, cliquez sur Exécuter, puis entrez inetmgr pour ouvrir le composant logiciel enfichable MMC Internet Information Services (IIS).
Dans le volet de gauche, développez le nœud portant le nom de l’ordinateur, puis développez le nœud Sites.
Cliquez avec le bouton droit sur Site web par défaut, puis sélectionnez Ajouter une application pour ouvrir la fenêtre Ajouter une application.
Dans cette fenêtre, entrez
servicemodelsamples
comme alias du répertoire virtuel que vous créez.Créez le répertoire suivant : %SystemDrive%\inetpub\wwwroot\servicemodelsamples
Affectez la valeur %SystemDrive%\inetpub\wwwroot\servicemodelsamples au chemin d’accès physique. La plupart des exemples WCF copient les fichiers exécutables de service dans cet emplacement une fois générés.
Cliquez sur OK. L'application Web est créée pour les exemples WCF.
Notes
Cette tâche doit être exécutée une seule fois, car les exemples WCF utilisent tous la même application web (servicemodelsamples).
Notes
Dans cette documentation, le terme
virtual directory
est synonyme du termeWeb application
.Après avoir créé le répertoire virtuel, vous devez définir ses propriétés pour que les services WCF puissent être exécutés. Voir les détails ci-dessous.
Pour créer un répertoire virtuel dans IIS 5.1 ou 6.0 :
Ouvrez une fenêtre d’invite de commandes et entrez
start inetmgr
pour ouvrir le composant logiciel enfichable MMC Internet Information Services (IIS).Dans le volet de gauche, développez le nœud portant le nom de l’ordinateur, puis développez le nœud Sites web.
Cliquez avec le bouton droit sur Site web par défaut et sélectionnez Nouveau, Répertoire virtuel pour ouvrir l’Assistant Création de répertoire virtuel.
Dans l’Assistant, entrez
servicemodelsamples
comme alias du répertoire virtuel que vous créez.Affectez la valeur %SystemDrive%\inetpub\wwwroot\servicemodelsamples au chemin. La plupart des exemples WCF copient les fichiers exécutables de service dans cet emplacement une fois générés.
Cliquez sur Suivant.
Les cases à cocher suivantes sont activées par défaut :
Lire
Exécuter les scripts (tels que ASP)
Cliquez sur Next, puis sur Terminer pour fermer l’Assistant.
Notes
Cette tâche doit être exécutée une seule fois, car les exemples WCF utilisent tous le même répertoire virtuel (servicemodelsamples).
Pour définir des propriétés de répertoire virtuel supplémentaires dans IIS 7.0 ou 7.5
Cliquez sur le nœud servicemodelsamples. Deux vues figurent au bas de la fenêtre. Sélectionnez Affichage des fonctionnalités si ce n’est pas encore fait.
Double-cliquez sur l’entrée correspondant à Exploration de répertoire.
Dans le volet Actions, sélectionnez l’option Enable. Ceci permet d’accéder au répertoire en utilisant un navigateur, ce qui est utile lors du débogage d’un service.
Enfin, vous devez définir les propriétés de sécurité du dossier servicemodelsamples afin d’autoriser son accès. Voir les détails ci-dessous.
Pour définir des propriétés de répertoire virtuel supplémentaires dans IIS 5.1 ou 6.0
Cliquez avec le bouton droit sur le nœud servicemodelsamples, puis cliquez sur Propriétés.
Les cases à cocher suivantes sont activées par défaut :
Lire
Accès au journal
Indexer cette ressource
Cochez la case Exploration de répertoire. Ceci permet d’accéder au répertoire en utilisant un navigateur, ce qui est utile lors du débogage d’un service.
Pour définir les propriétés de sécurité de ce dossier dans IIS 7.0 ou 7.5
Ouvrez le répertoire %SystemDrive%\inetpub\wwwroot\servicemodelsamples.
Cliquez avec le bouton droit sur le dossier servicemodelsamples et cliquez sur Partager ou Partager avec.
Cliquez sur la flèche vers le bas à gauche du bouton Ajouter.
Sélectionnez l’entrée Rechercher. La fenêtre Sélectionner les utilisateurs ou les groupes s’ouvre.
Cliquez sur Avancé.
Cliquez sur Emplacements. La fenêtre Emplacements s’ouvre.
Sélectionnez l'entrée correspondant à l'ordinateur en cours d'utilisation. Il est important de sélectionner l'ordinateur local et non une entrée correspondant à tous les domaines ou réseaux répertoriés. Après avoir sélectionné l’ordinateur, cliquez sur OK.
Cliquez sur Rechercher. Cela permet d'inclure dans les résultats de la recherche les objets associés à l'ordinateur local.
Recherchez l’entrée IIS_IUSRS dans la colonne Nom (Nom unique relatif). Sélectionnez cette entrée et cliquez sur OK pour fermer la fenêtre des résultats de la recherche.
Cliquez sur OK pour fermer la fenêtre Sélectionner des utilisateurs ou des groupes.
Cliquez sur Partager pour enregistrer les modifications.
Une fois les modifications de partage apportées, cliquez sur Terminé pour fermer la fenêtre Partage de fichiers.
Pour définir les propriétés de sécurité de ce dossier dans IIS 5.1 ou 6.0 :
Ouvrez le répertoire %SystemDrive%\inetpub\wwwroot\servicemodelsamples.
Cliquez avec le bouton droit sur le dossier servicemodelsamples, puis cliquez sur Partage et sécurité.
Cliquez sur l’onglet Security .
Si vous utilisez IIS 6.0, vérifiez dans la zone Noms de groupes ou d’utilisateurs que Compte Invité Internet figure dans la liste.
Si elle ne s'y trouve pas :
Cliquez sur Démarrer, puis sur Panneau de configuration.
Si l’icône Comptes d’utilisateurs n’apparaît pas, cliquez sur Basculer vers l’affichage des catégories.
Cliquez sur l’icône Comptes d’utilisateurs.
Dans « ou une icône du panneau de configuration », cliquez sur Comptes d’utilisateurs.
Dans la boîte de dialogue Comptes d’utilisateurs, cliquez sur l’onglet Avancé.
Cliquez sur Avancé.
Dans la boîte de dialogue Utilisateurs et groupes locaux, cliquez pour développer le dossier Utilisateurs.
Dans le volet droit, double-cliquez sur Compte Invité Internet.
Dans la boîte de dialogue Propriétés, copiez le nom utilisé comme compte Invité Internet. Par défaut, le nom commence par « USR_ » suivi du nom de l'ordinateur.
Fermez la boîte de dialogue Propriétés .
Fermez la boîte de dialogue Utilisateurs et groupes locaux.
Fermez la boîte de dialogue Comptes d’utilisateurs.
Fermez l’autre boîte de dialogue Comptes d’utilisateurs.
Dans la boîte de dialogue Propriétés de servicemodelsamples, sous l’onglet Sécurité, cliquez sur Ajouter.
Tapez le nom de l'ordinateur suivi d'une barre oblique inverse, puis collez le nom du compte d'utilisateur Internet (myMachineName\%InternetGuestAccountName%, par exemple).
Cliquez sur Vérifier les noms pour vérifier le nom entré. S'il est valide, ce nom figure en majuscules soulignées.
Pour IIS 6.0, vérifiez également que SERVICE RÉSEAU est répertorié dans la zone Noms de groupes ou d’utilisateurs.
Si SERVICE RÉSEAU n'est pas répertorié :
Cliquez sur Add.
Dans la boîte de dialogue Sélectionner les utilisateurs ou les groupes, entrez le nom de l’ordinateur suivi d’une barre oblique inverse.
Entrez service après la barre oblique inverse (sans espace).
Cliquez sur Vérifier les noms.
Si plusieurs noms sont trouvés, sélectionnez SERVICE RÉSEAU et cliquez sur OK.
Cliquez sur OK pour fermer la boîte de dialogue Sélectionner les utilisateurs ou les groupes.
Si vous utilisez Windows XP SP2 avec IIS 5.1, vérifiez que Compte Invité Internet et ASPNET sont répertoriés dans la zone Noms de groupes ou d’utilisateurs.
Notez que l’utilisateur ASPNET peut être membre du groupe de sécurité Utilisateurs intégré. Dans ce cas, si le groupe Utilisateurs est répertorié dans la boîte de dialogue, vous n’avez pas besoin de l’ajouter à la liste des utilisateurs autorisés sous forme d’élément séparé.
Pour vérifier qu’ASPNET fait partie du groupe de sécurité Utilisateurs :
Dans le menu Démarrer , cliquez sur Panneau de configuration.
Cliquez sur l’icône Comptes d’utilisateurs.
Dans la colonne Groupe, vérifiez que la valeur correspondant à ASPNET est « Utilisateurs ».