Returns the instances related to the source object through an association. Results are filtered based on the argument you pass in.
Arguments
Accepts the following arguments.
Argument | Description |
---|---|
class_name |
Name of the class for which you want to get the associated instances. |
selectors |
Set keys as a reference to a hash. Used to identify the instance of the class mentioned in the class_name argument. |
associationclassname (optional) |
Name of the association class for the instance. |
role (optional) |
Role that the object plays in the association class. The method filters the results according to the role. |
resultclassname (optional) |
Result class name, which must be present in the association. The method returns only those instances. |
resultrole (optional) |
Role that the result class plays in this instance. The method returns the results based on resultrole . |
includeresult (optional) |
Further filters query results based on properties of the instances. You can pass in properties as a name-value hash, then pass in a reference to this hash in the includeresult named argument. |
namespace |
Default CIM namespace. Default is root/cimv2. If the namespace is not root/cimv2, you must pass in the namespace of the class in this argument. |
Example
$client->EnumerateAssociatedInstances( class_name => 'CIM_Foo', selectors => \%hash; associationclassname => 'CIM_Bar', #optional role => 'CIM_Baz', #optional resultclassname => 'CIM_Bat', #optional resultrole => 'CIM_Quux', #optional includeresult => \%hash, #optional namespace => 'root/cimv2' #optional