Partager via

Classe HttpCompressionSection

  • Article

Configure la compression HTTP.

Syntaxe

class HttpCompressionSection : ConfigurationSectionWithCollection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe HttpCompressionSection.

Nom Description
Ajouter (Hérité de ConfigurationSectionWithCollection.)
Clear (Hérité de ConfigurationSectionWithCollection.)
Get (Hérité de ConfigurationSectionWithCollection.)
GetAllowDefinition (Hérité de ConfigurationSection.)
GetAllowLocation (Hérité de ConfigurationSection.)
Remove (Hérité de ConfigurationSectionWithCollection.)
RevertToParent (Hérité de ConfigurationSection.)
SetAllowDefinition (Hérité de ConfigurationSection.)
SetAllowLocation (Hérité de ConfigurationSection.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe HttpCompressionSection.

Nom Description
CacheControlHeader Une valeur en lecture/écriture string qui spécifie l’en-tête Cache-Control envoyé avec des fichiers compressés. La valeur par défaut est « max-age=86400 ». Pour activer ce paramètre, vous devez définir la propriété SendCacheHeaders sur true. Vous devez également redémarrer le service de publication World Wide Web (service WWW) avant que toute modification de la propriété CacheControlHeader ne prenne effet. Remarque : l’en-tête Cache-Control est envoyé avec l’en-tête HTTP Expires spécifié dans la propriété ExpiresHeader. Cette combinaison d’en-têtes garantit que les anciens clients et les serveurs proxy n’essaient pas de mettre en cache les fichiers compressés.
Directory Une valeur en lecture/écriture string qui spécifie le répertoire dans lequel les versions compressées de fichiers statiques sont temporairement stockées et mises en cache. La valeur par défaut est « %SystemDrive%\inetpub\temp\IIS Temporary Compressed Files ». IIS 7 crée un sous-dossier dans ce dossier pour chaque pool d’applications et un sous-dossier dans chaque dossier de pool d’applications pour chaque schéma de compression. Remarque : le chemin d’accès au répertoire par défaut pour les fichiers compressés temporaires IIS dans IIS 6.0 était %Windir%\\IIS Temporary Compressed Files, et une structure de répertoires plats était utilisée.
DoDiskSpaceLimiting Une valeur boolean en lecture/écriture. true si une limite existe pour la quantité d’espace disque que les fichiers compressés dans le dossier fichiers compressés peuvent occuper ; sinon, false. Par défaut, il s’agit de true. Le dossier de fichiers compressés est spécifié par la propriété Directory.
DynamicCompressionDisableCpuUsage Une valeur de lecture/écriture uint32 qui spécifie le pourcentage d’utilisation du processeur à laquelle la compression dynamique sera désactivée. La valeur par défaut est 90. La valeur doit être comprise entre 0 et 100. L’utilisation moyenne du processeur est calculée toutes les 30 secondes. Remarque : cette propriété agit comme une limite supérieure de processeur à laquelle la compression dynamique est désactivée. Lorsque l’utilisation du processeur est inférieure à la valeur spécifiée dans la propriété DynamicCompressionEnableCpuUsage, la compression dynamique est réactivée.
DynamicCompressionEnableCpuUsage Une valeur en lecture/écriture uint32 qui spécifie le pourcentage d’utilisation du processeur sous laquelle la compression dynamique sera activée. La valeur par défaut est 50. La valeur doit être comprise entre 0 et 100. L’utilisation moyenne du processeur est calculée toutes les 30 secondes. Remarque : cette propriété agit comme une limite inférieure de processeur à laquelle la compression dynamique est activée. Lorsque l’utilisation du processeur augmente au-dessus de la valeur spécifiée dans la propriété DynamicCompressionDisableCpuUsage, la compression dynamique est désactivée.
DynamicTypes Une valeur DynamicTypeSettings qui contient des extensions de nom de fichier que IIS peut servir avec la compression dynamique.
ExpiresHeader Une valeur en lecture/écriture string qui spécifie le contenu de l’en-tête HTTP Expires envoyé avec des fichiers compressés. La valeur par défaut est « Wed, 01 Jan 1997 12:00:00 GMT ». Pour activer ce paramètre, vous devez définir la propriété SendCacheHeaders sur true. Vous devez également redémarrer le service WWW pour que les modifications apportées à la propriété ExpiresHeader prennent effet. Remarque : l’en-tête HTTP Expires est envoyé avec l’en-tête Cache-Control spécifié dans la propriété CacheControlHeader. Cette combinaison d’en-têtes garantit que les anciens clients et les serveurs proxy n’essaient pas de mettre en cache les fichiers compressés.
HttpCompression Un tableau de valeurs HttpCompressionSchemeElement qui spécifient les schémas de compression (Gzip ou Deflate) que IIS utilise pour compresser les requêtes clientes.
Location (Hérité de ConfigurationSection.) Une propriété clé.
MaxDiskSpaceUsage Une valeur de lecture/écriture uint32 qui spécifie une limite d’espace disque, en mégaoctets, que les fichiers compressés peuvent occuper dans le répertoire de compression. La valeur par défaut est 100. Lorsque l’espace utilisé par les fichiers compressés dépasse 90 % de la valeur dans MaxDiskSpaceUsage, IIS supprime les fichiers les moins récemment utilisés jusqu’à ce qu’un niveau d’utilisation de 90 % soit atteint. Remarque : dans IIS 6.0, cette limite est 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.
MinFileSizeForComp Une valeur en lecture/écriture uint32 qui spécifie la taille minimale du fichier, en kilo-octets, pour qu’un fichier soit compressé. La valeur par défaut est 256.
NoCompressionForHttp10 Une valeur boolean en lecture/écriture. true si la compression est désactivée pour les requêtes qui contiennent un numéro de version HTTP 1.0 ; sinon, false. Par défaut, il s’agit de true. Remarque : 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.
NoCompressionForProxies Une valeur boolean en lecture/écriture. true si la compression est désactivée pour les requêtes HTTP 1.1 qui transitent par un serveur proxy ; sinon, false. La valeur par défaut est true. Remarque : 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.
NoCompressionForRange Une valeur boolean en lecture/écriture. true si la compression est désactivée pour les requêtes HTTP qui incluent l’en-tête Range ; sinon, false. Par défaut, il s’agit de true. Remarque : 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.
Path (Hérité de ConfigurationSection.) Une propriété clé.
SectionInformation (Hérité de ConfigurationSection.)
SendCacheHeaders Une valeur boolean en lecture/écriture. true si les en-têtes configurés dans les propriétés CacheControlHeader et ExpiresHeader sont envoyés avec des réponses compressées ; sinon, false. Par défaut, il s’agit de false.
StaticCompressionDisableCpuUsage Une valeur en lecture/écriture uint32 qui spécifie le pourcentage d’utilisation du processeur auquel la compression statique est désactivée. La valeur par défaut est 100. La valeur doit être comprise entre 0 et 100. L’utilisation moyenne du processeur est calculée toutes les 30 secondes. Remarque : cette propriété agit comme une limite de processeur supérieure à laquelle la compression statique est désactivée. Lorsque l’utilisation du processeur est inférieure à la valeur spécifiée dans la propriété StaticCompressionEnableCpuUsage, la compression statique est réactivée.
StaticCompressionEnableCpuUsage Une valeur en lecture/écriture uint32 qui spécifie le pourcentage d’utilisation du processeur auquel la compression statique est activée. La valeur par défaut est 50. La valeur doit être comprise entre 0 et 100. L’utilisation moyenne du processeur est calculée toutes les 30 secondes. Remarque : cette propriété agit comme une limite de processeur inférieure sous laquelle la compression statique est activée. Lorsque l’utilisation du processeur augmente au-dessus de la valeur spécifiée dans la propriété StaticCompressionDisableCpuUsage, la compression statique est désactivée.
StaticTypes Une valeur StaticTypeSettings qui contient des extensions de nom de fichier que IIS peut servir avec la compression statique.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

La compression statique est activée par défaut dans IIS 7. Les propriétés StaticCompressionEnableCpuUsage, StaticCompressionDisableCpuUsage, DynamicCompressionEnableCpuUsage et DynamicCompressionDisableCpuUsage ont été ajoutées pour activer ou désactiver la compression à la volée en fonction de la charge du processeur.

Les propriétés de compression suivantes d’IIS 6.0 ne sont plus présentes dans IIS 7 :

  • [HcCompressionBufferSize]()

  • HcCreateFlags

  • HcDoOnDemandCompression

  • HcFileExtensions

  • HcFilesDeletedPerDiskFree

  • HcIoBufferSize

  • HcMaxQueueLength

  • HcPriority

  • HcScriptFileExtensions

Exemple

L’exemple suivant affiche les propriétés de la classe HttpCompressionSection qui ne sont pas des tableaux et énumère les propriétés des tableaux de compression statiques et dynamiques.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the HTTP compression section.  
Set oSection = oWebAdmin.Get( _  
    "HttpCompressionSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the properties that are not collections.  
WScript.Echo "HttpCompressionSection properties"  
WScript.Echo "---------------------------------"  
WScript.Echo "Directory: " & oSection.Directory  
WScript.Echo "DoDiskSpaceLimiting: " & _  
    oSection.DoDiskSpaceLimiting  
WScript.Echo "DynamicCompressionDisableCpuUsage: " & _  
    oSection.DynamicCompressionDisableCpuUsage  
WScript.Echo "DynamicCompressionEnableCpuUsage: " & _  
    oSection.DynamicCompressionEnableCpuUsage  
WScript.Echo "ExpiresHeader: " & oSection.ExpiresHeader  
WScript.Echo "MaxDiskSpaceUsage: " & _  
    oSection.MaxDiskSpaceUsage  
WScript.Echo "MinFileSizeForComp: " & _  
    oSection.MinFileSizeForComp  
WScript.Echo "NoCompressionForProxies: " & _  
    oSection.NoCompressionForProxies  
WScript.Echo "NoCompressionForRange: " & _  
    oSection.NoCompressionForRange  
WScript.Echo "SendCacheHeaders: " & _  
    oSection.SendCacheHeaders  
WScript.Echo "StaticCompressionDisableCpuUsage: " & _  
    oSection.StaticCompressionDisableCpuUsage  
WScript.Echo "StaticCompressionEnableCpuUsage: " & _  
    oSection.StaticCompressionEnableCpuUsage  
WScript.Echo  
  
' Display the static compression types.  
WScript.Echo _  
    "HttpCompressionSection.StaticTypes.StaticTypes"  
WScript.Echo _  
    "----------------------------------------------"  
For Each oType In oSection.StaticTypes.StaticTypes  
    WScript.Echo "MimeType: " & oType.MimeType  
    WScript.Echo "Enabled: " & oType.Enabled  
    WScript.Echo  
Next  
WScript.Echo  
  
' Display the dynamic compression types.  
WScript.Echo _  
    "HttpCompressionSection.DynamicTypes.DynamicTypes"  
WScript.Echo _  
    "------------------------------------------------"  
For Each oType In oSection.DynamicTypes.DynamicTypes  
    WScript.Echo "MimeType: " & oType.MimeType  
    WScript.Echo "Enabled: " & oType.Enabled  
    WScript.Echo  
Next  
  
' Display the compression scheme elements.  
WScript.Echo "HttpCompressionSection.HttpCompression"  
WScript.Echo "-----------------------------------"  
For Each oScheme In oSection.HttpCompression  
    WScript.Echo "Name: " & oScheme.Name  
    WScript.Echo "Dll: " & oScheme.Dll  
    WScript.Echo "DoStaticCompression: " & _  
        oScheme.DoStaticCompression  
    WScript.Echo "StaticCompressionLevel: " & _  
        oScheme.StaticCompressionLevel  
    WScript.Echo "DoDynamicCompression: " & _  
        oScheme.DoDynamicCompression  
    WScript.Echo "DynamicCompressionLevel: " & _  
        oScheme.DynamicCompressionLevel  
    WScript.Echo  
Next

Hiérarchie d'héritage

ConfigurationSection

ConfigurationSectionWithCollection

HttpCompressionSection

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sur Windows 8
- IIS 10.0 sous Windows 10
Serveur - IIS 7.0 sur Windows Server 2008
- IIS 7.5 sur Windows Server 2008 R2
- IIS 8.0 sur Windows Server 2012
- IIS 8.5 sur Windows Server 2012 R2
- IIS 10.0 sous Windows Server 2016
Produit - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF WebAdministration.mof

Voir aussi

Classe ConfigurationSectionWithCollection
Classe DynamicTypeSettings
Classe HttpCompressionMimeTypeElement
Classe HttpCompressionSchemeElement
Classe StaticTypeSettings