discovery.wbemQuery
discovery.wbemQuery(target, class_name, [properties], namespace)
Performs a WBEM query on the target and returns a list of DiscoveredWBEM
DDD nodes.This is not a generic query for any device managed by WBEM; rather, it has been implemented solely as a part of storage discovery. Using it for any other purpose is untested and may provide unexpected results and very likely return extremely large lists of DDD nodes.
Where:
target
– the endpoint being scanned, usually a node kind which can be used to get to the DiscoveryAccess, for example, a host node.class_name
– the name of the WBEM (CIM) class being queried, for example,CIM_LogicalElement
.properties
– a list of properties to be retrieved from the class. Where a specified property does not exist on the target, it is ignored. Theproperties
list is not case sensitive, for example, if you requeststuff
and the property is calledSTUFF
orStuff
, it is returned, but in the case in which it is returned is the same as it is on the target.- The
properties
list may be empty. namespace
– the WBEM namespace to query, for example,root/cimv2
. Used with theclass_name
to identify objects of interest.
Returns a list of DiscoveredWBEM
DDD nodes which hold the results. Each DiscoveredWBEM
node has a list of attributes corresponding to those specified in the properties
list, plus a __PATH
attribute representing the local WBEM instance path for the object. The __PATH
attribute is returned whether the properties
list is empty or not.
If the call fails, none are returned.
An additional WBEM credential is required which matches the endpoint being scanned. This is not the host credential used to scan the endpoint.
Comments
Log in or register to comment.