建立 WDTF 案例
您可以建立 IWDTF2 匯總介面的實例,其中包含 DeviceDepot 和 SystemDepot 屬性,以開始以 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 權杖。