建立 WDTF 案例

您可以建立 IWDTF2 匯總介面的實例,其中包含 DeviceDepotSystemDepot 屬性,以開始以 WDTF 為基礎的案例。

若要收集一或多個目標物件,請使用 IWDTFDeviceDepot2 介面,並使用 Query 方法搭配 Simple Data Evaluation Language (SDEL) 。

腳本也可以使用 IWDTFTarget2::Eval 方法來檢查特定目標。 選擇目標之後,請使用 一或多個動作介面來控制目標。

開始開發 WDTF 案例之前,您必須先安裝 WDTF。 如需詳細資訊,請參閱 WDTF 快速入門

本主題中的下列各節說明如何建立基本的 WDTF 案例。

簡單 WDTF 案例

下列 VBScript 程式碼範例 (WDTF_Sample1.vbs) 顯示使用 WDTF 來啟用和停用每個非虛設裝置的簡化案例。 非虛設裝置是任何實際存在的裝置。 如需完整的範例,請參閱 範例 WDTF 案例

Set WDTF = WScript.CreateObject("WDTF.WDTF")
For Each Device In WDTF.DeviceDepot.Query("IsPhantom=false AND IsDisableable")
    On Error Resume Next
    Set DevMan = Device.GetInterface("DeviceManagement")
    If err <> 0 Then
 DevMan.Disable()
 DevMan.Enable()
    End If
Next

您可以執行 CScript.exe WDTF_Sample1.vbs來執行此案例。

使用內容儲存目標資訊

某些程式設計語言,例如 VBScript,無法輕易地管理物件參考。 為了簡化 WDTF 中的這項管理,每個目標都會提供 一個 CoNtext 屬性,可讓您用來儲存任意索引鍵/值組,包括使用中物件的參考。 此屬性特別適用于儲存動作介面,以便稍後使用它們。 下列 VBScript 程式碼範例會在具名CoNtext專案內儲存IWDTFSimpleIOStressAction2巨集指令。

deviceObj.Context("IWDTFSimpleIOStressAction2") = SimpleIOObj

稍後,您的案例可以再次透過CoNtext存取IWDTFSimpleIOStressAction2介面來停止、暫停或重新開機,如下列程式碼範例所示。

Device.Context("IWDTFSimpleIOStressAction2").Stop

偵測虛設裝置

虛設裝置是過去實際安裝在電腦上的裝置,但目前不存在。 例如,虛設裝置可能是已取消叢集的 USB 滑鼠。 為了加速並簡化插入已開啟或移除裝置之電腦的裝置重新安裝,Windows 作業系統會讓設備磁碟機保持安裝,但會將裝置標示為虛設專案。

裝置類型目標包括 IsPhantom 屬性 (和 IsAttached 屬性,這相當於指定硬體實體存在的 IsPhantom=false) 。 下列 VBScript 程式碼範例會列出電腦中實際存在之所有裝置的集合。

Set NonPhantomDevices = WDTF.DeviceDepot.Query ("IsAttached")

如需更多屬性關鍵字,請參閱 SDEL 權杖