Comment faire pour utiliser l’outil de ligne de commande Appcmd.exe pour activer et configurer la journalisation HTTP et autres fonctionnalités dans Internet Information Services 7.0

INTRODUCTION

Les fonctionnalités suivantes ne peuvent pas être configurées en utilisant le Gestionnaire Microsoft Internet Information Services (IIS) 7.0 :
  • Journalisation HTTP
  • Redirection de HTTP
  • En-têtes de réponse HTTP
  • Compression HTTP
Pour activer et configurer ces fonctionnalités, vous devez utiliser l’outil de ligne de commande Appcmd.exe.

Plus d'informations

Pour activer ces fonctionnalités dans IIS 7.0, utilisez l’outil de ligne de commande Appcmd.exe. Lorsque vous utilisez cet outil, vous devez d’abord activer cette fonctionnalité. Ensuite, vous devez configurer les paramètres de la fonction. Lorsque vous exécutez l’outil Appcmd.exe, les paramètres sont mis à jour dans le fichier %windir%\System32\Inetsrv\Config\ApplicationHost.config.

Les sections suivantes décrivent l’utilisation de l’outil Appcmd.exe pour activer diverses fonctionnalités HTTP dans IIS 7.0. Pour déterminer les autres attributs IIS et les paramètres que vous pouvez modifier à l’aide de l’outil Appcmd.exe, permet d’afficher le schéma complet dans le fichier %windir%\System32\Inetsrv\Config\Schema\IIS_schema.xml.

Journalisation HTTP

Pour activer la journalisation pour les demandes HTTP, procédez comme suit :
  1. Cliquez sur DémarrerStart button , type
    invite de commande
    dans la zone Rechercher , cliquez droit sur invite de commande dans la liste des programmes , puis cliquez sur Exécuter en tant qu’administrateur.

    User Account Control permission
    Si vous êtes invité à rentrer un mot de passe administrateur ou une confirmation, tapez votre mot de passe, ou cliquez sur Continuer.
  2. Tapez la commande suivante et appuyez sur ENTRÉE :
    CD \windows\system32\inetsrv
  3. Tapez la commande suivante et appuyez sur ENTRÉE :
    appcmd définir config /section:httpLogging /dontLog:False /selectiveLogging:LogAll
    Remarque Cette commande configure l’enregistrement pour utiliser la valeur par défaut de paramètres de connexion à partir du fichier de schéma pour tous les sites Web qui sont configurés sur le serveur Web HTTP. L’attribut selectiveLogging peut être égale à une des valeurs suivantes :
    • LogError
      Cette valeur spécifie que toutes les erreurs sont enregistrées.
    • LogSuccessful
      Cette valeur spécifie que toutes les demandes réussies sont enregistrés.
    • LogAll
      Cette valeur spécifie que toutes les demandes sont enregistrés.
Pour désactiver la journalisation pour les demandes HTTP, tapez la commande suivante et appuyez sur ENTRÉE :
appcmd définir /dontLog:True de /section:httpLogging de configuration

Options de journalisation supplémentaires

Une fois que vous avez activé la journalisation pour les demandes HTTP, vous pouvez définir des options de journalisation supplémentaires. Par exemple, vous pouvez définir des informations spécifiques pour ouvrir une session. La commande suivante montre comment enregistrer uniquement les informations de sous-état HTTP pour tous les sites Web :
appcmd définir config /section:sites-siteDefaults.logFile.logExtFileFlags:HttpSubStatus
Vous pouvez enregistrer les informations suivantes sur le site Web qui a une valeur d’ID 1 :
  • Sous-état HTTP
  • Hôte
  • Heure
  • Date
Pour ce faire, utilisez une commande semblable à la suivante :
appcmd définir config /section:sites /[id='1'].logFile.logExtFileFlags:HttpSubStatus,Host,Time,Date

Redirection de HTTP

Pour permettre la redirection HTTP, procédez comme suit :
  1. Cliquez sur DémarrerStart button , type
    invite de commande
    dans la zone Rechercher , cliquez droit sur invite de commande dans la liste des programmes , puis cliquez sur Exécuter en tant qu’administrateur.

    User Account Control permission
    Si vous êtes invité à rentrer un mot de passe administrateur ou une confirmation, tapez votre mot de passe, ou cliquez sur Continuer.
  2. Tapez la commande suivante et appuyez sur ENTRÉE :
    CD \windows\system32\inetsrv
  3. Tapez la commande suivante et appuyez sur ENTRÉE :
    appcmd définir config /section:httpRedirect / enabled : true
Pour ajouter une règle de redirection HTTP, tapez la commande suivante et appuyez sur ENTRÉE :
appcmd définir config /section:httpRedirect / + [génériques ='WildcardHeader', destination ='Destination']
Remarque Dans cette commande, WildcardHeader représente la page Web ou les pages que vous voulez rediriger. Destination représente la page Web de destination vers lequel redirige la valeur WildcardHeader .

Pour désactiver la redirection HTTP, tapez la commande suivante et appuyez sur ENTRÉE :
appcmd définir config /section:httpRedirect / enabled : false

En-têtes de réponse HTTP

Pour ajouter un en-tête de réponse HTTP, procédez comme suit :
  1. Cliquez sur DémarrerStart button , type
    invite de commande
    dans la zone Rechercher , cliquez droit sur invite de commande dans la liste des programmes , puis cliquez sur Exécuter en tant qu’administrateur.

    User Account Control permission
    Si vous êtes invité à rentrer un mot de passe administrateur ou une confirmation, tapez votre mot de passe, ou cliquez sur Continuer.
  2. Tapez la commande suivante et appuyez sur ENTRÉE :
    CD \windows\system32\inetsrv
  3. Tapez la commande suivante et appuyez sur ENTRÉE :
    appcmd définir config /section:httpProtocol / + customHeaders. [nom ='HeaderName», valeur = «HeaderValue']
    Remarque Dans cette commande, HeaderName représente le nom de l’en-tête HTTP que vous ajoutez. HeaderValue représente la valeur de l’en-tête HTTP que vous ajoutez.
Pour modifier un en-tête de réponse HTTP, tapez la commande suivante et appuyez sur ENTRÉE :
appcmd définir config /section:httpProtocol /customHeaders. [nom ='HeaderName']. valeur :HeaderValue
Remarque Dans cette commande, HeaderName représente le nom de l’en-tête HTTP que vous souhaitez modifier. HeaderValue représente la valeur de l’en-tête HTTP que vous modifiez.

Pour afficher la liste des en-têtes de réponse HTTP, tapez la commande suivante et appuyez sur ENTRÉE :
appcmd liste config /section:httpProtocol

Compression HTTP

Pour activer la compression HTTP, procédez comme suit :
  1. Cliquez sur DémarrerStart button , type
    invite de commande
    dans la zone Rechercher , cliquez droit sur invite de commande dans la liste des programmes , puis cliquez sur Exécuter en tant qu’administrateur.

    User Account Control permission
    Si vous êtes invité à rentrer un mot de passe administrateur ou une confirmation, tapez votre mot de passe, ou cliquez sur Continuer.
  2. Tapez la commande suivante et appuyez sur ENTRÉE :
    CD \windows\system32\inetsrv
  3. Activer la compression de contenu statique ou de compression de contenu dynamique. Pour ce faire, utilisez une des méthodes suivantes :
    • Pour activer la compression de contenu statique, tapez la commande suivante et appuyez sur ENTRÉE :
      appcmd définir /doStaticCompression:True de /section:urlCompression de configuration
    • Pour activer la compression de contenu dynamique, tapez la commande suivante et appuyez sur ENTRÉE :
      appcmd définir /doDynamicCompression:True de /section:urlCompression de configuration

Références

Pour plus d’informations sur l’outil Appcmd.exe, visitez le site Web de Microsoft à l’adresse suivante :
Pour plus d’informations sur la configuration HTTP de journalisation dans IIS 7.0, visitez le site Web de Microsoft à l’adresse suivante :
Pour plus d’informations sur la modification d’une règle de redirection dans IIS 7.0, visitez le site Web de Microsoft à l’adresse suivante :
Pour plus d’informations sur la façon de configurer des en-têtes de réponse HTTP dans IIS 7.0, visitez le site Web de Microsoft à l’adresse suivante :
Pour plus d’informations sur la façon de configurer la compression HTTP dans IIS 7.0, visitez le site Web de Microsoft à l’adresse suivante :
Propriétés

ID d'article : 930909 - Dernière mise à jour : 17 janv. 2017 - Révision : 1

Commentaires