Web Services Reference › Methods › Software › Priority, Reinstall, and Policy Enhancement › CreateInstallSoftwareJobInSoftwarePolicyByName3

CreateInstallSoftwareJobInSoftwarePolicyByName3

The CreateInstallSoftwareJobInSoftwarePolicyByName3 method creates a new software job of type Install within a 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.

SoftwarePackage softwarePackage (m)

Specifies the software package details.

xsd: string softwarePackageProcedureName (m)

Specifies the name of the install procedure for the software package.

CreateInstallSoftwareJobOrderPolicyProperties3 installSoftwareJobOrderPolicyProperties3 (m)

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

xsd:string softwarePolicyName (m)

Specifies the name of 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

More information:

CreateInstallSoftwareJobOrderPolicyProperties