Web Services Reference › Methods › Software › Software Jobs › CreateInstallSoftwareJobInSoftwarePolicy3

More Information:

CreateInstallSoftwareJobOrderPolicyProperties3

CreateInstallSoftwareJobInSoftwarePolicy3

The CreateInstallSoftwareJobInSoftwarePolicy3 method creates a new software job of type Install within a given software policy.

Additionally, this method provides the functionality to shut down a target computer after completion of the jobs. The method takes the sequence CreateInstallSoftwareJobOrderPolicyProperties3, 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 CreateInstallSoftwareJobOrderPolicyProperties3 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.

CreateInstallSoftwareJobOrderPolicyProperties3 createInstallSoftwareJobOrderPolicyProperties3 (^m)

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

xsd:string softwarePolicyId (^m)

Specifies the UUID identifying the software policy in which you must create the software job.

Return Values

xsd:string softwareJobId

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

Remarks

None