TestimoX

API Reference

Class

WmiQuery

Edit on GitHub
Namespace ComputerX.Wmi
Assembly ComputerX
Source ComputerX/Wmi/WmiQuery.cs:49
Modifiers static
Attributes
SupportedOSPlatform("windows")

High-level helpers that perform WMI/CIM queries with built-in transport fallback and diagnostics metadata. Keeps examples clean and centralizes resiliency.

Inheritance

  • Object
  • WmiQuery

Methods

public static WmiQueryResult Query(String computer, String namespace, String query, Transport transport, Nullable<TimeSpan> timeout = null, CancellationToken ct = null) #
ComputerX/Wmi/WmiQuery.cs:49
Returns: WmiQueryResult

Runs a WMI/CIM query using the specified transport.

Parameters

computer System.String requiredposition: 0
Target computer name or IP.
namespace System.String requiredposition: 1
Target WMI/CIM namespace (e.g., root\cimv2).
query System.String requiredposition: 2
WQL query string.
transport ComputerX.Wmi.WmiQuery.Transport requiredposition: 3
Transport to use (Wmi or Cim).
timeout System.Nullable{System.TimeSpan} = null optionalposition: 4
Optional timeout per query.
ct System.Threading.CancellationToken = null optionalposition: 5
Cancellation token.

Returns

Rows and diagnostics for the query.

public static async Task<WmiQueryResult> QueryAsync(String computer, String namespace, String query, Transport transport, Nullable<TimeSpan> timeout = null, CancellationToken ct = null) #
Returns: Task<WmiQueryResult>

Runs a WMI/CIM query asynchronously using the specified transport.

Parameters

computer System.String requiredposition: 0
Target computer name or IP.
namespace System.String requiredposition: 1
Target WMI/CIM namespace (e.g., root\cimv2).
query System.String requiredposition: 2
WQL query string.
transport ComputerX.Wmi.WmiQuery.Transport requiredposition: 3
Transport to use (Wmi or Cim).
timeout System.Nullable{System.TimeSpan} = null optionalposition: 4
Optional timeout per query.
ct System.Threading.CancellationToken = null optionalposition: 5
Cancellation token.

Returns

Rows and diagnostics for the query.

public static WmiQueryResult QueryWithFallback(String computer, String namespace, String query, Boolean preferCimFirst = false, Nullable<TimeSpan> timeout = null, CancellationToken ct = null) #
ComputerX/Wmi/WmiQuery.cs:153
Returns: WmiQueryResult

Runs a WMI/CIM query, optionally preferring CIM first and falling back to WMI if necessary.

Parameters

computer System.String requiredposition: 0
Target computer name or IP.
namespace System.String requiredposition: 1
Target WMI/CIM namespace (e.g., root\cimv2).
query System.String requiredposition: 2
WQL query string.
preferCimFirst System.Boolean = false optionalposition: 3
When true, try CIM first; otherwise start with WMI.
timeout System.Nullable{System.TimeSpan} = null optionalposition: 4
Optional timeout per query.
ct System.Threading.CancellationToken = null optionalposition: 5
Cancellation token.

Returns

Rows and diagnostics for the query, with fallback information.

public static async Task<WmiQueryResult> QueryWithFallbackAsync(String computer, String namespace, String query, Boolean preferCimFirst = false, Nullable<TimeSpan> timeout = null, CancellationToken ct = null) #
Returns: Task<WmiQueryResult>

Runs a WMI/CIM query asynchronously, optionally preferring CIM first and falling back to WMI if necessary.

Parameters

computer System.String requiredposition: 0
Target computer name or IP.
namespace System.String requiredposition: 1
Target WMI/CIM namespace (e.g., root\cimv2).
query System.String requiredposition: 2
WQL query string.
preferCimFirst System.Boolean = false optionalposition: 3
When true, try CIM first; otherwise start with WMI.
timeout System.Nullable{System.TimeSpan} = null optionalposition: 4
Optional timeout per query.
ct System.Threading.CancellationToken = null optionalposition: 5
Cancellation token.

Returns

Rows and diagnostics for the query, with fallback information.