WMI データ リーダー タスク
適用対象: 
SQL Server Azure Data Factory の SSIS 統合ランタイム
WMI データ リーダー タスクは、WQL (Windows Management Instrumentation Query Language) を使用してクエリを実行し、コンピューター システムに関する WMI から情報を返します。 WMI データ リーダー タスクは、次の目的で使用できます。
ローカルまたはリモート コンピューター上の Windows イベント ログのクエリを実行し、その情報をファイルまたは変数に書き込みます。
ハードウェア コンポーネントの存在、状態、またはプロパティに関する情報を取得し、この情報を使用して制御フロー内の他のタスクを実行するかどうかを決定します。
アプリケーションの一覧を取得し、インストールされている各アプリケーションのバージョンを判別します。
WMI データ リーダー タスクは、次の方法で構成できます。
使用する WMI 接続マネージャーを指定します。
WQL クエリの実行元を指定します。 このクエリは、タスクのプロパティ内に格納できます。または、タスク外の変数またはファイル内にも格納できます。
WQL クエリ結果の形式を定義します。 このタスクでは、テーブル、プロパティの名前と値のペア、またはプロパティ値の形式がサポートされています。
クエリの実行先を指定します。 この実行先には、変数またはファイルを設定できます。
クエリの実行先で、上書き、保持、または追加のいずれを行うかを示します。
実行元または実行先がファイルの場合、WMI データ リーダー タスクは、ファイル接続マネージャーを使用してファイルに接続します。 詳しくは、「 フラット ファイル接続マネージャー」をご覧ください。
WMI データ リーダー タスクは、WMI 接続マネージャーを使用して、WMI 情報を読み取るサーバーに接続します。 詳細については、「 WMI 接続マネージャー」をご覧ください。
WQL クエリ
WQL は SQL 言語仕様の 1 つで、WMI イベント通知やその他 WMI 固有の機能をサポートする拡張機能が付いています。 WQL の詳細については、 MSDN ライブラリにある Windows Management Instrumentation のマニュアルをご覧ください。
注意
WMI クラスは、Windows のバージョンによって異なります。
次の WQL クエリは、アプリケーション ログ イベント内のエントリを返します。
SELECT * FROM Win32_NTLogEvent WHERE LogFile = 'Application' AND (SourceName='SQLISService' OR SourceName='SQLISPackage') AND TimeGenerated > '20050117'
次の WQL クエリは、論理ディスク情報を返します。
SELECT FreeSpace, DeviceId, Size, SystemName, Description FROM Win32_LlogicalDisk
次の WQL クエリは、オペレーティング システムに対する QFE (Quick Fix Engineering) 更新の一覧を返します。
Select * FROM Win32_QuickFixEngineering
WMI データ リーダー タスクで使用できるカスタム ログ メッセージ
次の表は、WMI データ リーダー タスクのカスタム ログ エントリの一覧です。 詳細については、「 Integration Services (SSIS) のログ記録」を参照してください。
| ログ エントリ | 説明 |
|---|---|
| WMIDataReaderGettingWMIData | タスクが WMI データの読み取りを開始したことを示します。 |
| WMIDataReaderOperation | タスクで実行された WQL クエリを報告します。 |
WMI データ リーダー タスクの構成
プロパティはプログラムによって設定するか、または SSIS デザイナーから設定できます。
SSIS デザイナーで設定できるプロパティの詳細については、次のトピックを参照してください。
プログラムによってこれらのプロパティを設定する方法については、次のトピックを参照してください。
Related Tasks
SSIS デザイナーでこれらのプロパティを設定する方法については、次のトピックを参照してください。
[WMI データ リーダー タスク エディター] ([全般] ページ)
[WMI データ リーダー タスク エディター] ダイアログ ボックスの [全般] ページを使用すると、WMI データ リーダー タスクの名前と説明を入力できます。
WQL (WMI Query Language) の詳細については、MSDN ライブラリにある Windows Management Instrumentation のトピック「 WQL を使用したクエリ」を参照してください。
Options
名前
WMI データ リーダー タスクの一意な名前を指定します。 この名前は、タスク アイコンのラベルとして使用されます。
Note
タスク名はパッケージ内で一意である必要があります。
説明
WMI データ リーダー タスクの説明を入力します。
[WMI データ リーダー タスク エディター] ([WMI オプション] ページ)
[WMI データ リーダー タスク エディター] ダイアログ ボックスの [WMI オプション] ページを使用すると、WQL (Windows Management Instrumentation Query Language) クエリのソースおよびクエリ結果の出力先を指定できます。
WQL (WMI Query Language) の詳細については、MSDN ライブラリにある Windows Management Instrumentation のトピック「 WQL を使用したクエリ」を参照してください。
静的オプション
[WMIConnectionName]
WMI 接続マネージャーを一覧から選択するか、<新しい WMI 接続...> をクリックして新しい接続マネージャーを作成します。
関連トピック: WMI 接続マネージャー、WMI 接続マネージャー エディター
[WQLQuerySourceType]
タスクで実行する WQL クエリのソースの種類を選択します。 このプロパティのオプションを次の表に示します。
| 値 | 説明 |
|---|---|
| [直接入力] | ソースを WQL クエリに設定します。 この値を選択すると、動的オプションの [WQLQuerySourceType] が表示されます。 |
| [ファイル接続] | WQL クエリを含むファイルを選択します。 この値を選択すると、動的オプションの [WQLQuerySourceType] が表示されます。 |
| 変数 | WQL クエリを定義する変数に、ソースを設定します。 この値を選択すると、動的オプションの [WQLQuerySourceType] が表示されます。 |
[OutputType]
データ テーブル、プロパティ値、またはプロパティ名と値のいずれを出力に含めるかを指定します。
[OverwriteDestination]
出力先のファイルまたは変数内の元のデータを変更しないか、上書きするか、データを追加するかを指定します。
[DestinationType]
タスクで実行する WQL クエリの出力先の種類を選択します。 このプロパティのオプションを次の表に示します。
| 値 | 説明 |
|---|---|
| [ファイル接続] | WQL クエリの結果を保存するファイルを選択します。 この値を選択すると、動的オプションの [DestinationType] が表示されます。 |
| 変数 | WQL クエリの結果を保存する変数を設定します。 この値を選択すると、動的オプションの [DestinationType] が表示されます。 |
[WQLQuerySourceType] 動的オプション
[WQLQuerySourceType] = [直接入力]
[WQLQuerySource]
クエリを指定します。または、参照 ( [...] ) をクリックし、 [WQL クエリ] ダイアログ ボックスを使用してクエリを入力します。
[WQLQuerySourceType] = [ファイル接続]
[WQLQuerySource]
ファイル接続マネージャーを一覧から選択するか、[新しい接続] をクリックして新しい接続マネージャーを作成します。
関連トピック: 接続マネージャー、ファイル接続マネージャー エディター
[WQLQuerySourceType] = [変数]
[WQLQuerySource]
一覧で変数を選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。
関連トピック: Integration Services (SSIS) の変数、変数の追加
[DestinationType] 動的オプション
[DestinationType] = [ファイル接続]
宛先
ファイル接続マネージャーを一覧から選択するか、[新しい接続] をクリックして新しい接続マネージャーを作成します。
関連トピック: 接続マネージャー、ファイル接続マネージャー エディター
[DestinationType] = [変数]
宛先
一覧で変数を選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。
関連トピック: Integration Services (SSIS) の変数、変数の追加