HandlerAction 클래스

처리기에 대한 구성 설정을 노출합니다.

구문

class HandlerAction : CollectionElement  

메서드

이 클래스에는 메서드가 없습니다.

속성

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

속성	Description
AllowPathInfo	읽기/쓰기 boolean 값입니다. true 처리기가 URI(Uniform Resource Identifier)에서 전체 경로 정보를 처리할 경우 그렇지 않으면 입니다 false. 기본값은 false입니다. 예를 들어 이 true속성을 사용하면 처리기가 "/vdir/myisapi.dll/zip"과 같은 전체 경로를 처리할 수 있습니다. 이 false경우 이 속성은 부분 경로 "/zip"만 허용합니다.
Modules	파일 또는 확장자를 매핑할 모듈을 지정하는 읽기/쓰기 string 값입니다. 기본값은 null입니다.
Name	처리기 매핑의 고유한 이름을 지정하는 필수 고유 읽기/쓰기 string 값입니다. 유일한 키 속성입니다.
Path	처리할 파일 형식의 확장명을 가진 파일 확장명 또는 파일 이름을 지정하는 읽기/쓰기 string 값입니다. 기본값은 null입니다.
PreCondition	처리기를 실행할 수 있는 조건을 선택적으로 지정하는 읽기/쓰기 string 값입니다. 가능한 값은 설명 섹션의 뒷부분에 나열됩니다.
RequireAccess	처리기 액세스 요구 사항을 지정하는 읽기/쓰기 sint32 열거형입니다. 가능한 값은 설명 섹션의 뒷부분에 나열됩니다.
ResourceType	처리기의 매핑 유형을 지정하는 읽기/쓰기 sint32 열거형입니다. 가능한 값은 설명 섹션의 뒷부분에 나열됩니다.
ResponseBufferLimit	요청 처리기에 대한 응답 버퍼의 최대 크기(바이트)를 설정하는 읽기/쓰기 uint32 값입니다. PagesSection 클래스 ResponseBufferLimit 의 속성에서 Buffer 응답 버퍼링을 사용하는 경우 속성은 플러시 발생 전에 ASP 페이지가 응답 버퍼에 쓸 수 있는 최대 바이트 수를 제어합니다. 기본값은 4194304 바이트입니다.
ScriptProcessor	적절한 경우 요청을 처리하는 ISAPI 확장자 .dll 파일 또는 CGI .exe 파일의 전체 경로를 지정하는 읽기/쓰기 string 값입니다. 이 속성을 지정하는 경우 속성에서 "ISAPIModule" 또는 "CGIModule"을 Modules 지정해야 합니다. 기본값은 null입니다.
Type	관리되는 처리기의 네임스페이스 경로를 지정하는 읽기/쓰기 string 값입니다. 지정된 형식은 전역 어셈블리 캐시, 애플리케이션의 Bin 디렉터리 또는 app_code 디렉터리에 있는 유효한 관리형 형식이어야 합니다. 기본값은 null입니다.
Verb	쉼표로 구분된 동사 목록을 지정하는 읽기/쓰기 string 값입니다. 매핑을 특정 요청 형식에 적용하려면 이 속성을 사용합니다. 기본값은 null입니다.

를 서브클래싱합니다.

이 클래스에는 하위 클래스가 없습니다.

설명

이 클래스의 인스턴스는 HandlersSection 클래스의 속성에 포함 Handlers 됩니다.

다음 표에서는 속성에 대해 가능한 값을 나열합니다 Precondition . 기본값은 null입니다.

참고

사전 조건의 평가는 구성 요소의 논리 AND 입니다. 알 수 없는 전제 조건이 로 false평가되기 때문에 알 수 없는 전제 조건이 있으면 알 수 없는 전제 조건이 무시됩니다.

값	Description
appPoolName=pool1;pool2	처리기는 세미콜론으로 구분된 목록에 명명된 모든 애플리케이션 풀에 사용됩니다.
appPoolName!=pool1;pool2	처리기는 세미콜론으로 구분된 목록에 명명된 애플리케이션 풀에 사용되지 않습니다.
bitness32	처리기 항목은 32비트 작업자 프로세스에만 적용됩니다. 64비트 컴퓨터의 경우 이 값을 사용하여 32비트 모드에서 실행되는 애플리케이션 풀을 지정해야 합니다.
bitness64	처리기는 64비트 작업자 프로세스에만 적용됩니다. 64비트 컴퓨터의 경우 이 값을 사용하여 64비트 모드에서 실행되는 애플리케이션 풀을 지정해야 합니다.
integratedMode	처리기는 통합 모드의 애플리케이션 풀에만 사용됩니다.
ISAPIMode	처리기는 ISAPI 모드의 애플리케이션 풀에만 사용됩니다.
runtimeVersion	처리기는 특정 버전의 CLR(공용 언어 런타임)을 로드하는 애플리케이션 풀에만 사용됩니다. 이 사전 조건을 사용하도록 설정하려면 vMajorVersion 형식으로 문자열을 추가합니다. "runtimeVersion" 문자열에 대한 MinorVersion (예: "runtimeVersionv2.0").

다음 표에서는 속성에 대해 가능한 값을 나열합니다 RequireAccess . 기본값은 3(Script)입니다.

참고

HandlersSection 클래스의 속성에 있는 AccessPolicy 설정은 허용되는 권한과 실행할 수 있는 처리기를 결정합니다.

값	키워드	Description
0	None	처리기에 액세스 요구 사항이 없습니다.
1	Read	처리기에는 읽기 권한이 필요합니다.
2	Write	처리기에는 쓰기 권한이 필요합니다.
3	Script	처리기에는 스크립트 권한이 필요합니다.
4	Execute	처리기에는 실행 가능한 권한이 필요합니다.

다음 표에서는 속성에 대해 가능한 값을 나열합니다 ResourceType . 기본값은 3(Unspecified)입니다.

참고

이 속성은 IIS 관리자의 경로 형식 레이블이 지정됩니다.

값	키워드	Description
0	File	매핑은 파일에 대한 것입니다. 들어오는 요청이 디스크의 실제 파일에 매핑되지 않으면 요청이 처리기에 전달되지 않습니다.
1	Directory	매핑은 디렉터리에 대한 것입니다. 들어오는 요청이 디스크의 실제 폴더에 매핑되지 않으면 요청이 처리기에 전달되지 않습니다.
2	Either	매핑은 파일 또는 디렉터리에 대한 것입니다. 들어오는 요청이 디스크의 실제 파일 또는 폴더에 매핑되지 않으면 요청이 처리기에 전달되지 않습니다.
3	Unspecified	매핑 형식이 지정되지 않았습니다. 요청이 디스크의 실제 파일 또는 폴더에 매핑되는지 여부에 관계없이 요청이 처리기에 전달됩니다. 디스크에 없는 파일 이름(예: "MyHandler.axd")에 처리기를 매핑하는 경우 이 설정을 사용합니다.

예제

다음은 레거시 스크립트 맵 처리기, 네이티브 모듈 처리기 <handlers> 2개, 관리되는 처리기 등 세 가지 범주의 처리기를 섹션에 추가하는 예제입니다.

참고

구성 요소를 추가하거나 제거하면 기본 구성 섹션이 변경되지만 구성 섹션을 나타내는 스크립트의 개체 변수는 변경되지 않습니다. 변경 내용이 스크립트에 표시되도록 하려면 변경한 후 개체 변수에서 WMI Refresh_ 메서드를 호출해야 합니다. 그러면 구성 저장소의 최신 데이터로 개체 변수가 업데이트됩니다.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old list of handlers.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Create a legacy script map handler.  
' The required properties are Name, Modules, and ScriptProcessor.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "ASPClassic"   
oHandler.Path="*.asp"   
oHandler.Verb="GET,HEAD,POST"   
oHandler.Modules="ISAPIModule"   
oHandler.ResourceType= 0 '0 is "File"  
oHandler.ScriptProcessor = "%windir%\system32\inetsrv\asp.dll"  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Create a native module handler for static files.  
' The required properties are Name, Modules, and Path.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "StaticFile"   
oHandler.Path="*"   
oHandler.Verb="*"   
oHandler.Modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule"  
oHandler.ResourceType=2  
oHandler.RequireAccess=1  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Create a native module handler for ISAPI DLLs.  
' The required properties are Name, Modules, and Path.  
oHandler.Name = "ISAPI-dll"   
oHandler.Path="*.dll"   
oHandler.Verb="*"   
oHandler.Modules="ISAPIModule"  
oHandler.ResourceType=0  
oHandler.RequireAccess=4  
oHandler.AllowPathInfo=True  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Add a managed handler.  
' The required properties are Name, Path, and Type.   
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "TraceHandler-Integrated"   
oHandler.Path="trace.axd"   
oHandler.Verb="GET,HEAD,POST"   
oHandler.Type="System.Web.Handlers.TraceHandler"  
oHandler.PreCondition="integratedMode"  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Call the WMI Refresh_ method to update the oHandlersSection object variable.  
oHandlersSection.Refresh_  
  
' Display the new list of handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' Provide a sub to display the handler names.  
Sub DisplayHandlers  
    For Each oHandler In oHandlersSection.Handlers  
         WScript.Echo "Name: " & oHandler.Name  
    Next  
    WScript.Echo  
End Sub  
  

상속 계층 구조

CollectionElement

HandlerAction

요구 사항

형식	Description
클라이언트	- 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
제품	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF 파일	WebAdministration.mof

참고 항목

AccessSection 클래스
CollectionElement 클래스
HandlersSection 클래스
IScriptMapInfo::GetAllowPathInfoForScriptMappings 메서드