擷取 WMI 實例的一部分
部分實例擷取是在 WMI 只擷取實例屬性的子集時。 例如，WMI 只能擷取 Name 和 Key 屬性。 部分實例擷取最常見的用法是在具有多個屬性的大型列舉上。
使用 PowerShell 擷取 WMI 實例的一部分
您可以使用 Get-WmiObject來擷取實例的個別屬性;屬性本身可以擷取並顯示數種方式。 如同擷取實例，PowerShell 預設會傳回指定類別的所有實例;如果您想要只擷取單一實例，則必須指定特定值。
下列程式碼範例會顯示 Win32_LogicalDisk 類別實例的磁片區序號。
(Get-WmiObject -class Win32_logicalDisk).DeviceID
#or
Get-WmiObject -class Win32_LogicalDisk | format-list DeviceID
#or
$myDisk = Get-WmiObject -class Win32_LogicalDisk
$myDisk.DeviceID
使用 C# (System.Management) 擷取 WMI 實例的一部分
您可以使用特定實例的詳細資料建立新的 ManagementObject ，以擷取實例的個別屬性。 然後，您可以使用 GetPropertyValue 方法隱含擷取實例的一或多個屬性。
注意
System.Management 是用來存取 WMI 的原始 .NET 命名空間;不過，此命名空間中的 API 通常較慢，而且不會相對於其較新式 的 Microsoft.Management.Infrastructure 對應專案進行調整。
下列程式碼範例會顯示 Win32_LogicalDisk 類別實例的磁片區序號。
using System.Management;
...
ManagementObject myDisk = new ManagementObject("Win32_LogicalDisk.DeviceID='C:'");
string myProperty = myDisk.GetPropertyValue("VolumeSerialNumber").ToString();
Console.WriteLine(myProperty);
使用 VBScript 擷取 WMI 實例的一部分
您可以使用 GetObject擷取實例的個別屬性。
下列程式碼範例會顯示 Win32_LogicalDisk 類別實例的磁片區序號。
MsgBox (GetObject("WinMgmts:Win32_LogicalDisk='C:'").VolumeSerialNumber)
使用 C++ 擷取 WMI 實例的一部分
下列程式是用來使用 C++ 要求部分實例擷取。
使用 C++ 要求部分實例擷取
使用CoCreateInstance的呼叫建立IWbemCoNtext物件。
內容物件是 WMI 用來將詳細資訊傳遞至 WMI 提供者的物件。 在此情況下，您會使用 IWbemCoNtext 物件來指示提供者處理部分實例擷取。
新增__GET_EXTENSIONS、__GET_EXT_CLIENT_REQUEST，以及描述您想要擷取至 IWbemCoNtext 物件之屬性的任何其他具名值。
下表列出擷取呼叫中使用的不同具名值。
具名值 描述 __GET_EXTENSIONS VT_BOOL 設定為 VARIANT_TRUE。 用來表示正在使用部分實例擷取作業。 這可讓您快速、單一檢查，而不需要列舉整個內容物件。 如果使用其他任何值，則必須使用這個值。 __GET_EXT_PROPERTIES 列出要擷取之屬性的字串SAFEARRAY。 無法與 __GET_EXT_KEYS_ONLY同時指定。
星號 「*」 是__GET_EXT_PROPERTIES不正確屬性名稱。__GET_EXT_KEYS_ONLY VT_BOOL 設定為 VARIANT_TRUE。 表示只應該在傳回的 物件中提供索引鍵。 無法與 __GET_EXT_PROPERTIES同時指定。 相反地，優先于__GET_EXT_PROPERTIES。 __GET_EXT_CLIENT_REQUEST VT_BOOL 設定為 VARIANT_TRUE。 表示呼叫端是將值寫入至內容物件，且未從另一個相依作業傳播的值。 透過pCtx參數將IWbemCoNtext內容物件傳遞至IWbemServices：：GetObject、IWbemServices：：GetObjectAsync、IWbemServices：：CreateInstanceEnum或IWbemServices：：CreateInstanceEnumAsync的任何呼叫。
傳遞 IWbemCoNtext 物件會指示提供者允許部分實例擷取。 在完整實例擷取中，您會將 pCtx 設定為 Null 值。 如果提供者不支援部分實例擷取，您會收到錯誤訊息。
如果提供者不符合部分實例作業，提供者會繼續執行，就像您未輸入內容物件一樣，否則會傳回 WBEM_E_UNSUPPORTED_PARAMETER。
下列範例描述如何執行 Win32_LogicalDisk的完整實例擷取，然後執行 Win32_LogicalDisk.Caption 屬性的部分實例擷取。
#include <stdio.h>
#define _WIN32_DCOM
#include <wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")
#include <iostream>
using namespace std;
#include <comdef.h>
void main(void)
{
HRESULT hr;
_bstr_t bstrNamespace;
IWbemLocator *pWbemLocator = NULL;
IWbemServices *pServices = NULL;
IWbemClassObject *pDrive = NULL;
hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
hr = CoInitializeSecurity(NULL, -1, NULL, NULL,
RPC_C_AUTHN_LEVEL_CONNECT,
RPC_C_IMP_LEVEL_IMPERSONATE,
NULL, EOAC_NONE, 0);
if (FAILED(hr))
{
CoUninitialize();
cout << "Failed to initialize security. Error code = 0x"
<< hex << hr << endl;
return;
}
hr = CoCreateInstance(CLSID_WbemLocator, NULL,
CLSCTX_INPROC_SERVER, IID_IWbemLocator,
(void**) &pWbemLocator);
if( FAILED(hr) )
{
CoUninitialize();
printf("failed CoCreateInstance\n");
return;
}
bstrNamespace = L"root\\cimv2";
hr = pWbemLocator->ConnectServer(bstrNamespace,
NULL, NULL, NULL, 0, NULL, NULL, &pServices);
if( FAILED(hr) )
{
pWbemLocator->Release();
CoUninitialize();
printf("failed ConnectServer\n");
return;
}
pWbemLocator->Release();
printf("Successfully connected to namespace.\n");
BSTR bstrPath =
SysAllocString(L"Win32_LogicalDisk.DeviceID=\"C:\"");
// *******************************************************//
// Perform a full-instance retrieval.
// *******************************************************//
hr = pServices->GetObject(bstrPath,
0,0, &pDrive, 0);
if( FAILED(hr) )
{
pServices->Release();
CoUninitialize();
printf("failed GetObject\n");
return;
}
// Display the object
BSTR bstrDriveObj;
hr = pDrive->GetObjectText(0, &bstrDriveObj);
printf("%S\n\n", bstrDriveObj);
pDrive->Release();
pDrive = NULL;
// *****************************************************//
// Perform a partial-instance retrieval.
// *****************************************************//
IWbemContext *pctxDrive; // Create context object
hr = CoCreateInstance(CLSID_WbemContext, NULL,
CLSCTX_INPROC_SERVER, IID_IWbemContext,
(void**) &pctxDrive);
if (FAILED(hr))
{
pServices->Release();
pDrive->Release();
CoUninitialize();
printf("create instance failed for context object.\n");
return;
}
VARIANT vExtensions;
VARIANT vClient;
VARIANT vPropertyList;
VARIANT vProperty;
SAFEARRAY *psaProperties;
SAFEARRAYBOUND saBounds;
LONG lArrayIndex = 0;
// Add named values to the context object.
VariantInit(&vExtensions);
V_VT(&vExtensions) = VT_BOOL;
V_BOOL(&vExtensions) = VARIANT_TRUE;
hr = pctxDrive->SetValue(_bstr_t(L"__GET_EXTENSIONS"),
0, &vExtensions);
VariantClear(&vExtensions);
VariantInit(&vClient);
V_VT(&vClient) = VT_BOOL;
V_BOOL(&vClient) = VARIANT_TRUE;
hr = pctxDrive->SetValue(_bstr_t(L"__GET_EXT_CLIENT_REQUEST"),
0, &vClient);
VariantClear(&vClient);
// Create an array of properties to return.
saBounds.cElements = 1;
saBounds.lLbound = 0;
psaProperties = SafeArrayCreate(VT_BSTR, 1, &saBounds);
// Add the Caption property to the array.
VariantInit(&vProperty);
V_VT(&vProperty) = VT_BSTR;
V_BSTR(&vProperty) = _bstr_t(L"Caption");
SafeArrayPutElement(psaProperties, &lArrayIndex,
V_BSTR(&vProperty));
VariantClear(&vProperty);
VariantInit(&vPropertyList);
V_VT(&vPropertyList) = VT_ARRAY | VT_BSTR;
V_ARRAY(&vPropertyList) = psaProperties;
// Put the array in the named value __GET_EXT_PROPERTIES.
hr = pctxDrive->SetValue(_bstr_t(L"__GET_EXT_PROPERTIES"),
0, &vPropertyList);
VariantClear(&vPropertyList);
SafeArrayDestroy(psaProperties);
// Pass the context object as the pCtx parameter of GetObject.
hr = pServices->GetObject(bstrPath, 0, pctxDrive, &pDrive, 0);
if( FAILED(hr) )
{
pServices->Release();
CoUninitialize();
printf("failed property GetObject\n");
return;
}
// Display the object
hr = pDrive->GetObjectText(0, &bstrDriveObj);
printf("%S\n\n", bstrDriveObj);
SysFreeString(bstrPath);
VARIANT vFileSystem;
// Attempt to get a property that was not requested.
// The following should return a NULL property if
// the partial-instance retrieval succeeded.
hr = pDrive->Get(_bstr_t(L"FileSystem"), 0,
&vFileSystem, NULL, NULL);
if( FAILED(hr) )
{
pServices->Release();
pDrive->Release();
CoUninitialize();
printf("failed get for file system\n");
return;
}
if (V_VT(&vFileSystem) == VT_NULL)
printf("file system variable is null - expected\n");
else
printf("FileSystem = %S\n", V_BSTR(&vFileSystem));
VariantClear(&vFileSystem);
pDrive->Release();
pctxDrive->Release();
pServices->Release();
pServices = NULL; // MUST be set to NULL
CoUninitialize();
return; // -- program successfully completed
};
執行時，先前的程式碼範例會撰寫下列資訊。 第一個物件描述來自完整實例擷取。 第二個物件描述來自部分實例擷取。 最後一節顯示，如果您要求原始GetObject呼叫中未要求的屬性，就會收到Null值。
Successfully connected to namespace
instance of Win32_LogicalDisk
{
Caption = "C:";
Compressed = FALSE;
CreationClassName = "Win32_LogicalDisk";
Description = "Local Fixed Disk";
DeviceID = "C:";
DriveType = 3;
FileSystem = "NTFS";
FreeSpace = "3085668352";
MaximumComponentLength = 255;
MediaType = 12;
Name = "C:";
Size = "4581445632";
SupportsFileBasedCompression = TRUE;
SystemCreationClassName = "Win32_ComputerSystem";
SystemName = "TITUS";
VolumeName = "titus-c";
VolumeSerialNumber = "7CB4B90E";
};
instance of Win32_LogicalDisk
{
Caption = "C:";
CreationClassName = "Win32_LogicalDisk";
Description = "Local Fixed Disk";
DeviceID = "C:";
DriveType = 3;
MediaType = 12;
Name = "C:";
SystemCreationClassName = "Win32_ComputerSystem";
SystemName = "MySystem";
};
下列輸出是由上一個範例所產生。
file system variable is null - expected
Press any key to continue