Microsoft.SystemCenter.WSManagement.TimedEnumerateDiscoveryData
Updated: May 18, 2012
Applies To: System Center 2012 - Operations Manager, System Center 2012 R2 Operations Manager, System Center 2012 SP1 - Operations Manager
The Microsoft.SystemCenter.WSManagement.TimedEnumerateDiscoveryData data source module type 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" />
<xsd:element name="Expression" minOccurs="0" maxOccurs="1" type="ExpressionType" 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.Discovery.Scheduler">
<Scheduler>$Config/Scheduler$</Scheduler>
</DataSource>
<ProbeAction ID="Enumerator" TypeID="Microsoft.SystemCenter.WSManagement.Enumerator">
<Enumerate>$Config/Enumerate$</Enumerate>
</ProbeAction>
<ConditionDetection ID="Expression" TypeID="System!System.ExpressionFilter">
<Expression>
<And>
<Expression>
<Not>
<Expression>
<Exists>
<ValueExpression>
<XPathQuery Type="String">WsManData/ErrorCode</XPathQuery>
</ValueExpression>
</Exists>
</Expression>
</Not>
</Expression>
<Expression>$Config/Expression$</Expression>
</And>
</Expression>
</ConditionDetection>
<ConditionDetection ID="Mapper" TypeID="System!System.Discovery.ClassSnapshotDataMapper">
<ClassId>$Config/ClassId$</ClassId>
<InstanceSettings>$Config/InstanceSettings$</InstanceSettings>
</ConditionDetection>
</MemberModules>
<Composition>
<Node ID="Mapper">
<Node ID="Expression">
<Node ID="Enumerator">
<Node ID="Scheduler" />
</Node>
</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 |
Required parameter. Represents the schedule by which to trigger the Enumerate operation. |
|
|
Enumerate |
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 |
Optional parameter. Defines the key property values of the discovered class type instances. |
|
|
Expression |
Optional parameter. Defines an expression against which to match the data returned from the 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.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 |
Provides the schedule on which to trigger the Enumerate operation. |
|
|
2 |
Returns the results of the Enumerate operation. |
|
|
3 |
Filters the results of the Enumerate operation. |
|
|
4 |
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 |
|---|---|
|
A probe action module type that performs a WS-Management Enumerate operation. |
|
|
A probe action module type that performs a WS-Management Invoke operation. |
|
|
A probe action module type that performs a WS-Management Get operation. |
|
|
A data source module type that performs a WS-Management Enumerate operation. |
|
|
A data source module type that performs a scheduled WS-Management Get operation. |
|
|
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 |
|
|
Input Type |
None |
|
Output Type |
|
|
Implementation |
Composite |
|
Library |
Microsoft.SystemCenter.WSManagement.Library |