WMI 이벤트 감시자 태스크WMI Event Watcher Task

WMI 이벤트 감시자 태스크는 WQL(WMI Query Language) 이벤트 쿼리를 사용하여 특정 이벤트를 지정하기 위해 WMI(Windows Management Instrumentation) 이벤트를 감시합니다.The WMI Event Watcher task watches for a Windows Management Instrumentation (WMI) event using a Management Instrumentation Query Language (WQL) event query to specify events of interest. WMI 이벤트 감시자 태스크는 다음 용도로 사용할 수 있습니다.You can use the WMI Event Watcher task for the following purposes:

  • 파일이 폴더에 추가되었다는 알림을 기다린 후 파일 처리를 시작합니다.Wait for notification that files have been added to a folder and then initiate the processing of the file.

  • 서버에서 사용 가능한 메모리가 지정된 백분율 아래로 떨어지면 파일을 삭제하는 패키지를 실행합니다.Run a package that deletes files when the available memory on a server drops lower than a specified percentage.

  • 응용 프로그램 설치를 감시한 후 응용 프로그램을 사용하는 패키지를 실행합니다.Watch for installation of an application, and then run a package that uses the application.

    Integration ServicesIntegration Services 에는 WMI 정보를 읽는 태스크가 포함됩니다. includes a task that reads WMI information.

    이 태스크에 대한 자세한 내용을 보려면 다음 항목을 클릭하십시오.For more information about this task, click the following topic:

  • WMI 데이터 판독기 태스크WMI Data Reader Task

WQL 쿼리WQL Queries

WQL은 WMI 이벤트 알림 및 기타 WMI 관련 기능을 지원하기 위한 확장 기능이 포함된 SQL의 언어입니다.WQL is a dialect of SQL with extensions to support WMI event notification and other WMI-specific features. WQL에 대한 자세한 내용은 MSDN Library에서 WMI(Windows Management Instrumentation) 설명서를 참조하십시오.For more information about WQL, see the Windows Management Instrumentation documentation in the MSDN Library.

참고

WMI 클래스는 Windows 버전마다 다릅니다.WMI classes vary between versions of Windows.

다음 쿼리는 CPU 사용이 40%를 넘는 알림을 감시합니다.The following query watches for notification that the CPU use is more than 40 percent.

SELECT * from __InstanceModificationEvent WITHIN 2 WHERE TargetInstance ISA 'Win32_Processor' and TargetInstance.LoadPercentage > 40  

다음 쿼리는 폴더에 추가된 파일 알림을 감시합니다.The following query watches for notification that a file has been added to a folder.

SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA "CIM_DirectoryContainsFile" and TargetInstance.GroupComponent= "Win32_Directory.Name=\"c:\\\\WMIFileWatcher\""   

WMI 이벤트 감시자 태스크에 사용할 수 있는 사용자 지정 로깅 메시지Custom Logging Messages Available on the WMI Event Watcher Task

다음 표에서는 WMI 이벤트 감시자 태스크에 대한 사용자 지정 로그 항목을 나열합니다.The following table lists the custom log entries for the WMI Event Watcher task. 자세한 내용은 Integration Services(SSIS) 로깅을 참조하세요.For more information, see Integration Services (SSIS) Logging.

로그 항목Log entry DescriptionDescription
WMIEventWatcherEventOccurredWMIEventWatcherEventOccurred 태스크에서 모니터링하고 있는 이벤트가 발생했음을 나타냅니다.Indicates that an event occurred that the task was monitoring.
WMIEventWatcherTimedoutWMIEventWatcherTimedout 태스크 시간이 초과되었음을 나타냅니다.Indicates that the task timed out.
WMIEventWatcherWatchingForWMIEventsWMIEventWatcherWatchingForWMIEvents 태스크에서 WQL 쿼리 실행을 시작했음을 나타냅니다.Indicates that the task began to execute the WQL query. 이 항목은 해당 쿼리를 포함합니다.The entry includes the query.

WMI 이벤트 감시자 태스크 구성Configuration of the WMI Event Watcher Task

다음과 같은 방법으로 WMI 데이터 판독기 태스크를 구성할 수 있습니다.You can configure the WMI Data Reader task in the following ways:

  • 사용할 WMI 연결 관리자를 지정합니다.Specify the WMI connection manager to use.

  • WQL 쿼리의 원본을 지정합니다.Specify the source of the WQL query. 원본은 태스크, 변수 또는 파일의 외부에 있을 수 있으며 쿼리는 태스크 속성에 저장될 수 있습니다.The source can be external to the task, a variable or a file, or the query can be stored in a task property.

  • WMI 이벤트가 발생할 때 태스크에서 취할 동작을 지정합니다.Specify the action that the task takes when the WMI event occurs. 이벤트 알림과 이벤트 이후의 상태를 로깅하거나 WMI 이벤트와 관련된 정보, 알림 및 이벤트 이후의 상태를 제공하는 사용자 지정 Integration ServicesIntegration Services 이벤트를 발생시킬 수 있습니다.You can log the event notification and the status after the event, or raise custom Integration ServicesIntegration Services events that provide information associated with the WMI event, the notification, and the status after the event.

  • 태스크가 이벤트에 대응하는 방법을 정의합니다.Define how the task responds to the event. 이벤트에 따라 태스크가 성공 또는 실패하도록 구성하거나 단지 태스크에서 이벤트를 다시 감시하도록 할 수 있습니다.The task can be configured to succeed or fail, depending on the event, or the task can just watch for the event again.

  • WMI 쿼리 시간이 종료될 때 태스크에서 취할 동작을 지정합니다.Specify the action the task takes when the WMI query times out. 시간 제한 및 시간 제한 이후의 상태를 로깅하거나 WMI 이벤트 시간이 종료되었고 해당 제한 시간과 제한 시간 상태를 로깅하도록 나타내는 사용자 지정 Integration ServicesIntegration Services 이벤트를 발생시킬 수 있습니다.You can log the time-out and the status after time-out, or raise a custom Integration ServicesIntegration Services event, indicating that the WMI event timed out and logging the time-out and time-out status.

  • 태스크가 시간 종료에 대응하는 방법을 정의합니다.Define how the task responds to the time-out. 태스크가 성공 또는 실패하도록 구성하거나 단지 태스크에서 이벤트를 다시 감시하도록 할 수 있습니다.The task can be configured to succeed or fail, or the task can just watch for the event again.

  • 태스크가 이벤트를 감시하는 횟수를 지정합니다.Specify the number of times the task watches for the event.

  • 제한 시간을 지정합니다.Specify the time-out.

    원본이 파일인 경우 WMI 이벤트 감시자 태스크는 파일 연결 관리자를 사용하여 파일에 연결합니다.If the source is a file, the WMI Event Watcher task uses a File connection manager to connect to the file. 자세한 내용은 Flat File Connection Manager을 참조하세요.For more information, see Flat File Connection Manager.

    WMI 이벤트 감시자 태스크는 WMI 연결 관리자를 사용하여 WMI 정보를 읽어 온 서버에 연결합니다.The WMI Event Watcher task uses a WMI connection manager to connect to the server from which it reads WMI information. 자세한 내용은 WMI Connection Manager을 참조하세요.For more information, see WMI Connection Manager.

    SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

    SSISSSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목을 클릭하십시오.For more information about the properties that you can set in SSISSSIS Designer, click the following topic:

  • 식 페이지Expressions Page

    SSISSSIS 디자이너에서 이러한 속성을 설정하는 방법을 보려면 다음 항목을 클릭하십시오.For more information about how to set these properties in SSISSSIS Designer, click the following topic:

  • 태스크 또는 컨테이너의 속성 설정Set the Properties of a Task or Container

WMI 이벤트 감시자 태스크의 프로그래밍 방식 구성Programmatic Configuration of the WMI Event Watcher Task

이러한 속성을 프로그래밍 방식으로 설정하는 방법을 보려면 다음 항목을 클릭하십시오.For more information about programmatically setting these properties, click the following topic:

WMI 이벤트 감시자 태스크 편집기(일반 페이지)WMI Event Watcher Task Editor (General Page)

WMI 이벤트 감시자 태스크 편집기 대화 상자의 일반 페이지를 사용하여 WMI 이벤트 감시자 태스크의 이름을 지정하고 설명할 수 있습니다.Use the General page of the WMI Event Watcher Task Editor dialog box to name and describe the WMI Event Watcher task.

WQL(WMI Query Language)에 대한 자세한 내용은 MSDN 라이브러리의 WMI(Windows Management Instrumentation) 항목인 Querying with WQL(WQL을 사용하여 쿼리)을 참조하세요.For more information about WMI Query Language (WQL), see the Windows Management Instrumentation topic, Querying with WQL, in the MSDN Library.

옵션Options

이름Name
WMI 이벤트 감시자 태스크에 사용할 고유 이름을 제공합니다.Provide a unique name for the WMI Event Watcher task. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.This name is used as the label in the task icon.

참고

태스크 이름은 패키지 내에서 고유해야 합니다.Task names must be unique within a package.

DescriptionDescription
WMI 이벤트 감시자 태스크에 대한 설명을 입력합니다.Type a description of the WMI Event Watcher task.

WMI 이벤트 감시자 태스크 편집기(WMI 옵션 페이지)WMI Event Watcher Task Editor (WMI Options Page)

WMI 이벤트 감시자 태스크 편집기 대화 상자의 WMI 옵션 페이지를 사용하여 WQL(Windows Management Instrumentation Query Language) 쿼리의 원본 및 WMI 이벤트 감시자 태스크가 Microsoft Windows Instrumentation(WMI) 이벤트에 응답하는 방식을 지정할 수 있습니다.Use the WMI Options page of the WMI Event Watcher Task Editor dialog box to specify the source of the Windows Management Instrumentation Query Language (WQL) query and how the WMI Event Watcher task responds to Microsoft Windows Instrumentation (WMI) events.

WQL(WMI Query Language)에 대한 자세한 내용은 MSDN 라이브러리의 WMI(Windows Management Instrumentation) 항목인 Querying with WQL(WQL을 사용하여 쿼리)을 참조하세요.For more information about WMI Query Language (WQL), see the Windows Management Instrumentation topic, Querying with WQL, in the MSDN Library.

정적 옵션Static Options

WMIConnectionNameWMIConnectionName
목록에서 WMI 연결 관리자를 선택 하거나 클릭 < 새 WMI 연결... > 새 연결 관리자를 만듭니다.Select a WMI connection manager in the list, or click <New WMI Connection…> to create a new connection manager.

관련 항목: WMI 연결 관리자, WMI 연결 관리자 편집기Related Topics: WMI Connection Manager, WMI Connection Manager Editor

WQLQuerySourceTypeWQLQuerySourceType
태스크에서 실행하는 WQL 쿼리의 원본 유형을 선택합니다.Select the source type of the WQL query that the task runs. 이 속성의 옵션은 다음 표에 나열되어 있습니다.This property has the options listed in the following table.

ValueValue DescriptionDescription
직접 입력Direct input WQL 쿼리에 대한 원본을 설정합니다.Set the source to a WQL query. 이 값을 선택하면 동적 옵션 WQLQuerySource가 표시됩니다.Selecting this value displays the dynamic option, WQLQuerySource.
파일 연결File connection WQL 쿼리가 포함된 파일을 선택합니다.Select a file that contains the WQL query. 이 값을 선택하면 동적 옵션 WQLQuerySource가 표시됩니다.Selecting this value displays the dynamic option, WQLQuerySource.
변수Variable WQL 쿼리를 정의하는 변수에 대한 원본을 설정합니다.Set the source to a variable that defines WQL query. 이 값을 선택하면 동적 옵션 WQLQuerySource가 표시됩니다.Selecting this value displays the dynamic option, WQLQuerySource.

ActionAtEventActionAtEvent
WMI 이벤트가 이벤트를 기록하고 SSISSSIS 동작을 시작할지, 아니면 이벤트만 기록할지를 지정합니다.Specify whether the WMI event logs the event and initiates an SSISSSIS action, or only logs the event.

AfterEventAfterEvent
WMI 이벤트를 수신한 후 태스크가 성공 또는 실패하도록 지정하거나 태스크가 이벤트가 다시 발생하는지 여부를 계속 감시하도록 지정합니다.Specify whether the task succeeds or fails after it receives the WMI event, or if the task continues watching for the event to occur again.

ActionAtTimeoutActionAtTimeout
태스크가 WMI 쿼리에 대한 제한 시간 초과 발생을 기록하고 이에 대한 응답으로 SSISSSIS 이벤트를 시작할지, 아니면 제한 시간 초과 발생만 기록할지를 지정합니다.Specify whether the task logs a WMI query time-out and initiates an SSISSSIS event in response, or only logs the time-out.

AfterTimeoutAfterTimeout
제한 시간 초과에 대한 응답으로 태스크가 성공 또는 실패하도록 지정하거나 태스크가 제한 시간 초과가 다시 발생하는지 여부를 계속 감시하도록 지정합니다.Specify whether the task succeeds or fails in response to a time-out, or if the task continues watching for another time-out to recur.

NumberOfEventsNumberOfEvents
감시할 이벤트의 수를 지정합니다.Specify the number of events to watch for.

TimeoutTimeout
이벤트가 발생할 때까지 대기할 시간(초)을 지정합니다.Specify the number of seconds to wait for the event to occur. 값 0은 제한 시간이 적용되지 않음을 의미합니다.A value of 0 means that no time-out is in effect.

WQLQuerySource 동적 옵션WQLQuerySource Dynamic Options

WQLQuerySource = 직접 입력WQLQuerySource = Direct input

WQLQuerySourceWQLQuerySource
쿼리를 제공하거나, 줄임표 단추(...)를 클릭하고 WQL 쿼리 대화 상자를 사용하여 쿼리를 입력합니다.Provide a query, or click the ellipsis button (…) and enter a query using the WQL Query dialog box.

WQLQuerySource = 파일 연결WQLQuerySource = File connection

WQLQuerySourceWQLQuerySource
목록에서 파일 연결 관리자를 선택 하거나 클릭 < 새 연결... > 새 연결 관리자를 만듭니다.Select a File connection manager in the list, or click <New connection...> to create a new connection manager.

관련 항목: File Connection Manager, File Connection Manager EditorRelated Topics: File Connection Manager, File Connection Manager Editor

WQLQuerySource = 변수WQLQuerySource = Variable

WQLQuerySourceWQLQuerySource
목록에서 변수를 선택 하거나 클릭 < 새 변수... > 새 변수를 만듭니다.Select a variable in the list, or click <New variable...> to create a new variable.

관련 항목: Integration Services(SSIS) 변수, 변수 추가Related Topics: Integration Services (SSIS) Variables, Add Variable