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 では、静的圧縮は既定でオンになっています。 StaticCompressionEnableCpuUsage
、StaticCompressionDisableCpuUsage
、DynamicCompressionEnableCpuUsage
、DynamicCompressionDisableCpuUsage
の各プロパティが追加され、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
継承階層
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 クラス