HttpCompressionSection 클래스

아티클
07/10/2024

HTTP 압축을 구성합니다.

구문

class HttpCompressionSection : ConfigurationSectionWithCollection

메서드

다음 표에서는 클래스에서 노출하는 메서드를 나열합니다 HttpCompressionSection .

속성	설명
추가	(다음에서 상속됨) ConfigurationSectionWithCollection.)
지우기	`ConfigurationSectionWithCollection`에서 상속됩니다.
가져오기	`ConfigurationSectionWithCollection`에서 상속됩니다.
GetAllowDefinition	(다음에서 상속됨) ConfigurationSection.)
GetAllowLocation	`ConfigurationSection`에서 상속됩니다.
제거	`ConfigurationSectionWithCollection`에서 상속됩니다.
RevertToParent	`ConfigurationSection`에서 상속됩니다.
SetAllowDefinition	`ConfigurationSection`에서 상속됩니다.
SetAllowLocation	`ConfigurationSection`에서 상속됩니다.

속성

다음 표에서는 클래스에서 노출하는 속성을 나열합니다 HttpCompressionSection .

속성	설명
`CacheControlHeader`	압축된 파일과 함께 전송되는 헤더를 `Cache-Control` 지정하는 읽기/쓰기 `string` 값입니다. 기본값은 "max-age=86400"입니다. 이 설정을 사용하려면 속성을 `true`.로 설정 `SendCacheHeaders` 해야 합니다. 또한 속성 변경 내용 `CacheControlHeader` 이 적용되기 전에 WWW 서비스(World Wide Web Publishing Service)를 다시 시작해야 합니다. 참고: 헤더는 `Cache-Control` 속성에 `HTTP Expires` 지정된 헤더와 함께 전송됩니다 `ExpiresHeader` . 이 헤더 조합은 이전 클라이언트와 프록시 서버가 압축된 파일을 캐시하지 않도록 합니다.
`Directory`	압축된 버전의 정적 파일이 일시적으로 저장되고 캐시되는 디렉터리를 지정하는 읽기/쓰기 `string` 값입니다. 기본값은 "%SystemDrive%\inetpub\temp\IIS 임시 압축 파일"입니다. IIS 7은 각 애플리케이션 풀에 대해 이 폴더에 하위 폴더를 만들고 각 압축 체계에 대한 각 애플리케이션 풀 폴더에 하위 폴더를 만듭니다. 참고: IIS 6.0에서 IIS 임시 압축 파일의 기본 디렉터리 경로는 %Windir%\\IIS 임시 압축 파일이며 플랫 디렉터리 구조가 사용되었습니다.
`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"입니다. 이 설정을 사용하려면 속성을 `true`.로 설정 `SendCacheHeaders` 해야 합니다. 또한 속성 변경 내용 `ExpiresHeader` 이 적용되기 전에 WWW 서비스를 다시 시작해야 합니다. 참고: 헤더는 `HTTP Expires` 속성에 `Cache-Control` 지정된 헤더와 함께 전송됩니다 `CacheControlHeader` . 이 헤더 조합은 이전 클라이언트와 프록시 서버가 압축된 파일을 캐시하지 않도록 합니다.
`HttpCompression`	IIS에서 클라이언트 요청을 압축하는 데 사용하는 압축 구성표(Gzip 또는 Deflate)를 지정하는 HttpCompressionSchemeElement 값의 배열입니다.
`Location`	(.에서 `ConfigurationSection`상속됨) 키 속성입니다.
`MaxDiskSpaceUsage`	압축된 파일이 압축 디렉터리에서 차지할 수 있는 디스크 공간의 제한을 메가바이트 단위로 지정하는 읽기/쓰기 `uint32` 값입니다. 기본값은 100입니다. 압축된 파일에서 `MaxDiskSpaceUsage`사용하는 공간이 값의 90%를 초과하면 IIS는 90% 사용 수준에 도달할 때까지 가장 최근에 사용한 파일을 삭제합니다. 참고: IIS 6.0에서는 이 제한이 바이트로 표현되고 IIS 7에서는 메가바이트 단위로 표현됩니다. IIS 7에서는 애플리케이션 풀당 제한이 적용됩니다.
`MinFileSizeForComp`	압축할 파일의 최소 파일 크기(킬로바이트)를 지정하는 읽기/쓰기 `uint32` 값입니다. 기본값은 256입니다.
`NoCompressionForHttp10`	읽기/쓰기 `boolean` 값입니다. `true`HTTP 1.0 버전 번호가 포함된 요청에 대해 압축을 사용하지 않도록 설정하면 이고, 그렇지 않으면 . `false` 기본값은 `true`입니다. 참고: 일부 HTTP 1.0 클라이언트는 압축된 개체의 캐싱을 올바르게 처리하지 않습니다. 압축된 파일을 압축 해제할 수 없는 클라이언트로 반환하지 않도록 하려면 이 설정을 사용할 수 있습니다.
`NoCompressionForProxies`	읽기/쓰기 `boolean` 값입니다. `true`프록시 서버를 통해 들어오는 HTTP 1.1 요청에 대해 압축을 사용하지 않도록 설정한 경우 그렇지 않으면 . `false` 기본값은 `true.` 참고: 일부 HTTP 프록시 서버는 압축된 개체의 캐싱을 올바르게 처리하지 않습니다. 압축된 파일을 압축 해제할 수 없는 프록시 서버로 반환하지 않도록 하려면 이 설정을 사용할 수 있습니다.
`NoCompressionForRange`	읽기/쓰기 `boolean` 값입니다. `true` 헤더를 포함하는 `Range` HTTP 요청에 대해 압축을 사용하지 않도록 설정하면 이고, `false`그렇지 않으면 . 기본값은 `true`입니다. 참고: 일부 클라이언트는 범위 요청을 올바르게 처리할 수 없습니다. 압축된 파일을 압축 해제할 수 없는 클라이언트로 반환하지 않도록 하려면 이 설정을 사용할 수 있습니다.
`Path`	(.에서 `ConfigurationSection`상속됨) 키 속성입니다.
`SectionInformation`	`ConfigurationSection`에서 상속됩니다.
`SendCacheHeaders`	읽기/쓰기 `boolean` 값입니다. `true` 속성에 구성된 `CacheControlHeader` 헤더가 압축된 응답과 함께 전송되면 이고 `ExpiresHeader` , `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에서 기본적으로 설정됩니다. StaticCompressionEnableCpuUsageCPU 로드에 따라 즉시 압축을 사용하거나 사용하지 않도록 설정하기 위해 , StaticCompressionDisableCpuUsage및 DynamicCompressionEnableCpuUsageDynamicCompressionDisableCpuUsage 속성이 추가되었습니다.

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

요구 사항

Type	설명
클라이언트	- 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 클래스

다음을 통해 공유

HttpCompressionSection 클래스

구문

메서드

속성

서브 클래스

설명

예시

상속 계층 구조

요구 사항

참고 항목

피드백

추가 리소스