Microsoft.SystemCenter.WSManagement.Invoker
Applies To: System Center 2012 - Operations Manager, System Center 2012 R2 Operations Manager, System Center 2012 SP1 - Operations Manager
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 |
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 |
|---|---|
A probe action module type that performs a WS-Management Enumerate operation. |
|
A probe action module type that performs a WS-Management Get operation. |
|
A data source module type that performs a scheduled WS-Management Enumerate operation from within a discovery workflow to return discovery data. |
|
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.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>https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process</Uri>
<Selector/>
<InvokeAction>Create</InvokeAction>
<Input><p:Create_INPUT xmlns:p="https://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 |
|
Input Type |
|
Output Type |
|
Implementation |
Native |
Library |
Microsoft.SystemCenter.WSManagement.Library |