Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Microsoft.SystemCenter.WSManagement.TimedEnumerateDiscoveryData

System Center

Updated: September 16, 2011

The Microsoft.SystemCenter.WSManagement.TimedEnumerateDiscoveryData data source module type takes calls the WS-Management Enumerate operation on a WS-Management resource on a scheduled interval. This module returns the results of the enumeration as System.Discovery.Data.

Usage

Use this module to discover resources that can be enumerated as instances of a WS-Management resource.

Type Definition

<DataSourceModuleType ID="Microsoft.SystemCenter.WSManagement.TimedEnumerateDiscoveryData" Accessibility="Public" RunAs="Microsoft.SystemCenter.WSManagement.WSManActionAccount" Batching="false">
  <Configuration>
    <IncludeSchemaTypes>
      <SchemaType>System!System.ExpressionEvaluatorSchema</SchemaType>
      <SchemaType>System!System.Discovery.MapperSchema</SchemaType>
      <SchemaType>Microsoft.SystemCenter.WSManagement.Schemas</SchemaType>
    </IncludeSchemaTypes>
    <xsd:element name="Scheduler" type="PublicSchedulerType" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
    <xsd:element name="Enumerate" type="EnumerateSchema" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
    <xsd:element name="ClassId" type="xsd:string" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
    <xsd:element name="InstanceSettings" minOccurs="0" maxOccurs="1" type="SettingsType" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
  </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">
    <Composite>
      <MemberModules>
        <DataSource ID="Scheduler" TypeID="System!System.Scheduler">
          <Scheduler>$Config/Scheduler$</Scheduler>
        </DataSource>
        <ProbeAction ID="Enumerator" TypeID="Microsoft.SystemCenter.WSManagement.Enumerator">
          <Enumerate>$Config/Enumerate$</Enumerate>
        </ProbeAction>
        <ConditionDetection ID="Mapper" TypeID="System!System.Discovery.ClassSnapshotDataMapper">
          <ClassId>$Config/ClassId$</ClassId>
          <InstanceSettings>$Config/InstanceSettings$</InstanceSettings>
        </ConditionDetection>
      </MemberModules>
      <Composition>
        <Node ID="Mapper">
          <Node ID="Enumerator">
            <Node ID="Scheduler" />
          </Node>
        </Node>
      </Composition>
    </Composite>
  </ModuleImplementation>
  <OutputType>System!System.Discovery.Data</OutputType>
</DataSourceModuleType>

Parameters

The Microsoft.SystemCenter.WSManagement.TimedEnumerateDiscoveryData module supports the following configuration parameters.

 

Parameter Type Description

Scheduler

PublicSchedulerType

Required parameter. Represents the schedule by which to trigger the Enumerate operation.

Enumerate

EnumerateSchema

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

ClassId

String

Required parameter. Specifies the ID of the class type into which the discovery data is to be mapped.

InstanceSettings

SettingsType

Optional parameter. Defines the key property values of the discovered class type instances.

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.TimedEnumerateDiscoveryData module is a composite module that contains the member modules that are described in the following table.

 

Workflow Run Order Module Type Usage

1

System.Scheduler

Provides the schedule on which to trigger the Enumerate operation.

2

Microsoft.SystemCenter.WSManagement.Enumerator

Returns the results of the Enumerate operation.

3

System.Discovery.ClassSnapShotDataMapper

Maps the results of the Enumerate operation to System.Discovery.Data data.

Remarks

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

Related Modules

 

Module Type Usage

Microsoft.SystemCenter.WSManagement.Enumerator

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

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.TimedEnumerator

A data source module type that performs a WS-Management Enumerate 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

None.

Sample

The following XML sample demonstrates a discovery that enumerates all logical disk instances using the Win32_LogicalDisk resource on the target computer. This sample discovers a custom class with a key property called Name and that is hosted by Microsoft.Windows.Computer.


<Discovery ID="Microsoft.Samples.TimedEnumeratorDiscovery" Enabled="true" Target="Windows!Microsoft.Windows.Computer" ConfirmDelivery="false" Remotable="true" Priority="Normal">
   <Category>Discovery</Category>
   <DiscoveryTypes>
      <DiscoveryClass TypeID="Microsoft.Samples.LogicalDisk"/>
   </DiscoveryTypes>
   <DataSource ID="DS" TypeID="WSManLibrary!Microsoft.SystemCenter.WSManagement.TimedEnumerateDiscoveryData">
      <Scheduler>
         <SimpleReccuringSchedule>
            <Interval Unit="Minutes">86400</Interval>
         </SimpleReccuringSchedule>
         <ExcludeDates/>
      </Scheduler>
      <Enumerate>
         <Protocol>http</Protocol>
         <TargetSystem>$Target/Property[Type="Windows!Microsoft.Windows.Computer"]/PrincipalName$</TargetSystem>
         <Port>5985</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_LogicalDisk</Uri>
         <Filter/>
         <TimeOutInMS>2000</TimeOutInMS>
         <SplitItems>true</SplitItems>
      </Enumerate>
      <ClassId>$MPElement[Name="Microsoft.Samples.LogicalDisk"]$</ClassId>
      <InstanceSettings>
         <Settings>
            <Setting>
               <Name>$MPElement[Name="Windows!Microsoft.Windows.Computer"]/PrincipalName$</Name>
               <Value>$Target/Property[Type="Windows!Microsoft.Windows.Computer"]/PrincipalName$</Value>
            </Setting>
            <Setting>
               <Name>$MPElement[Name="Microsoft.Samples.LogicalDisk"]/Name$</Name>
               <Value>$Data/WsManData/*[local-name()="Win32_LogicalDisk"]/*[local-name()="Name"]$</Value>
            </Setting>
         </Settings>
      </InstanceSettings>
   </DataSource>
</Discovery>

Information

 

   

Module Type

DataSourceModuleType

Input Type

None

Output Type

System.Discovery.Data

Implementation

Composite

Library

Microsoft.SystemCenter.WSManagement.Library

 
Show:
© 2015 Microsoft