HttpCompressionSection クラス

HTTP 圧縮を構成します。

構文

class HttpCompressionSection : ConfigurationSectionWithCollection  

メソッド

次の表に、HttpCompressionSection クラスによって公開されるメソッドの一覧を示します。

名前 説明
[追加] (ConfigurationSectionWithCollection から継承。)
Clear (ConfigurationSectionWithCollection から継承。)
Get (ConfigurationSectionWithCollection から継承。)
GetAllowDefinition (ConfigurationSection から継承。)
GetAllowLocation (ConfigurationSection から継承。)
削除 (ConfigurationSectionWithCollection から継承。)
RevertToParent (ConfigurationSection から継承。)
SetAllowDefinition (ConfigurationSection から継承。)
SetAllowLocation (ConfigurationSection から継承。)

プロパティ

次の表は、HttpCompressionSection クラスによって公開されるプロパティの一覧です。

名前 説明
CacheControlHeader 圧縮ファイルで送信される Cache-Control ヘッダーを指定する、読み取り/書き込みの string 値。 既定値は "max-age=86400" です。 この設定を有効にするには、SendCacheHeaders プロパティを true に設定する必要があります。 また、CacheControlHeader プロパティに対して変更が行われる前に、World Wide Web 発行サービス (WWW サービス) を再起動する必要があります。 注: Cache-Control ヘッダーは、ExpiresHeader プロパティで指定された HTTP Expires ヘッダーと共に送信されます。 このヘッダーの組み合わせにより、以前のクライアントとプロキシ サーバーが圧縮ファイルのキャッシュを試行しなくなります。
Directory 静的ファイルの圧縮されたバージョンが一時的に格納およびキャッシュされるディレクトリを指定する、読み取り/書き込みの string 値。 既定値は "%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files" です。 IIS 7 では、アプリケーション プールごとにこのフォルダーにサブフォルダーを作成し、圧縮スキームごとに各アプリケーション プール フォルダーにサブフォルダーを作成します。 注: IIS 6.0 の IIS 一時圧縮ファイルの既定のディレクトリ パスは %Windir%\\IIS Temporary Compressed Files で、フラット ディレクトリ構造が使用されました。
DoDiskSpaceLimiting 読み取り/書き込みの boolean 値。 圧縮ファイル フォルダー内の圧縮ファイルが占有できるディスク領域の量に対する制限が存在する場合は true、それ以外の場合は false。 既定値は、true です。 圧縮ファイル フォルダーは、Directory プロパティによって指定されます。
DynamicCompressionDisableCpuUsage 動的圧縮がオフになる CPU 使用率の割合を指定する、読み取り/書き込みの uint32 値。 既定値は 90 です。 0 から 100 までの値にする必要があります。 平均 CPU 使用率は 30 秒ごとに計算されます。 注: このプロパティは、動的圧縮がオフになる CPU の上限として機能します。 CPU 使用率が DynamicCompressionEnableCpuUsage プロパティで指定された値を下回ると、動的圧縮が再びオンになります。
DynamicCompressionEnableCpuUsage 動的圧縮がオンになる CPU 使用率の割合を指定する、読み取り/書き込みの uint32 値。 既定値は 50 です。 0 から 100 までの値にする必要があります。 平均 CPU 使用率は 30 秒ごとに計算されます。 注: このプロパティは、動的圧縮がオンになる CPU の下限として機能します。 CPU 使用率が DynamicCompressionDisableCpuUsage プロパティで指定された値を超えると、動的圧縮がオフになります。
DynamicTypes IIS の動的圧縮で使用できるファイル名拡張子を含む、DynamicTypeSettings 値。
ExpiresHeader 圧縮ファイルで送信される HTTP Expires ヘッダーのコンテンツを指定する、読み取り/書き込みの string 値。 既定値は "Wed, 01 Jan 1997 12:00:00 GMT" です。 この設定を有効にするには、SendCacheHeaders プロパティを true に設定する必要があります。 また、ExpiresHeader プロパティに対する変更が行われる前に、WWW サービスを再起動する必要があります。 注: HTTP Expires ヘッダーは、CacheControlHeader プロパティで指定された Cache-Control ヘッダーと共に送信されます。 このヘッダーの組み合わせにより、以前のクライアントとプロキシ サーバーが圧縮ファイルのキャッシュを試行しなくなります。
HttpCompression IIS でクライアント要求を圧縮するために使用される圧縮スキーム (Gzip または Deflate) を指定する、HttpCompressionSchemeElement 値の配列。
Location (ConfigurationSection から継承。)キー プロパティ。
MaxDiskSpaceUsage 圧縮ディレクトリで圧縮ファイルが占有できるディスク領域の上限を MB 単位で指定する、読み取り/書き込みの uint32 値。 既定値は、100 です。 圧縮ファイルが占有する領域が MaxDiskSpaceUsage の値の 90% を超えると、IIS では使用レベルが 90% になるまで、最も長く使われていないファイルを削除します。 注: IIS 6.0 では、この上限はバイト単位で表されます。IIS 7 ではメガバイト単位で表されます。 IIS 7 では、アプリケーション プールごとにこの上限が適用されます。
MinFileSizeForComp 圧縮されるファイルの最小ファイル サイズを KB 単位で指定する、読み取り/書き込みの uint32 値。 既定値は 256 です。
NoCompressionForHttp10 読み取り/書き込みの boolean 値。 HTTP 1.0 バージョン番号を含む要求に対して圧縮がオフになっている場合は true、それ以外の場合は false。 既定値は、true です。 注: 一部の HTTP 1.0 クライアントでは、圧縮オブジェクトのキャッシュを正しく処理しません。 この設定を使用すると、圧縮ファイルを展開できないクライアントに圧縮ファイルが返されなくなります。
NoCompressionForProxies 読み取り/書き込みの boolean 値。 プロキシ サーバー経由の HTTP 1.1 要求に対して圧縮がオフになっている場合は true、それ以外の場合は false。 既定値は true. Note: 一部の HTTP プロキシ サーバーでは、圧縮されたオブジェクトのキャッシュが正しく処理されません。 この設定を使用すると、圧縮ファイルを展開できないプロキシ サーバーに圧縮ファイルが返されなくなります。
NoCompressionForRange 読み取り/書き込みの boolean 値。 Range ヘッダーを含む HTTP 要求に対して圧縮がオフになっている場合は true、それ以外の場合は false。 既定値は、true です。 注: 一部のクライアントでは、範囲要求を正しく処理できません。 この設定を使用すると、圧縮ファイルを展開できないクライアントに圧縮ファイルが返されなくなります。
Path (ConfigurationSection から継承。)キー プロパティ。
SectionInformation (ConfigurationSection から継承。)
SendCacheHeaders 読み取り/書き込みの boolean 値。 CacheControlHeader プロパティと ExpiresHeader プロパティで構成されたヘッダーが圧縮された応答で送信される場合は true、それ以外の場合は false。 既定値は、false です。
StaticCompressionDisableCpuUsage 静的圧縮がオフになる CPU 使用率の割合を指定する、読み取り/書き込みの uint32 値。 既定値は、100 です。 0 から 100 までの値にする必要があります。 平均 CPU 使用率は 30 秒ごとに計算されます。 注: このプロパティは、静的圧縮がオフになる CPU の上限として機能します。 CPU 使用率が StaticCompressionEnableCpuUsage プロパティで指定された値を下回ると、静的圧縮が再びオンになります。
StaticCompressionEnableCpuUsage 静的圧縮がオンになる CPU 使用率の割合を指定する、読み取り/書き込みの uint32 値。 既定値は 50 です。 0 から 100 までの値にする必要があります。 平均 CPU 使用率は 30 秒ごとに計算されます。 注: このプロパティは、静的圧縮がオンになる CPU の下限として機能します。 CPU 使用率が StaticCompressionDisableCpuUsage プロパティで指定された値を超えると、静的圧縮がオフになります。
StaticTypes IIS の静的圧縮で使用できるファイル名拡張子を含む、StaticTypeSettings 値。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

IIS 7 では、静的圧縮は既定でオンになっています。 StaticCompressionEnableCpuUsageStaticCompressionDisableCpuUsageDynamicCompressionEnableCpuUsageDynamicCompressionDisableCpuUsage の各プロパティが追加され、CPU 負荷に応じて、その場で圧縮をオンまたはオフにできます。

IIS 6.0 の次の圧縮プロパティが、IIS 7 ではなくなりました。

  • [HcCompressionBufferSize]()

  • HcCreateFlags

  • HcDoOnDemandCompression

  • HcFileExtensions

  • HcFilesDeletedPerDiskFree

  • HcIoBufferSize

  • HcMaxQueueLength

  • HcPriority

  • HcScriptFileExtensions

次の例では、HttpCompressionSection クラスの非配列プロパティと、静的および動的圧縮配列プロパティの一覧を表示します。

' 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  
  

継承階層

ConfigurationSection

ConfigurationSectionWithCollection

HttpCompressionSection

要件

説明
クライアント - Windows Vista 上の IIS 7.0
- Windows 7 上の IIS 7.5
- Windows 8 上の IIS 8.0
- Windows 10 上の IIS 10.0
[サーバー] - Windows Server 2008 上の IIS 7.0
- Windows Server 2008 R2 上の IIS 7.5
- Windows Server 2012 上の IIS 8.0
- Windows Server 2012 R2 上の IIS 8.5
- Windows Server 2016 上の IIS 10.0
Product - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル WebAdministration.mof

参照

ConfigurationSectionWithCollection クラス
DynamicTypeSettings クラス
HttpCompressionMimeTypeElement クラス
HttpCompressionSchemeElement クラス
StaticTypeSettings クラス