Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Appcmd.exe (IIS 8)

 

S'applique à: Windows Server 2012 R2, Windows Server 2012

IIS 8 fournit un outil de ligne de commande, Appcmd.exe, configurer et interroger les objets sur votre serveur web et pour retourner la sortie de texte ou XML. Les exemples suivants illustrent des tâches que vous pouvez effectuer avec Appcmd.exe:

  • Créer et configurer des sites, des applications, des pools d'applications et des répertoires virtuels.

  • Démarrer et arrêter des sites.

  • Démarrer, arrêter et recycler les pools d'applications.

  • Afficher des informations sur les processus de travail et des requêtes qui s'exécutent sur le serveur web.

Appcmd.exe Fournit des commandes cohérente des requêtes communes et les tâches de configuration, ce qui réduit la complexité de la syntaxe de formation. Par exemple, vous pouvez utiliser la liste de commande pour rechercher des informations sur un objet, tel qu'une application, ou vous pouvez utiliser la Ajouter commande pour créer un objet, tel qu'un site.

En outre, vous pouvez combiner des commandes et retourner des données plus complexes sur les objets sur votre serveur web ou pour effectuer des tâches plus complexes. Par exemple, vous pouvez effectuer des tâches complexes telles que l'arrêt de tous les sites qui ont des demandes qui ont été en cours d'exécution plus de 60 secondes.

Dans ce document

Ouvrez Appcmd.exe Si vous voulez configurer IIS 8 paramètres à l'aide d'une fenêtre de l'interface de commande.Appcmd.exe se trouve dans le répertoire %windir%\system32\inetsrv, qui est disponible uniquement pour le compte d'administrateur ou utilisateurs qui sont membres du groupe Administrateurs sur l'ordinateur. En outre, les membres du groupe administrateurs doivent démarrer Appcmd.exe avec des autorisations élevées pour afficher et modifier les paramètres dans les fichiers de configuration au niveau du serveur : Machine.config, le fichier Web.config racine (dans le répertoire .NET Framework) et dans la section ApplicationHost.config. Utilisateurs pour afficher ou modifient les fichiers Web.config dans les répertoires de site ou votre application doivent avoir accès en lecture et écriture dans des fichiers dans ces répertoires.

System_CAPS_noteRemarque

Si vous exécutez Windows 64 bits, utilisez Appcmd.exe dans le répertoire %windir%\system32\inetsrv, pas dans le répertoire %windir%\syswow64\inetsrv.

Pour démarrer Appcmd.exe

  1. Cliquez sur Démarrer, puis cliquez sur tous les programmes.

  2. Cliquez sur Accessoires, puis cliquez sur invite.

  3. À l'invite de commandes, tapez cd %windir%\system32\inetsrv, puis appuyez sur ENTRÉE.

System_CAPS_noteRemarque

Pour exécuter l'invite de commandes en tant qu'administrateur, cliquez sur l'icône dans le Démarrer menu, puis sur Exécuter en tant qu'administrateur.

Appcmd.exe contient des informations d'aide intégré. Pour afficher les informations d'aide Appcmd.exe, tapez une commande, puis tapez /?.

Par exemple, si vous souhaitez afficher l'aide introductive sur Appcmd.exe, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd / ?

Pour afficher les informations d'aide sur son propre Appcmd.exe objet, telles que les commandes que vous pouvez utiliser avec le site de l'objet, à l'invite de commandes, tapez la commande suivante, puis appuyez sur ENTRÉE :

appcmd site / ?

Pour afficher les informations d'aide sur les paramètres que vous pouvez configurer à l'aide un Appcmd.exe objet et la commande, telles que la site objet et Ajouter de commandes, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd ajouter site / ?

Utiliser des objets dans Appcmd.exe pour spécifier ce que vous voulez afficher ou modifier dans la configuration. Pour afficher une liste des Appcmd.exe des objets, à l'invite de commandes, tapez la commande suivante, puis appuyez sur ENTRÉE :

appcmd / ?

Vous pouvez ensuite configurer l'objet à l'aide de commandes. Pour plus d'informations sur les commandes, consultez la page Utiliser les commandes Appcmd.exe.

Utilisez Appcmd.exe commandes pour afficher ou modifier les paramètres de configuration pour un Appcmd.exe objet. Chacun de ces objets comporte des commandes qui vous permettent de travailler avec cet objet. Pour afficher les commandes pour un objet, utilisez la syntaxe suivante :

appcmd object /?

La variable objet est le nom de l'objet pour lequel vous souhaitez afficher les commandes. Par exemple, pour afficher la liste des commandes pour le site de l'objet, à l'invite de commandes, tapez la commande suivante, puis appuyez sur ENTRÉE :

appcmd site / ?

Pour plus d'informations sur Appcmd.exe voir Utilisation des objets dans Appcmd.exe.

Spécifiez les valeurs des attributs lorsque vous souhaitez limiter les résultats d'une commande de la liste, ou lorsque vous souhaitez modifier la valeur d'un attribut pour un Appcmd.exe objet.

Par exemple, pour répertorier les pools d'application configuré pour utiliser Service réseau, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd liste pool d'applications /processModel.identityType:NetworkService

Vous pouvez également configurer un pool d'applications nommé Marketing pour utiliser Service réseau, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd définir apppool /apppool.name:Marketing /processModel.identityType:NetworkService

Le processModel.identityType attribut est utilisé dans les deux exemples précédents. Dans le premier exemple, l'attribut limite les résultats de requête en affichant uniquement les pools d'applications qui sont configurés pour utiliser Service réseau. Dans le deuxième exemple, l'attribut spécifie que le pool d'applications Marketing utilisent l'identité Service réseau.

Dans Windows 8 et Windows Server 2012, la AppHostConfig attribut a été ajouté. Le AppHostConfig attribut vous permet de modifier un fichier de configuration AppHost qui n'est pas le fichier de configuration par défaut AppHost. Bien que cet attribut est utile dans de nombreux cas, des valeurs non valides sont ignorées sous les combinaisons de verbe/objet suivant :

Verb

object

Démarrer ou arrêter

Site

Démarrage, arrêt ou recycler

Pool d'applications

All verbs

Secours

All verbs

Demande

All verbs

WP

Dans IIS 8, vous pouvez configurer les paramètres dans les fichiers de configuration au niveau du serveur ou dans des fichiers Web.config qui se trouvent dans un dossier d'un site, une application ou un répertoire virtuel. Fichiers de configuration au niveau du serveur sont Machine.config, le fichier Web.config racine et ApplicationHost.config. Ces trois fichiers sont disponibles uniquement pour le compte d'administrateur ou pour les utilisateurs qui sont membres du groupe Administrateurs sur le serveur web. En outre, les membres du groupe administrateurs doivent ouvrir une fenêtre de shell de commande qui utilise les autorisations d'administrateur élevées pour lire et modifier les paramètres dans les fichiers de configuration au niveau du serveur. Pour plus d'informations sur le démarrage de Appcmd.exe dans une fenêtre de l'interface de commande qui utilise des autorisations d'administrateur élevées, consultez Démarrer Appcmd.exe.

Par défaut, ApplicationHost.config est le fichier à partir de laquelle Appcmd.exe lit la configuration et à laquelle Appcmd.exe écrit les modifications. Lorsque vous souhaitez lire les modifications à partir d'ou écriture au fichier Machine.config ou le fichier Web.config racine, inclure un commit dans votre commande. Spécifiez l'ordinateur pour le commit paramètre lorsque vous souhaitez affecter le fichier Machine.config ou spécifiez WEBROOT lorsque vous souhaitez affecter le fichier Web.config racine.

Par exemple, pour répertorier la section machineKey dans le fichier Web.config racine, à l'invite de commandes, tapez la commande suivante, puis appuyez sur ENTRÉE :

appcmd liste config /section:machineKey /commit:WEBROOT

Dans IIS 8, vous pouvez configurer des paramètres dans les fichiers de configuration au niveau du serveur ou dans des fichiers Web.config pour un site, une application ou un répertoire virtuel sur votre serveur web. Les utilisateurs qui afficher ou modifier les paramètres dans les fichiers Web.config dans les répertoires de site ou votre application doivent disposer de lecture et accès en écriture aux fichiers dans ces répertoires. En outre, vous devez déléguer des fonctionnalités que vous souhaitez configurer sur ce site, application ou au niveau du répertoire virtuel dans IIS 8. Pour plus d'informations sur les fichiers de configuration et les fonctionnalités de délégation, consultez fonctionne avec les fichiers de Configuration dans IIS 7.0 et Site Web de délégué et la gestion des applications Web.

Lorsque vous utilisez Appcmd.exe pour configurer les paramètres dans un fichier Web.config pour un site spécifique, une application ou un répertoire virtuel, spécifiez le chemin d'accès du site, application ou répertoire virtuel pour lequel vous souhaitez appliquer la configuration. Par exemple, pour désactiver la fonctionnalité de document par défaut pour un site web nommé Contoso, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd set config »Contoso« /section:defaultDocument / enabled : false

Dans l'exemple précédent, les modifications de configuration sont apportées dans le fichier Web.config dans le Contoso répertoire et tous les Contoso les répertoires virtuels et les applications héritent de la configuration de ce fichier Web.config. Toutefois, si vous souhaitez activer les documents par défaut pour une application spécifique dans le Contoso site, vous pouvez utiliser Appcmd.exe pour fournir le chemin d'accès de l'application. Par exemple, pour activer par défaut les documents d'une application nommée galerie, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd set config »Contoso/Galerie« /section:defaultDocument / enabled : true

Dans l'exemple précédent, la commande permet de documents par défaut pour le galerie application dans le Contoso site et écrit la configuration est modifiée dans le fichier Web.config dans la galerie active.

La section précédente vous a expliqué comment utiliser Appcmd.exe pour configurer les fonctionnalités d'un site spécifique, une application ou un répertoire virtuel par écrire les modifications dans un fichier Web.config. Vous pouvez également configurer des fonctionnalités pour un site spécifique, une application, un répertoire virtuel ou même une URL à l'aide de balises d'emplacement dans un fichier de configuration parent.

Lorsque vous souhaitez configurer les paramètres d'un site, une application ou un répertoire virtuel, mais vous souhaitez stocker les paramètres dans un fichier de configuration parent, comme dans ApplicationHost.config plutôt que dans un fichier Web.config, utiliser le Appcmd.exe validation paramètre avec votre commande.  En utilisant les exemples dans la section précédente, vous pouvez maintenant écrire les modifications de configuration ApplicationHost.config plutôt que pour les fichiers Web.config de site et d'application.

La première, pour désactiver les documents par défaut pour le site web nommé Contoso, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd set config »Contoso« /section:defaultDocument / enabled : false /commit:APPHOST

La commande précédente désactive les documents par défaut pour le Contoso site et écrit les paramètres de configuration avec un emplacement de balise dans ApplicationHost.config. La balise d'emplacement spécifie que la configuration s'applique à la Contoso site. La section de configuration ressemble à l'exemple suivant :

<location path="Contoso">
      <system.webServer>
            <defaultDocument enabled="false" />
      </system.webServer>
</location>

Seconde, pour activer les documents par défaut pour l'application nommée galerie, tapez la commande suivante à l'invite de commandes, puis appuyez sur ENTRÉE :

appcmd set config »Contoso/Galerie« /section:defaultDocument / enabled : true /commit:APPHOST

La commande précédente permet de documents par défaut pour le galerie application et écrit les paramètres de configuration avec un emplacement de balise dans ApplicationHost.config. La balise d'emplacement spécifie que la configuration s'applique à la galerie application. La section de configuration ressemble à l'exemple suivant :

<location path="Contoso/Gallery">
      <system.webServer>
            <defaultDocument enabled="true" />
      </system.webServer>
</location>
Afficher: