HttpCompressionSection Class [IIS 7 and higher]

Article
07/13/2012

Configures HTTP compression.

Syntax

class HttpCompressionSection : ConfigurationSectionWithCollection

Methods

The following table lists the methods exposed by the HttpCompressionSection class.

Name	Description
Add	(Inherited from ConfigurationSectionWithCollection.)
Clear	(Inherited from ConfigurationSectionWithCollection.)
Get	(Inherited from ConfigurationSectionWithCollection.)
GetAllowDefinition	(Inherited from ConfigurationSection.)
GetAllowLocation	(Inherited from ConfigurationSection.)
Remove	(Inherited from ConfigurationSectionWithCollection.)
RevertToParent	(Inherited from ConfigurationSection.)
SetAllowDefinition	(Inherited from ConfigurationSection.)
SetAllowLocation	(Inherited from ConfigurationSection.)

Properties

The following table lists the properties exposed by the HttpCompressionSection class.

Name	Description
CacheControlHeader	A read/write string value that specifies the Cache-Control header that is sent with compressed files. The default is "max-age=86400". To enable this setting, you must set the SendCacheHeaders property to true. You must also restart the World Wide Web Publishing Service (WWW service) before changes to the CacheControlHeader property will take effect. Note: The Cache-Control header is sent with the HTTP Expires header that is specified in the ExpiresHeader property. This combination of headers ensures that older clients and proxy servers do not try to cache compressed files.
Directory	A read/write string value that specifies the directory where compressed versions of static files are temporarily stored and cached. The default is "%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files". IIS 7 creates a subfolder in this folder for each application pool, and a subfolder in each application pool folder for each compression scheme. Note: The default directory path for IIS temporary compressed files in IIS 6.0 was %Windir%\\IIS Temporary Compressed Files, and a flat directory structure was used.
DoDiskSpaceLimiting	A read/write boolean value. true if a limit exists for the amount of disk space that compressed files in the compressed files folder can occupy; otherwise, false. The default is true. The compressed files folder is specified by the Directory property.
DynamicCompressionDisableCpuUsage	A read/write uint32 value that specifies the percentage of CPU utilization at which dynamic compression will be disabled. The default is 90. The value must be between 0 and 100. Average CPU utilization is calculated every 30 seconds. Note: This property acts as an upper CPU limit at which dynamic compression is turned off. When CPU utilization falls below the value specified in the DynamicCompressionEnableCpuUsage property, dynamic compression will be reenabled.
DynamicCompressionEnableCpuUsage	A read/write uint32 value that specifies the percentage of CPU utilization below which dynamic compression will be enabled. The default is 50. The value must be between 0 and 100. Average CPU utilization is calculated every 30 seconds. Note: This property acts as a lower CPU limit below which dynamic compression is turned on. When CPU utilization rises above the value specified in the DynamicCompressionDisableCpuUsage property, dynamic compression will be disabled.
DynamicTypes	A DynamicTypeSettings value that contains file name extensions that IIS can serve with dynamic compression.
ExpiresHeader	A read/write string value that specifies the content of the HTTP Expires header that is sent with compressed files. The default is "Wed, 01 Jan 1997 12:00:00 GMT". To enable this setting, you must set the SendCacheHeaders property to true. You must also restart the WWW service before changes to the ExpiresHeader property will take effect. Note: The HTTP Expires header is sent with the Cache-Control header that is specified in the CacheControlHeader property. This combination of headers ensures that older clients and proxy servers do not try to cache compressed files.
HttpCompression	An array of HttpCompressionSchemeElement values that specify the compression schemes (Gzip or Deflate) that IIS uses to compress client requests.
Location	(Inherited from ConfigurationSection.) A key property.
MaxDiskSpaceUsage	A read/write uint32 value that specifies a limit of disk space, in megabytes, that compressed files can occupy in the compression directory. The default is 100. When the space used by compressed files exceeds 90 percent of the value in MaxDiskSpaceUsage, IIS deletes the least recently used files until a 90-percent usage level is reached. Note: In IIS 6.0, this limit is expressed in bytes; in IIS 7, it is expressed in megabytes. In IIS 7 the limit is applied per application pool.
MinFileSizeForComp	A read/write uint32 value that specifies the minimum file size, in kilobytes, for a file to be compressed. The default is 256.
NoCompressionForHttp10	A read/write boolean value. true if compression is disabled for requests that contain an HTTP 1.0 version number; otherwise, false. The default is true. Note: Some HTTP 1.0 clients do not handle the caching of compressed objects correctly. You can use this setting to avoid returning a compressed file to a client that cannot decompress it.
NoCompressionForProxies	A read/write boolean value. true if compression is disabled for HTTP 1.1 requests that come through a proxy server; otherwise, false. The default is true. Note: Some HTTP proxy servers do not handle the caching of compressed objects correctly. You can use this setting to avoid returning a compressed file to a proxy server that cannot decompress it.
NoCompressionForRange	A read/write boolean value. true if compression is disabled for HTTP requests that include the Range header; otherwise, false. The default is true. Note: Some clients cannot handle range requests correctly. You can use this setting to avoid returning a compressed file to a client that cannot decompress it.
Path	(Inherited from ConfigurationSection.) A key property.
SectionInformation	(Inherited from ConfigurationSection.)
SendCacheHeaders	A read/write boolean value. true if the headers configured in the CacheControlHeader and ExpiresHeader properties are sent with compressed responses; otherwise, false. The default is false.
StaticCompressionDisableCpuUsage	A read/write uint32 value that specifies the percentage of CPU utilization at which static compression is disabled. The default is 100. The value must be between 0 and 100. Average CPU utilization is calculated every 30 seconds. Note: This property acts as an upper CPU limit at which static compression is turned off. When CPU utilization falls below the value specified in the StaticCompressionEnableCpuUsage property, static compression will be reenabled.
StaticCompressionEnableCpuUsage	A read/write uint32 value that specifies the percentage of CPU utilization at which static compression is enabled. The default is 50. The value must be between 0 and 100. Average CPU utilization is calculated every 30 seconds. Note: This property acts as a lower CPU limit below which static compression is turned on. When CPU utilization rises above the value specified in the StaticCompressionDisableCpuUsage property, static compression will be disabled.
StaticTypes	A StaticTypeSettings value that contains file name extensions that IIS can serve with static compression.

Subclasses

This class contains no subclasses.

Remarks

Static compression is on by default in IIS 7. The StaticCompressionEnableCpuUsage, StaticCompressionDisableCpuUsage, DynamicCompressionEnableCpuUsage, and DynamicCompressionDisableCpuUsage properties have been added to enable or disable compression on the fly depending on CPU load.

The following compression properties from IIS 6.0 are no longer present in IIS 7:

[HcCompressionBufferSize]
HcCreateFlags
HcDoOnDemandCompression
HcFileExtensions
HcFilesDeletedPerDiskFree
HcIoBufferSize
HcMaxQueueLength
HcPriority
HcScriptFileExtensions

Example

The following example displays the non-array properties in the HttpCompressionSection class and lists the static and dynamic compression array properties.

' 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

Inheritance Hierarchy

ConfigurationSection

ConfigurationSectionWithCollection

HttpCompressionSection

Requirements

Type	Description
Client	Requires IIS 7 on Windows Vista.
Server	Requires IIS 7 on Windows Server 2008.
Product	IIS 7
MOF file	WebAdministration.mof