检索 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 对象来指示提供程序处理部分实例检索。
在 IWbemContext 对象中添加 __GET_EXTENSIONS、__GET_EXT_CLIENT_REQUEST，以及用于描述要检索的属性的任何其他命名值。
下表列出了要在检索调用中使用的不同命名值。
命名值 说明 __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
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈