Web Services Reference › Methods › Software › Software Policies › CreateSoftwarePolicyByName3

CreateSoftwarePolicyByName3

The CreateSoftwarePolicyByName3 method creates a software policy based on the specified name of the software policy. The name of the unit group (unitGroupName) to which the policy is attached is a mandatory parameter. Make sure that you take into consideration the following points related to unitGroupName:

• If unitGroupName is provided, the method searches for it. If the method finds the unit group name, the method links the unit group name with the created policy.
• If unitGroupName is provided, the method searches for it. If the method does not find the unit group name, the method creates the unitGroup and links it with the created software policy.
• If unitGroupName is not provided, the software policy is created without a link to any unit group.

This method also includes the functionality that helps you manage the custom administrator message. The method takes the sequence CreateSoftwarePlicyProperties3. This sequence 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.

UnitGroupPropertiesForSoftwarePolicy unitGroupPropertiesForSoftwarePolicy

Specifies the details of the unit group to which the created software policy is linked. If not supplied, the software policy is created without a link to any unit group.

CreateSoftwarePolicyProperties3 createSoftwarePolicyProperties3 (m)

Specifies the properties associated with the software policy. The sequence is mandatory, but providing all the members of the sequence is not mandatory.

Return Values

xsd:string softwarePolicyId

Returns a string that contains the UUID of the newly created policy if the software policy is successfully created.

Remarks

None

More information:

CreateSoftwarePolicyProperties3