Web Services Reference › Methods › Software › Software Jobs › CreateInstallSoftwareJob3

More Information:

CreateInstallSoftwareJobOrderPolicyProperties3

CreateInstallSoftwareJob3

The CreateInstallSoftwareJob3 method creates a new software job of type Install.

Additionally, this method provides the functionality to shut down a target computer after completion of the jobs. The method takes the sequence CreateInstallSoftwareJobOrderProperties3, which includes another sequence SoftwareJobBootMask3. The SoftwareJobBootMask3 sequence contains the option ShutdownAfterLast that lets you shut down the target computer after completion of the jobs.

This method also includes the functionality that helps you manage the custom administrator message. For the custom administrator message, the sequence CreateInstallSoftwareJobOrderProperties3 includes two parameters: userMessage, which takes the message input from the user, and userMessageSupplied, which checks the presence of the userMessage field for the custom administrator message in SD.

Parameters

xsd:string sessionId (^m)

Specifies the session ID obtained from the login to the web service.

xsd:string softwarePackageProcedureId (^m)

Specifies the UUID identifying the software package procedure that the job must use.

CreateInstallSoftwareJobOrderProperties3 createInstallSoftwareJobOrderProperties3

Specifies the properties required to create and order a software job.

xsd:string softwarejobContainerId (^m)

Specifies the UUID identifying the job container associated with this new software job.

ArrayOfstring unitIds

Specifies an array of UUIDs identifying the units to which the job must be applied.

ArrayOfstring unitGroupIds

Specifies an array of UUIDs identifying the unit groups to which the job must be applied.

Return Values

xsd:string softwareJobId

Returns the UUID of the new job if a software Install job is successfully created.

Remarks

None