HttpCompressionSection-Klasse

Artikel
03/25/2024

Konfiguriert die HTTP-Komprimierung.

Syntax

class HttpCompressionSection : ConfigurationSectionWithCollection

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der HttpCompressionSection-Klasse verfügbar gemacht werden.

Name	Beschreibung
Add (Hinzufügen)	(Geerbt von ConfigurationSectionWithCollection.)
Clear	(Geerbt von `ConfigurationSectionWithCollection`.)
Get	(Geerbt von `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Geerbt von ConfigurationSection.)
GetAllowLocation	(Geerbt von `ConfigurationSection`.)
Remove	(Geerbt von `ConfigurationSectionWithCollection`.)
RevertToParent	(Geerbt von `ConfigurationSection`.)
SetAllowDefinition	(Geerbt von `ConfigurationSection`.)
SetAllowLocation	(Geerbt von `ConfigurationSection`.)

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der HttpCompressionSection Klasse verfügbar gemacht werden.

Name	Beschreibung
`CacheControlHeader`	Ein Lese-/Schreib`string`-Wert , der den `Cache-Control`Header, der mit komprimierten Dateien gesendet wird. Der Standardwert ist "max-age=86400". Um diese Einstellung zu aktivieren, müssen Sie die `SendCacheHeaders` Eigenschaft auf `true` festlegen. Sie müssen auch den World Wide Web Publishing Service (WWW-Dienst) neu starten, bevor Änderungen an der `CacheControlHeader` Eigenschaft wirksam werden. Hinweis: Der `Cache-Control` Header wird mit dem `HTTP Expires` Header gesendet, die in der `ExpiresHeader` Eigenschaft angegeben ist. Diese Kombination von Headern stellt sicher, dass ältere Clients und Proxyserver nicht versuchen, komprimierte Dateien zwischenzuspeichern.
`Directory`	Ein Lese-/Schreib`string`-Wert gibt das Verzeichnis an, in dem komprimierte Versionen der statischen Dateien vorübergehend gespeichert und zwischengespeichert werden. Der Fehler ist "%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files". IIS 7 erstellt einen Unterordner in diesem Ordner für jeden Anwendungspool und einen Unterordner in jedem Anwendungspoolordner für jedes Komprimierungsschema. Hinweis: Der Standardverzeichnispfad für temporäre komprimierte IIS-Dateien in IIS 6.0 lautete "%Windir%\\IIS Temporary Compressed Files", und es wurde eine flache Verzeichnisstruktur verwendet.
`DoDiskSpaceLimiting`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn ein Grenzwert für den Speicherplatz vorhanden ist, der komprimierte Dateien im Ordner "komprimierte Dateien" belegen kann; andernfalls, `false`. Der Standardwert ist `true`. Der Ordner "komprimierte Dateien" wird von der `Directory` Eigenschaft angegeben.
`DynamicCompressionDisableCpuUsage`	Ein Lese-/Schreib`uint32`-Wert, der den Prozentsatz der CPU-Auslastung angibt, bei der die dynamische Komprimierung deaktiviert wird. Der Standard ist 90. Der Wert muss zwischen 0 und 100 liegen. Die durchschnittliche CPU-Auslastung wird alle 30 Sekunden berechnet. Hinweis: Diese Eigenschaft fungiert als obere CPU-Grenze, bei der die dynamische Komprimierung deaktiviert ist. Wenn die CPU-Auslastung unter den in der `DynamicCompressionEnableCpuUsage` Eigenschaft angegebenen Wert fällt, wird die dynamische Komprimierung erneut aktiviert.
`DynamicCompressionEnableCpuUsage`	Ein Lese-/Schreib`uint32`-Wert , der den Prozentsatz der CPU-Auslastung angibt, unter der die dynamische Komprimierung aktiviert wird. Der Standard ist 50. Der Wert muss zwischen 0 und 100 liegen. Die durchschnittliche CPU-Auslastung wird alle 30 Sekunden berechnet. Hinweis: Diese Eigenschaft fungiert als niedrigere CPU-Grenze, unter der die dynamische Komprimierung aktiviert ist. Wenn die CPU-Auslastung über den in der `DynamicCompressionDisableCpuUsage` Eigenschaft angegebenen Wert steigt, wird die dynamische Komprimierung deaktiviert.
`DynamicTypes`	Ein DynamicTypeSettings-Wert , der Dateinamenerweiterungen enthält, die IIS mit dynamischer Komprimierung bedienen kann.
`ExpiresHeader`	Ein Lese-/Schreib`string`-Wert, der den Inhalt der Kopfzeile angibt, die `HTTP Expires` mit komprimierten Dateien gesendet wird. Der Standardwert ist "Wed, 01 Jan 1997 12:00:00 GMT". Um diese Einstellung zu aktivieren, müssen Sie die `SendCacheHeaders` Eigenschaft auf `true` festlegen. Sie müssen den WWW-Dienst auch neu starten, bevor Änderungen an der `ExpiresHeader` Eigenschaft wirksam werden. Hinweis: Die `HTTP Expires` Kopfzeile wird mit der `Cache-Control`Kopfzeile gesendet, die in der `CacheControlHeader` Eigenschaft angegeben ist. Diese Kombination von Headern stellt sicher, dass ältere Clients und Proxyserver nicht versuchen, komprimierte Dateien zwischenzuspeichern.
`HttpCompression`	Ein Array von HttpCompressionSchemeElement-Werten , die die Komprimierungsschemas (Gzip oder Deflate) angeben, die IIS zum Komprimieren von Clientanforderungen verwendet.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`MaxDiskSpaceUsage`	Ein Lese-/Schreib`uint32`-Wert , der einen Grenzwert an Speicherplatz in Megabyte angibt, der komprimierte Dateien im Komprimierungsverzeichnis belegen kann. Der Standard ist 100. Wenn der von komprimierten Dateien verwendete Speicherplatz 90 Prozent des Werts in `MaxDiskSpaceUsage`überschreitet, löscht IIS die zuletzt verwendeten Dateien, bis eine Nutzungsstufe von 90 Prozent erreicht ist. Hinweis: In IIS 6.0 wird dieser Grenzwert in Bytes ausgedrückt; in IIS 7 wird er in Megabyte ausgedrückt. In IIS 7 wird der Grenzwert pro Anwendungspool angewendet.
`MinFileSizeForComp`	Ein Lese-/Schreib`uint32`-Wert , der die minimale Dateigröße in Kilobyte angibt, damit eine Datei komprimiert werden kann. Der Standardwert ist 256.
`NoCompressionForHttp10`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn die Komprimierung für Anforderungen deaktiviert ist, die eine HTTP 1.0-Versionsnummer enthalten; andernfalls, `false`. Der Standardwert ist `true`. Hinweis: Einige HTTP 1.0-Clients behandeln das Zwischenspeichern von komprimierten Objekten nicht ordnungsgemäß. Sie können diese Einstellung verwenden, um zu vermeiden, dass eine komprimierte Datei an einen Client zurückgegeben wird, der sie nicht dekomprimieren kann.
`NoCompressionForProxies`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn die Komprimierung für HTTP 1.1-Anforderungen deaktiviert ist, die über einen Proxyserver gesendet werden; andernfalls, `false`. Der Standardwert ist `true.` Hinweis: Einige HTTP-Proxyserver behandeln das Zwischenspeichern von komprimierten Objekten nicht ordnungsgemäß. Sie können diese Einstellung verwenden, um zu vermeiden, dass eine komprimierte Datei an einen Proxyserver zurückgegeben wird, der sie nicht dekomprimieren kann.
`NoCompressionForRange`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn die Komprimierung für HTTP-Anforderungen deaktiviert ist, die den `Range` Header enthalten; andernfalls, `false`. Der Standardwert ist `true`. Hinweis: Einige Clients können Bereichsanforderungen nicht ordnungsgemäß verarbeiten. Sie können diese Einstellung verwenden, um zu vermeiden, dass eine komprimierte Datei an einen Client zurückgegeben wird, der sie nicht dekomprimieren kann.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)
`SendCacheHeaders`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn die in den `CacheControlHeader` Und `ExpiresHeader` Eigenschaften konfigurierten Header mit komprimierten Antworten gesendet werden; andernfalls, `false`. Der Standardwert ist `false`.
`StaticCompressionDisableCpuUsage`	Ein Lese-/Schreib`uint32`-Wert , der den Prozentsatz der CPU-Auslastung angibt, bei der statische Komprimierung deaktiviert ist. Der Standard ist 100. Der Wert muss zwischen 0 und 100 liegen. Die durchschnittliche CPU-Auslastung wird alle 30 Sekunden berechnet. Hinweis: Diese Eigenschaft fungiert als oberer CPU-Grenzwert, bei dem die statische Komprimierung deaktiviert ist. Wenn die CPU-Auslastung unter den in der `StaticCompressionEnableCpuUsage` Eigenschaft angegebenen Wert fällt, wird die statische Komprimierung erneut aktiviert.
`StaticCompressionEnableCpuUsage`	Ein Lese-/Schreib`uint32`-Wert , der den Prozentsatz der CPU-Auslastung angibt, bei der statische Komprimierung aktiviert ist. Der Standard ist 50. Der Wert muss zwischen 0 und 100 liegen. Die durchschnittliche CPU-Auslastung wird alle 30 Sekunden berechnet. Hinweis: Diese Eigenschaft fungiert als untere CPU-Grenze, unter der die statische Komprimierung aktiviert ist. Wenn die CPU-Auslastung über dem in der `StaticCompressionDisableCpuUsage` Eigenschaft angegebenen Wert steigt, wird die statische Komprimierung deaktiviert.
`StaticTypes`	Ein StaticTypeSettings-Wert, der Dateinamenerweiterungen enthält, die IIS mit statischer Komprimierung bedienen kann.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Die statische Komprimierung ist in IIS 7 standardmäßig aktiviert. Die EigenschaftenStaticCompressionEnableCpuUsage , StaticCompressionDisableCpuUsage, DynamicCompressionEnableCpuUsageund DynamicCompressionDisableCpuUsage wurden hinzugefügt, um die Komprimierung automatisch zu aktivieren oder zu deaktivieren, je nach CPU-Auslastung.

Die folgenden Komprimierungseigenschaften von IIS 6.0 sind in IIS 7 nicht mehr vorhanden:

[HcCompressionBufferSize]()
HcCreateFlags
HcDoOnDemandCompression
HcFileExtensions
HcFilesDeletedPerDiskFree
HcIoBufferSize
HcMaxQueueLength
HcPriority
HcScriptFileExtensions

Beispiel

Das folgende Beispiel zeigt die Nicht-Array-Eigenschaften in der HttpCompressionSection Klasse an und listet die statischen und dynamischen Komprimierungsarrayeigenschaften auf.

' 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

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

HttpCompressionSection

Anforderungen

type	Beschreibung
Client	- IIS 7.0 unter Windows Vista IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016.
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

ConfigurationSectionWithCollection-Klasse
DynamicType Einstellungen Klasse
HttpCompressionMimeTypeElement-Klasse
HttpCompressionSchemeElement-Klasse
StaticType Einstellungen Klasse

Freigeben über