Compression <HTTP httpCompression>

Article
07/19/2023

Vue d’ensemble

L’élément <httpCompression> spécifie les paramètres de compression HTTP pour Internet Information Services (IIS) 7. La compression HTTP peut accélérer les temps de transmission entre IIS et les navigateurs clients qui peuvent accepter des fichiers compressés.

Notes

Un client HTTP doit lancer la communication pour le contenu compressé en envoyant l’en-tête d’encodage HTTP Accept approprié. Si un client n’est pas capable de la compression HTTP, il ne transmet pas cet en-tête et IIS 7 retourne toujours le contenu non compressé.

Il existe deux types de compression différents utilisés par IIS 7 :

Compression statique :

IIS 7 met en cache le contenu statique compressé dans le chemin spécifié par l’attribut de répertoire , ce qui augmente les performances de compression en éliminant la nécessité de recompresser le contenu qui a déjà été compressé. Une fois qu’IIS 7 a compressé un fichier, les demandes suivantes reçoivent la copie compressée du fichier à partir du répertoire du cache.

Les attributs staticCompressionEnableCpuUsage et staticCompressionDisableCpuUsage spécifient quand IIS 7 compresse les fichiers statiques en fonction de l’utilisation du processeur.

Vous devez utiliser la compression statique avec des fichiers qui ne changent généralement pas, tels que les fichiers HTML (*.html, *.htm), les fichiers texte (*.txt), les documents Microsoft Office (*.doc, *.xls, *.ppt), etc. La taille de ces fichiers peut être réduite par compression, ce qui réduit les temps de téléchargement pour les demandes des clients et réduit la bande passante sur le serveur.

Notes

Les fichiers image tels que les fichiers *.jpg et *.png sont également des fichiers statiques, mais ils ne bénéficient généralement pas de la compression HTTP, car ces fichiers image sont déjà compressés.
Compression dynamique :

Contrairement à la compression statique, IIS 7 effectue une compression dynamique chaque fois qu’un client demande le contenu, mais la version compressée n’est pas mise en cache sur le disque. Cette modification est apportée en raison de la principale différence entre le contenu statique et le contenu dynamique. Le contenu statique ne change pas. Toutefois, le contenu dynamique est généralement un contenu créé par une application et qui change donc souvent, comme asp (Active Server Pages) ou ASP.NET contenu. Étant donné que le contenu dynamique doit changer souvent, IIS 7 ne le met pas en cache.

Les attributs dynamicCompressionEnableCpuUsage et dynamicCompressionDisableCpuUsage spécifient quand IIS 7 compresse les fichiers dynamiques en fonction de l’utilisation du processeur.

IIS 7 prend en charge deux schémas de compression standard différents :

Dégonfler : cette forme de compression est documentée dans la spécification RFC (Requests For Comment) 1951.
GZIP (GNU zip) : cette forme de compression est documentée dans la spécification RFC (Requests For Comment) 1952.

Chacun de ces deux schémas de compression peut être activé à l’aide de l’élément <schemes> de l’élément <httpCompression> .

Notes

Alors que l’élément <httpCompression> spécifie les paramètres de compression HTTP pour Internet Information Services (IIS) 7, l’élément urlCompression> spécifie si la< compression est activée pour un espace de noms d’URL.

Compatibilité

Version	Notes
IIS 10.0	L’élément `<httpCompression>` n’a pas été modifié dans IIS 10.0.
IIS 8,5	L’attribut `staticCompressionIgnoreHitFrequency` a été ajouté dans IIS 8.5.
IIS 8,0	L’élément `<httpCompression>` n’a pas été modifié dans IIS 8.0.
IIS 7,5	Dans IIS 7.5, la valeur par défaut de l’attribut `minFileSizeForComp` a été modifiée et l’attribut `dynamicCompressionBufferLimit` a été ajouté.
IIS 7.0	L’élément `<httpCompression>` a été introduit dans IIS 7.0.
IIS 6.0	L’élément `<httpCompression>` remplace les propriétés de métabase IIS 6.0 suivantes : HcCacheControlHeader HcCompressionDirectory HcDoDiskSpaceLimiting HcExpiresHeader HcMaxDiskSpaceUsage HcMinFileSizeForComp HcNoCompressionForHttp10 HcNoCompressionForProxies HcNoCompressionForRange HcSendCacheHeaders

Programme d’installation

La compression HTTP est généralement disponible sur l’installation par défaut d’IIS 7 et versions ultérieures. Toutefois, seule la compression statique est installée par défaut. Pour installer la compression statique ou dynamique, procédez comme suit.

Windows Server 2012 ou Windows Server 2012 R2

Dans la barre des tâches, cliquez sur Gestionnaire de serveur.
Dans Gestionnaire de serveur, cliquez sur le menu Gérer, puis sur Ajouter des rôles et des fonctionnalités.
Dans l’Assistant Ajout de rôles et de fonctionnalités , cliquez sur Suivant. Sélectionnez le type d’installation, puis cliquez sur Suivant. Sélectionnez le serveur de destination, puis cliquez sur Suivant.
Dans la page Rôles de serveur , développez Serveur web (IIS),Serveur web, Performances, puis sélectionnez Compression de contenu statique et/ou Compression de contenu dynamique. Cliquez sur Suivant.
.
Dans la page Sélectionner les composants, cliquez sur Suivant.
Dans la page Confirmer les sélections d’installation, cliquez sur Installer.
Dans la page Résultats, cliquez sur Fermer.

Windows 8 ou Windows 8.1

Dans l’écran d’accueil, déplacez le pointeur dans le coin inférieur gauche, cliquez avec le bouton droit sur le bouton Démarrer, puis cliquez sur Panneau de configuration.
Dans Panneau de configuration, cliquez sur Programmes et fonctionnalités, puis sur Activer ou désactiver les fonctionnalités Windows.
Développez Internet Information Services, World Wide Web Services, Performance Features, puis sélectionnez Compression de contenu dynamique et/ou Compression de contenu statique.
Cliquez sur OK.
Cliquez sur Fermer.

Windows Server 2008 ou Windows Server 2008 R2

Dans la barre des tâches, cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Gestionnaire de serveur.
Dans le volet hiérarchie Gestionnaire de serveur, développez Rôles, puis cliquez sur Serveur web (IIS).
Dans le volet Serveur web (IIS), faites défiler jusqu’à la section Services de rôle , puis cliquez sur Ajouter des services de rôle.
Dans la page Sélectionner des services de rôle de l’Assistant Ajout de services de rôle, sélectionnez Compression de contenudynamique si vous souhaitez installer la compression dynamique et Compression de contenu statique si vous souhaitez installer la compression statique, puis cliquez sur Suivant.
Dans la page Confirmer les sélections pour l'installation, cliquez sur Installer.
Dans la page Résultats, cliquez sur Fermer.

Windows Vista ou Windows 7

Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
Dans Panneau de configuration, cliquez sur Programmes et fonctionnalités, puis sur Activer ou désactiver les fonctionnalités Windows.
Développez Internet Information Services, puis World Wide Web Services, puis Fonctionnalités de performances.
Sélectionnez Compression http dynamique si vous souhaitez installer la compression dynamique et Compression de contenu statique si vous souhaitez installer la compression statique.
Cliquez sur OK.

Procédure

Comment activer ou désactiver la compression statique et dynamique pour un site ou une application

Ouvrez le Gestionnaire des services Internet (IIS) :
- Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :
  - Dans la barre des tâches, cliquez sur Gestionnaire de serveur, sur Outils, puis sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows 8 ou Windows 8.1 :
  - Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
  - Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :
  - Dans la barre des tâches, cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows Vista ou Windows 7 :
  - Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
  - Double-cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).
Dans le volet Connexions , accédez à la connexion, au site, à l’application ou au répertoire pour lequel vous souhaitez activer la compression.
Dans le volet Accueil , double-cliquez sur Compression.
Dans le volet Compression, case activée les zones pour activer la compression statique ou dynamique, ou supprimez les marques de case activée pour désactiver la compression statique ou dynamique.
Une fois que vous avez effectué les étapes ci-dessus, cliquez sur Appliquer dans le volet Actions .

Comment activer ou désactiver la compression statique et dynamique pour un serveur

Ouvrez le Gestionnaire des services Internet (IIS) :
- Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :
  - Dans la barre des tâches, cliquez sur Gestionnaire de serveur, sur Outils, puis sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows 8 ou Windows 8.1 :
  - Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
  - Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :
  - Dans la barre des tâches, cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows Vista ou Windows 7 :
  - Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
  - Double-cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).
Dans le volet Connexions , mettez en surbrillance le nom de votre serveur.
Dans le volet Accueil du serveur, double-cliquez sur Compression.
Dans le volet Compression, case activée les zones pour activer la compression statique ou dynamique, ou supprimez les marques de case activée pour désactiver la compression statique ou dynamique.
Une fois que vous avez effectué les étapes ci-dessus, cliquez sur Appliquer dans le volet Actions .

Comment configurer staticCompressionIgnoreHitFrequency

Ouvrez le Gestionnaire des services Internet (IIS) :
- Si vous utilisez Windows Server 2012 R2 :
  - Dans la barre des tâches, cliquez sur Gestionnaire de serveur, sur Outils, puis sur Gestionnaire des services Internet (IIS).
- Si vous utilisez Windows 8.1 :
  - Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
  - Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).
Dans le volet Connexions , sélectionnez le serveur, puis double-cliquez sur Éditeur de configuration.
Dans l’Éditeur de configuration, pour la section , sélectionnez system.webServer, puis httpCompression.
Pour staticCompressionIgnoreHitFrequency, entrez True pour désactiver le comportement de compression d’un fichier statique uniquement s’il est atteint un certain nombre de fois au cours d’une période donnée, ou entrez False pour activer le comportement.
Dans le volet Actions, cliquez sur Appliquer.

Configuration

Attributs

Attribut	Description
`cacheControlHeader`	Attribut de chaîne facultatif. Spécifie la directive qu’IIS ajoute à l’en-tête Cache-Control qui remplace l’en-tête HTTP Expire. Cet attribut garantit que les anciens clients et serveurs proxy ne tentent pas de mettre en cache les fichiers compressés. Pour activer ce paramètre, vous devez définir l’attribut sendCacheHeaders sur true. Le service WWW doit être redémarré avant que les modifications apportées à cette propriété prennent effet. La valeur par défaut est `max-age=86400`.
`directory`	Attribut de chaîne facultatif. Spécifie le répertoire dans lequel les versions compressées des fichiers statiques sont temporairement stockées et mises en cache. Note: Dans IIS 6.0, le chemin du répertoire par défaut pour les fichiers compressés temporaires IIS était %windir%\IIS Temporary Compressed Files. La valeur par défaut est `%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files`.
`doDiskSpaceLimiting`	Attribut booléen facultatif. Spécifie si une limite existe pour la quantité d’espace disque que tous les fichiers compressés, qui sont stockés dans le répertoire de compression spécifié par l’attribut de répertoire, peuvent occuper. La valeur par défaut est `true`.
`dynamicCompressionBufferLimit`	Attribut uint facultatif. Spécifie la quantité maximale de données compressées dynamiquement qu’IIS mettra en mémoire tampon avant de vider la mémoire tampon sur un client. Cela réduit la quantité de mémoire nécessaire pour effectuer une compression dynamique. Note: Cet attribut a été ajouté dans IIS 7.5. La valeur par défaut est `65536`.
`dynamicCompressionDisableCpuUsage`	Attribut uint facultatif. Spécifie le pourcentage d’utilisation du processeur auquel la compression dynamique sera désactivée. Note: Cet attribut agit comme une limite de processeur supérieure à laquelle la compression dynamique est désactivée. Lorsque l’utilisation du processeur est inférieure à la valeur spécifiée dans l’attribut dynamicCompressionEnableCpuUsage , la compression dynamique est réactivée. La valeur par défaut est `90`.
`dynamicCompressionEnableCpuUsage`	Attribut uint facultatif. Spécifie le pourcentage d’utilisation du processeur sous lequel la compression dynamique sera activée. La valeur doit être comprise entre 0 et 100. L’utilisation moyenne du processeur est calculée toutes les 30 secondes. Note: Cet attribut agit comme une limite de processeur inférieure à laquelle la compression dynamique est activée. Lorsque l’utilisation du processeur dépasse la valeur spécifiée dans l’attribut dynamicCompressionDisableCpuUsage , la compression dynamique est désactivée. La valeur par défaut est `50`.
`expiresHeader`	Attribut de chaîne facultatif. Spécifie le contenu de l’en-tête HTTP Expires qui est envoyé avec tous les fichiers compressés demandés, ainsi que l’en-tête Cache-Control spécifié dans l’attribut cacheControlHeader . Cette combinaison d’en-têtes garantit que les anciens clients et serveurs proxy n’essaient pas de mettre en cache les fichiers compressés. Pour activer ce paramètre, vous devez définir l’attribut sendCacheHeaders sur true. Le service de publication World Wide Web (service WWW) doit être redémarré avant que les modifications apportées à cette propriété prennent effet. La valeur par défaut est `Wed, 01 Jan 1997 12:00:00 GMT`.
`maxDiskSpaceUsage`	Attribut uint facultatif. Spécifie le nombre de mégaoctets d’espace disque que les fichiers compressés peuvent occuper dans le répertoire de compression. Lorsque l’espace utilisé par les fichiers compressés dépasse 90 % de la valeur de cet attribut, IIS supprime les fichiers les moins récemment utilisés jusqu’à ce qu’un niveau d’utilisation de 90 % soit atteint. Note: Dans IIS 6.0, cette limite était exprimée en octets ; dans IIS 7, elle est exprimée en mégaoctets. Dans IIS 7, la limite est appliquée par pool d’applications. La valeur par défaut est `100`.
`minFileSizeForComp`	Attribut uint facultatif. Spécifie le nombre minimal de kilo-octets qu’un fichier doit contenir pour pouvoir utiliser la compression à la demande. La valeur par défaut pour IIS 7.5 est `2700`; pour IIS 7.0, la valeur par défaut est `256`.
`noCompressionForHttp10`	Attribut booléen facultatif. Spécifie si la compression est désactivée pour les requêtes qui contiennent un numéro de version HTTP 1.0. Note: Certains clients HTTP 1.0 ne gèrent pas correctement la mise en cache des objets compressés. Vous pouvez utiliser ce paramètre pour éviter de renvoyer un fichier compressé à un client qui ne peut pas le décompresser. La valeur par défaut est `true`.
`noCompressionForProxies`	Attribut booléen facultatif. Spécifie si la réponse HTTP 1.1 est désactivée pour les demandes de compression qui transitent par des serveurs proxy. Note: Certains serveurs proxy HTTP ne gèrent pas correctement la mise en cache des objets compressés. Vous pouvez utiliser ce paramètre pour éviter de renvoyer un fichier compressé à un serveur proxy qui ne peut pas le décompresser. La valeur par défaut est `true`.
`noCompressionForRange`	Attribut booléen facultatif. Spécifie si la compression est désactivée pour les requêtes HTTP qui incluent l’en-tête Range. Note: Certains clients ne peuvent pas gérer correctement les demandes de plage. Vous pouvez utiliser ce paramètre pour éviter de renvoyer un fichier compressé à un client qui ne peut pas le décompresser. La valeur par défaut est `true`.
`sendCacheHeaders`	Attribut booléen facultatif. Spécifie si les en-têtes configurés dans cacheControlHeader et expirentHeader sont envoyés avec chaque réponse compressée. La valeur par défaut est `false`.
`staticCompressionDisableCpuUsage`	Attribut uint facultatif. Spécifie le pourcentage d’utilisation du processeur auquel la compression statique est désactivée. La valeur doit être comprise entre 0 et 100. L’utilisation moyenne du processeur est calculée toutes les 30 secondes. Note: Cette propriété agit comme une limite d’UC supérieure à laquelle la compression statique est désactivée. Lorsque l’utilisation du processeur est inférieure à la valeur spécifiée dans l’attribut staticCompressionEnableCpuUsage , la compression statique est réactivée. La valeur par défaut est `100`.
`staticCompressionEnableCpuUsage`	Attribut uint facultatif. Spécifie le pourcentage d’utilisation du processeur auquel la compression statique est activée. La valeur doit être comprise entre 0 et 100. L’utilisation moyenne du processeur est calculée toutes les 30 secondes. Note: Cette propriété agit comme une limite inférieure au processeur en dessous de laquelle la compression statique est activée. Lorsque l’utilisation du processeur dépasse la valeur spécifiée dans l’attribut staticCompressionDisableCpuUsage , la compression statique est désactivée. La valeur par défaut est `50`.
`staticCompressionIgnoreHitFrequency`	Attribut booléen facultatif. Si la valeur est True, désactive le comportement selon lequel un fichier statique est compressé uniquement s’il est atteint un certain nombre de fois au cours d’une période donnée. Vous pouvez rencontrer des circonstances dans lesquelles vous souhaitez que le contenu statique soit toujours compressé pour réduire l’utilisation de la bande passante. Par exemple, vous pouvez toujours compresser le contenu statique lorsqu’un système utilise un équilibreur de charge avec mise en cache edge entre un serveur Web et le demandeur, ce qui entraîne la mise en cache d’un fichier non compressé sur le serveur edge, car les demandes suivantes n’atteignent pas le serveur web. Si le comportement n’est pas désactivé, un taux d’accès supérieur ou égal à deux accès en 10 secondes entraîne la compression du contenu statique. Avec un taux d’accès inférieur, le contenu n’est pas compressé. La valeur par défaut est `False`.

Éléments enfants

Élément	Description
`scheme`	Élément facultatif. Spécifie le schéma de compression (Gzip ou Deflate) qu’IIS utilise pour compresser les demandes des clients.
`dynamicTypes`	Élément facultatif. Spécifie les paramètres de configuration pour la compression dynamique.
`staticTypes`	Élément facultatif. Spécifie les paramètres de configuration pour la compression statique.

Exemple Configuration

L’élément par défaut <httpCompression> suivant est configuré dans le fichier ApplicationHost.config dans IIS 7. Cette section de configuration hérite des paramètres de configuration par défaut, sauf si vous utilisez l’élément <clear> .

<httpCompression
      directory="%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files">
   <scheme name="gzip" dll="%Windir%\system32\inetsrv\gzip.dll" />
   <dynamicTypes>
      <add mimeType="text/*" enabled="true" />
      <add mimeType="message/*" enabled="true" />
      <add mimeType="application/javascript" enabled="true" />
      <add mimeType="*/*" enabled="false" />
   </dynamicTypes>
   <staticTypes>
      <add mimeType="text/*" enabled="true" />
      <add mimeType="message/*" enabled="true" />
      <add mimeType="application/javascript" enabled="true" />
      <add mimeType="*/*" enabled="false" />
   </staticTypes>
</httpCompression>

Exemple de code

Les exemples de code suivants ajoutent les types MIME pour les documents Office 2003 à la liste des types de compression dynamique.

Notes

Les documents Office 2007 utilisent la compression intégrée, de sorte qu’ils n’ont pas besoin d’être compressés par IIS.

AppCmd.exe

appcmd.exe set config -section:system.webServer/httpCompression /+"dynamicTypes.[mimeType='application/msword',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"dynamicTypes.[mimeType='application/vnd.ms-powerpoint',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"dynamicTypes.[mimeType='application/vnd.ms-excel',enabled='True']" /commit:apphost

Notes

Vous devez veiller à définir le paramètre commitapphost sur lorsque vous utilisez AppCmd.exe pour configurer ces paramètres. Cela valide les paramètres de configuration dans la section d’emplacement appropriée dans le fichier ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection httpCompressionSection = config.GetSection("system.webServer/httpCompression");
         ConfigurationElementCollection dynamicTypesCollection = httpCompressionSection.GetCollection("dynamicTypes");

         ConfigurationElement addElement = dynamicTypesCollection.CreateElement("add");
         addElement["mimeType"] = @"application/msword";
         addElement["enabled"] = true;
         dynamicTypesCollection.Add(addElement);

         ConfigurationElement addElement1 = dynamicTypesCollection.CreateElement("add");
         addElement1["mimeType"] = @"application/vnd.ms-powerpoint";
         addElement1["enabled"] = true;
         dynamicTypesCollection.Add(addElement1);

         ConfigurationElement addElement2 = dynamicTypesCollection.CreateElement("add");
         addElement2["mimeType"] = @"application/vnd.ms-excel";
         addElement2["enabled"] = true;
         dynamicTypesCollection.Add(addElement2);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim httpCompressionSection As ConfigurationSection = config.GetSection("system.webServer/httpCompression")
      Dim dynamicTypesCollection As ConfigurationElementCollection = httpCompressionSection.GetCollection("dynamicTypes")

      Dim addElement As ConfigurationElement = dynamicTypesCollection.CreateElement("add")
      addElement("mimeType") = "application/msword"
      addElement("enabled") = True
      dynamicTypesCollection.Add(addElement)

      Dim addElement1 As ConfigurationElement = dynamicTypesCollection.CreateElement("add")
      addElement1("mimeType") = "application/vnd.ms-powerpoint"
      addElement1("enabled") = True
      dynamicTypesCollection.Add(addElement1)

      Dim addElement2 As ConfigurationElement = dynamicTypesCollection.CreateElement("add")
      addElement2("mimeType") = "application/vnd.ms-excel"
      addElement2("enabled") = True
      dynamicTypesCollection.Add(addElement2)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST");
var dynamicTypesCollection = httpCompressionSection.ChildElements.Item("dynamicTypes").Collection;

var addElement = dynamicTypesCollection.CreateNewElement("add");
addElement.Properties.Item("mimeType").Value = "application/msword";
addElement.Properties.Item("enabled").Value = true;
dynamicTypesCollection.AddElement(addElement);

var addElement1 = dynamicTypesCollection.CreateNewElement("add");
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint";
addElement1.Properties.Item("enabled").Value = true;
dynamicTypesCollection.AddElement(addElement1);

var addElement2 = dynamicTypesCollection.CreateNewElement("add");
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel";
addElement2.Properties.Item("enabled").Value = true;
dynamicTypesCollection.AddElement(addElement2);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST")
Set dynamicTypesCollection = httpCompressionSection.ChildElements.Item("dynamicTypes").Collection

Set addElement = dynamicTypesCollection.CreateNewElement("add")
addElement.Properties.Item("mimeType").Value = "application/msword"
addElement.Properties.Item("enabled").Value = True
dynamicTypesCollection.AddElement(addElement)

Set addElement1 = dynamicTypesCollection.CreateNewElement("add")
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint"
addElement1.Properties.Item("enabled").Value = True
dynamicTypesCollection.AddElement(addElement1)

Set addElement2 = dynamicTypesCollection.CreateNewElement("add")
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel"
addElement2.Properties.Item("enabled").Value = True
dynamicTypesCollection.AddElement(addElement2)

adminManager.CommitChanges()

Les exemples de code suivants ajoutent les types MIME pour les documents Office 2003 à la liste des types de compression statique.

(> [! REMARQUE]

Les documents Office 2007 utilisent la compression intégrée, de sorte qu’ils n’ont pas besoin d’être compressés par IIS.)

AppCmd.exe

appcmd.exe set config -section:system.webServer/httpCompression /+"staticTypes.[mimeType='application/msword',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"staticTypes.[mimeType='application/vnd.ms-powerpoint',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"staticTypes.[mimeType='application/vnd.ms-excel',enabled='True']" /commit:apphost

Notes

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection httpCompressionSection = config.GetSection("system.webServer/httpCompression");
         ConfigurationElementCollection staticTypesCollection = httpCompressionSection.GetCollection("staticTypes");

         ConfigurationElement addElement = staticTypesCollection.CreateElement("add");
         addElement["mimeType"] = @"application/msword";
         addElement["enabled"] = true;
         staticTypesCollection.Add(addElement);

         ConfigurationElement addElement1 = staticTypesCollection.CreateElement("add");
         addElement1["mimeType"] = @"application/vnd.ms-powerpoint";
         addElement1["enabled"] = true;
         staticTypesCollection.Add(addElement1);

         ConfigurationElement addElement2 = staticTypesCollection.CreateElement("add");
         addElement2["mimeType"] = @"application/vnd.ms-excel";
         addElement2["enabled"] = true;
         staticTypesCollection.Add(addElement2);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim httpCompressionSection As ConfigurationSection = config.GetSection("system.webServer/httpCompression")
      Dim staticTypesCollection As ConfigurationElementCollection = httpCompressionSection.GetCollection("staticTypes")

      Dim addElement As ConfigurationElement = staticTypesCollection.CreateElement("add")
      addElement("mimeType") = "application/msword"
      addElement("enabled") = True
      staticTypesCollection.Add(addElement)

      Dim addElement1 As ConfigurationElement = staticTypesCollection.CreateElement("add")
      addElement1("mimeType") = "application/vnd.ms-powerpoint"
      addElement1("enabled") = True
      staticTypesCollection.Add(addElement1)

      Dim addElement2 As ConfigurationElement = staticTypesCollection.CreateElement("add")
      addElement2("mimeType") = "application/vnd.ms-excel"
      addElement2("enabled") = True
      staticTypesCollection.Add(addElement2)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST");
var staticTypesCollection = httpCompressionSection.ChildElements.Item("staticTypes").Collection;

var addElement = staticTypesCollection.CreateNewElement("add");
addElement.Properties.Item("mimeType").Value = "application/msword";
addElement.Properties.Item("enabled").Value = true;
staticTypesCollection.AddElement(addElement);

var addElement1 = staticTypesCollection.CreateNewElement("add");
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint";
addElement1.Properties.Item("enabled").Value = true;
staticTypesCollection.AddElement(addElement1);

var addElement2 = staticTypesCollection.CreateNewElement("add");
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel";
addElement2.Properties.Item("enabled").Value = true;
staticTypesCollection.AddElement(addElement2);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST")
Set staticTypesCollection = httpCompressionSection.ChildElements.Item("staticTypes").Collection

Set addElement = staticTypesCollection.CreateNewElement("add")
addElement.Properties.Item("mimeType").Value = "application/msword"
addElement.Properties.Item("enabled").Value = True
staticTypesCollection.AddElement(addElement)

Set addElement1 = staticTypesCollection.CreateNewElement("add")
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint"
addElement1.Properties.Item("enabled").Value = True
staticTypesCollection.AddElement(addElement1)

Set addElement2 = staticTypesCollection.CreateNewElement("add")
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel"
addElement2.Properties.Item("enabled").Value = True
staticTypesCollection.AddElement(addElement2)

adminManager.CommitChanges()

Compression <HTTP httpCompression>

Vue d’ensemble

Compatibilité

Programme d’installation

Windows Server 2012 ou Windows Server 2012 R2

Windows 8 ou Windows 8.1

Windows Server 2008 ou Windows Server 2008 R2

Windows Vista ou Windows 7

Procédure

Comment activer ou désactiver la compression statique et dynamique pour un site ou une application

Comment activer ou désactiver la compression statique et dynamique pour un serveur

Comment configurer staticCompressionIgnoreHitFrequency

Configuration

Attributs

Éléments enfants

Exemple Configuration

Exemple de code

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Ressources supplémentaires

Ressources supplémentaires