Policy/Portal deployments can automate the installation of software on devices according to your rules and configurations.
For ease of use, you need to import the Console-API-Module.All documentation can also be seen in the API Module.
Usage:
| Parameter: | Description: |
| uri | string, optional the address for the web service to be called e.g.: http://coreservername/five9sWS/five9sWS.asmx |
| pat | string, mandatory the Personal Access Token is a credential used to authenticate with our service |
| computerIdns | integer array a list of target device identificators for assigning software |
| hostnames | string array a list of target device names for assigning software requires Console version 5.1.30+ |
| serialnumbers | string array a list of target serial numbers for assigning software requires Console version 5.1.30+ |
| You either need computerIdns, hostnames, or serialnumber so that the target devices can be identified | |
| softwarePackageNames | string array, optional a list of software profile names to assign for the deployment job |
| ticketReference | string, optional a reference to a related record in a third-party system, used for audit and tracking purposes |
| ticketDescription | string, optional reason / description for the SW assignment, used for audit and tracking purposes |
| requester | string, optional name of the user that assigned the software, used for audit and tracking purposes |
Get started with the following PowerShell:
Import-Module $PSScriptRoot\Console-API-Module.psm1 -Verbose -Force #you need to execute this line once, so that powershell can offer intelliSense support
# Arrange the parameters
$wsdlUrl = "http://coreserver/five9sWS.asmx?wsdl" # web service URL, you need to replace the 'coreserver' with your actual value
$pat = "879067F0F16_YourPatHere_024214A4"
$computerIdns = 2,10382
$softwarePackageNames = @("CLU HTTP", "Gimp")
# Action
Invoke-AssignSwAsPolicy-uri $wsdlUrl -pat $pat -computerIdns $computerIdns -softwarePackageNames $softwarePackageNamesThe result from the request will look like this:
Software assignment done. Here is a list of assignments:
[CLU HTTP, 1]
[Gimp, 1]
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article