Microsoft.SystemCenter.WSManagement.Invoker

System Center

Updated: August 10, 2011

Applies To: Operations Manager 2007 R2

The Microsoft.SystemCenter.WSManagement.Invoker probe action module type calls the WS-Management Invoke operation to run a method on a WS-Management resource. This module returns the results of the invocation as Microsoft.SystemCenter.WSManagement.WSManData.

Usage

Use this module to invoke a method on a WS-Management resource and return the results from within a workflow.

Type Definition


<ProbeActionModuleType ID="Microsoft.SystemCenter.WSManagement.Invoker" Accessibility="Public" RunAs="Microsoft.SystemCenter.WSManagement.WSManActionAccount" Batching="false" PassThrough="false">
  <Configuration>
    <IncludeSchemaTypes>
      <SchemaType>Microsoft.SystemCenter.WSManagement.Schemas</SchemaType>
    </IncludeSchemaTypes>
    <xsd:element name="Invoke" type="InvokeSchema" />
  </Configuration>
  <OverrideableParameters>
    <OverrideableParameter ID="Protocol" Selector="$Config/Invoke/Protocol$" ParameterType="string" />
    <OverrideableParameter ID="TargetSystem" Selector="$Config/Invoke/TargetSystem$" ParameterType="string" />
    <OverrideableParameter ID="Port" Selector="$Config/Invoke/Port$" ParameterType="int" />
    <OverrideableParameter ID="Authentication" Selector="$Config/Invoke/Authentication$" ParameterType="string" />
    <OverrideableParameter ID="UserName" Selector="$Config/Invoke/UserName$" ParameterType="string" />
    <OverrideableParameter ID="Password" Selector="$Config/Invoke/Password$" ParameterType="string" />
    <OverrideableParameter ID="SkipCACheck" Selector="$Config/Invoke/SkipCACheck$" ParameterType="bool" />
    <OverrideableParameter ID="SkipCNCheck" Selector="$Config/Invoke/SkipCNCheck$" ParameterType="bool" />
    <OverrideableParameter ID="OutputErrorIfAny" Selector="$Config/Invoke/OutputErrorIfAny$" ParameterType="bool" />
    <OverrideableParameter ID="UTF" Selector="$Config/Invoke/UTF$" ParameterType="string" />
    <OverrideableParameter ID="Uri" Selector="$Config/Invoke/Uri$" ParameterType="string" />
    <OverrideableParameter ID="Selector" Selector="$Config/Invoke/Selector$" ParameterType="string" />
    <OverrideableParameter ID="InvokeAction" Selector="$Config/Invoke/InvokeAction$" ParameterType="string" />
    <OverrideableParameter ID="Input" Selector="$Config/Invoke/Input$" ParameterType="string" />
    <OverrideableParameter ID="TimeOutInMS" Selector="$Config/Invoke/TimeOutInMS$" ParameterType="int" />
  </OverrideableParameters>
  <ModuleImplementation Isolation="Any">
    <Native>
      <ClassID>4427C733-42AE-4133-84FD-BEE4A3830EC0</ClassID>
    </Native>
  </ModuleImplementation>
  <OutputType>Microsoft.SystemCenter.WSManagement.WSManData</OutputType>
  <InputType>System!System.BaseData</InputType>
</ProbeActionModuleType>

Parameters

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

 

Parameter Type Overrideable Description

Invoke

InvokeSchema

False

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

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

For more information about the Invoke parameter, see InvokeSchema.

Composition

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

Related Modules

 

Module Type Usage

Microsoft.SystemCenter.WSManagement.Enumerator

A probe action module type that performs a WS-Management Enumerate 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 scheduled WS-Management Enumerate operation from within a discovery workflow to return discovery data.

Microsoft.SystemCenter.WSManagement.TimedGetter

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

External Module References

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

 

Module Type Library Usage

Microsoft.SystemCenter.WSManagement.TimedInvoker

Microsoft.SystemCenter.WSManagement.Library

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

Remarks

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

Sample

The following XML sample demonstrates a task that is implemented to invoke the Create method on the Win32_ Process resource:


<Task ID="WSMan.Demo.Task.Invoke" Accessibility="Internal" Enabled="true" Target="Windows!Microsoft.Windows.Computer" Timeout="300" Remotable="true">
  <Category>Custom</Category>
  <ProbeAction ID="wsmaninvoke" TypeID="MicrosoftSystemCenterWSManagementLibrary!Microsoft.SystemCenter.WSManagement.Getter">
    <Invoke>
      <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_Process</Uri>
      <Selector/>
      <InvokeAction>Create</InvokeAction>
      <Input><p:Create_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process><p:CommandLine>calc.exe</p:CommandLine></p:Create_INPUT> </Input>
      <TimeOutInMS>2000</TimeOutInMS>
    </Invoke>
  </ProbeAction>
</Task>

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


<DataItem type ="Microsoft.SystemCenter.WSManagement.WSManData" time =" 2008-10-23T11:12:51.1451250-04:00 " sourceHealthServiceId =" CC9FCD47-4887-8AE7-A72F-2EACF9C2F1D9 ">
 <WsManData>
  <p:Win32_Process xsi:type ="p:Win32_Process_Type" xml:lang ="en-US">
    <p:ProcessId>5260</p:ProcessId>
    <p:ReturnValue>0</p:ReturnValue>
   </p:Win32_Process>
  </WsManData>
 </DataItem>

Information

 

   

Module Type

ProbeActionModuleType

Input Type

System.BaseData

Output Type

Microsoft.SystemCenter.WSManagement.WSManData

Implementation

Native

Library

Microsoft.SystemCenter.WSManagement.Library

 
Show: