3.3.4.74 StartTask

This operation can be used to signal the interest of the management client to trigger the specified IPAM task on the IPAM server.

 <wsdl:operation name="StartTask">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/StartTask" message="ipam:IIpamServer_StartTask_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/StartTaskResponse" message="ipam:IIpamServer_StartTask_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamServer_StartTask_InputMessage request message, the server performs the following processing steps. Upon successful completion of the steps specified below, the server MUST respond with the IIpamServer_StartTask_OutputMessage message. In the event of a failure, an appropriate SOAP fault MUST be sent to the client as specified in section 2.2.2.1.

  1. If StartTask.taskType is either IpamTaskType.None or specifies an invalid enumeration value, an appropriate SOAP fault MUST be generated.

  2. Retrieve the task corresponding to StartTask.taskType from ADM_Tasks table.

  3. If StartTask.server is passed as parameter, trigger the starting of the task with the StartTask.server as parameter. Otherwise trigger the starting of the task without the initial parameter.