Microsoft.SystemCenter.WSManagement.Enumerator

System Center

Updated: August 10, 2011

Applies To: Operations Manager 2007 R2

The Microsoft.SystemCenter.WSManagement.Enumerator probe action module type calls the WS-Management Enumerate operation on a WS-Management resource. This module returns the results of the enumeration as Microsoft.SystemCenter.WSManagement.WSManData.

Usage

Use this module to enumerate instances of a WS-Management resource and return the results from within a workflow.

Type Definition


<ProbeActionModuleType ID="Microsoft.SystemCenter.WSManagement.Enumerator" Accessibility="Public" RunAs="Microsoft.SystemCenter.WSManagement.WSManActionAccount" Batching="false" PassThrough="false">
  <Configuration>
    <IncludeSchemaTypes>
      <SchemaType>Microsoft.SystemCenter.WSManagement.Schemas</SchemaType>
    </IncludeSchemaTypes>
    <xsd:element name="Enumerate" type="EnumerateSchema" />
  </Configuration>
  <OverrideableParameters>
    <OverrideableParameter ID="Protocol" Selector="$Config/Enumerate/Protocol$" ParameterType="string" />
    <OverrideableParameter ID="TargetSystem" Selector="$Config/Enumerate/TargetSystem$" ParameterType="string" />
    <OverrideableParameter ID="Port" Selector="$Config/Enumerate/Port$" ParameterType="int" />
    <OverrideableParameter ID="Authentication" Selector="$Config/Enumerate/Authentication$" ParameterType="string" />
    <OverrideableParameter ID="UserName" Selector="$Config/Enumerate/UserName$" ParameterType="string" />
    <OverrideableParameter ID="Password" Selector="$Config/Enumerate/Password$" ParameterType="string" />
    <OverrideableParameter ID="SkipCACheck" Selector="$Config/Enumerate/SkipCACheck$" ParameterType="bool" />
    <OverrideableParameter ID="SkipCNCheck" Selector="$Config/Enumerate/SkipCNCheck$" ParameterType="bool" />
    <OverrideableParameter ID="OutputErrorIfAny" Selector="$Config/Enumerate/OutputErrorIfAny$" ParameterType="bool" />
    <OverrideableParameter ID="UTF" Selector="$Config/Enumerate/UTF$" ParameterType="string" />
    <OverrideableParameter ID="Uri" Selector="$Config/Enumerate/Uri$" ParameterType="string" />
    <OverrideableParameter ID="Filter" Selector="$Config/Enumerate/Filter$" ParameterType="string" />
    <OverrideableParameter ID="TimeOutInMS" Selector="$Config/Enumerate/TimeOutInMS$" ParameterType="int" />
    <OverrideableParameter ID="SplitItems" Selector="$Config/Enumerate/SplitItems$" ParameterType="bool" />
  </OverrideableParameters>
  <ModuleImplementation Isolation="Any">
    <Native>
      <ClassID>91564CE8-81DE-4D52-9AC5-A6FB6B9AB0EB</ClassID>
    </Native>
  </ModuleImplementation>
  <OutputType>Microsoft.SystemCenter.WSManagement.WSManData</OutputType>
  <InputType>System!System.BaseData</InputType>
</ProbeActionModuleType>

Parameters

The Microsoft.SystemCenter.WSManagement.Enumerator module supports the configuration parameters described in the following table.

 

Parameter Type Overrideable Description

Enumerate

EnumerateSchema

False

Contains the schema used to specify the set of properties required to perform a WS-Management Enumerate operation

All of the sub-elements in the Enumerate parameter are marked as overrideable.

For more information about the Enumerate parameter, see EnumerateSchema.

Composition

The Microsoft.SystemCenter.WSManagement.Enumerator module is a native module.

Related Modules

 

Module Type Usage

Microsoft.SystemCenter.WSManagement.Invoker

A probe action module type that performs a WS-Management Invoke operation.

Microsoft.SystemCenter.WSManagement.Getter

A probe action module type that performs a WS-Management Get operation.

Microsoft.SystemCenter.WSManagement.TimedGetter

A data source module type that performs a scheduled WS-Management Get operation.

Microsoft.SystemCenter.WSManagement.TimedInvoker

A data source module type that performs a scheduled WS-Management Invoke operation.

External Module References

The Microsoft.SystemCenter.WSManagement.Enumerator module is a member of the module described in the following table.

 

Module Type Library Usage

Microsoft.SystemCenter.WSManagement.TimedEnumerator

Microsoft.SystemCenter.WSManagement.Library

A data source module type that performs a scheduled WS-Management Enumerate operation from within a discovery workflow to return discovery data.

Remarks

For remarks, see the Microsoft.SystemCenter.WSManagement.Getter module type.

Sample

The following XML sample demonstrates a task that enumerates all running instances of the Win32_Service resource on the target computer:


<Task ID="WSMan.Demo.Task.Enumerate" Accessibility="Internal" Enabled="true" Target="Windows!Microsoft.Windows.Computer" Timeout="300" Remotable="true">
  <Category>Custom</Category>
  <ProbeAction ID="wsmanget" TypeID="WSManLibrary!Microsoft.SystemCenter.WSManagement.Enumerator">
    <Enumerate>
      <Protocol>http</Protocol>
      <TargetSystem>$Target/Property[Type="Windows!Microsoft.Windows.Computer"]/PrincipalName$</TargetSystem>
      <Port>80</Port>
      <Authentication>kerberos</Authentication>
      <UserName />
      <Password />
      <SkipCACheck>true</SkipCACheck>
      <SkipCNCheck>true</SkipCNCheck>
      <UTF>utf-8</UTF>
      <Uri>http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service </Uri>
      <Filter>SELECT * FROM Win32_Service WHERE State=’Running'</Filter>
      <TimeOutInMS>2000</TimeOutInMS>
      <SplitItems>false</SplitItems>
    </Enumerate>
  </ProbeAction>
</Task>

The following XML shows sample data item output from the task in the preceding section of this example.


<DataItem type ="Microsoft.SystemCenter.WSManagement.WSManData" time =" 2008-10-23T11:12:51.1451250-04:00 " sourceHealthServiceId =" CC9FCD47-4887-8AE7-A72F-2EACF9C2F1D9 ">
 <WsManData>
 <p:Win32_Service xsi:type ="p:Win32_Service_Type" xml:lang ="en-US">
  <p:AcceptPause>false</p:AcceptPause>
  <p:AcceptStop>true</p:AcceptStop>
  <p:Caption>Print Spooler</p:Caption>
  <p:CheckPoint>0</p:CheckPoint>
  <p:CreationClassName>Win32_Service</p:CreationClassName>
  <p:Description>Manages all local and network print queues and controls all printing jobs. If this service is stopped, printing on the local machine will be unavailable. If this service is disabled, any services that explicitly depend on it will fail to start.</p:Description>
  <p:DesktopInteract>true</p:DesktopInteract>
  <p:DisplayName>Print Spooler</p:DisplayName>
  <p:ErrorControl>Normal</p:ErrorControl>
  <p:ExitCode>0</p:ExitCode>
  <p:InstallDate xsi:nil =" true " />
  <p:Name>spooler</p:Name>
  <p:PathName>C:\WINDOWS\system32\spoolsv.exe</p:PathName>
  <p:ProcessId>1252</p:ProcessId>
  <p:ServiceSpecificExitCode>0</p:ServiceSpecificExitCode>
  <p:ServiceType>Own Process</p:ServiceType>
  <p:Started>true</p:Started>
  <p:StartMode>Auto</p:StartMode>
  <p:StartName>LocalSystem</p:StartName>
  <p:State>Running</p:State>
  <p:Status>OK</p:Status>
  <p:SystemCreationClassName>Win32_ComputerSystem</p:SystemCreationClassName>
  <p:SystemName>RED-DC-01</p:SystemName>
  <p:TagId>0</p:TagId>
  <p:WaitHint>0</p:WaitHint>
 </p:Win32_Service>

 <p:Win32_Service xsi:type ="p:Win32_Service_Type" xml:lang ="en-US">
  <p:AcceptPause>false</p:AcceptPause>
  <p:AcceptStop>true</p:AcceptStop>
  <p:Caption>Virtual Disk</p:Caption>
  <p:CheckPoint>0</p:CheckPoint>
  <p:CreationClassName>Win32_Service</p:CreationClassName>
  <p:Description>Provides management services for disks, volumes, file systems, and storage arrays.</p:Description>
  <p:DesktopInteract>false</p:DesktopInteract>
  <p:DisplayName>Virtual Disk</p:DisplayName>
  <p:ErrorControl>Normal</p:ErrorControl>
  <p:ExitCode>0</p:ExitCode>
  <p:InstallDate xsi:nil ="true" />
  <p:Name>vds</p:Name>
  <p:PathName>C:\WINDOWS\system32\vds.exe</p:PathName>
  <p:ProcessId>1254</p:ProcessId>
  <p:ServiceSpecificExitCode>0</p:ServiceSpecificExitCode>
  <p:ServiceType>Own Process</p:ServiceType>
  <p:Started>true</p:Started>
  <p:StartMode>Manual</p:StartMode>
  <p:StartName>LocalSystem</p:StartName>
  <p:State>Running</p:State>
  <p:Status>OK</p:Status>
  <p:SystemCreationClassName>Win32_ComputerSystem</p:SystemCreationClassName>
  <p:SystemName>RED-DC-01</p:SystemName>
  <p:TagId>0</p:TagId>
  <p:WaitHint>0</p:WaitHint>
 </p:Win32_Service>
  </WsManData>
 </DataItem>

Information

 

   

Module Type

ProbeActionModuleType

Input Type

System.BaseData

Output Type

Microsoft.SystemCenter.WSManagement.WSManData

Implementation

Native

Library

Microsoft.SystemCenter.WSManagement.Library

 
Show: