PowerShell CLI - Use Cases - Count Licenses

Starting Situation

• Depending on the license model customers of a Commercial License are obliged to perform license measurement activities on a regular basis.
• The cmdlet Get-JobSchedulerInventory is provided that helps to keep track of JobScheduler Master and Agent instances in a network.
  • The JobScheduler Master instances are specified by the user.
  • The JobScheduler Agent instances are discovered from the JobScheduler Master instances.

Use Cases

Count licenses for a JobScheduler Master instance

The following sample show how to wait for completion of an order:

Import-Module JobScheduler

# Write the inventory information to the specified XML output file
Get-JobSchedulerInventory http://localhost:4444 -OutputFile /tmp/inventory.xml
 
# Append the inventory information to the specified XML output file
Get-JobSchedulerInventory http://somehost:4444 -OutputFile /tmp/inventory.xml -Append


# Append the inventory information and return the XML object
$inventory = Get-JobSchedulerInventory http://localhost:4444 -OutputFile /tmp/inventory.xml -Append

Explanations

• Line 4: The Get-JobSchedulerInventory cmdlet is used for the specified Master and writes the inventory information to the specified output file.
• Line 7: The Get-JobSchedulerInventory cmdlet is used to append the inventory information for the specified Master to the specified output file.
• Line 10: The Get-JobSchedulerInventory cmdlet is used to append the inventory information for the specified Master to the specified output file and to return the XML object.

The resulting XML output file will look like this:

<?xml version="1.0" encoding="iso-8859-1"?>
<Inventory>
  <Masters>
    <Master Id="scheduler110" Url="http://localhost:4444/" ProxyUrl="" Version="1.10.5" State="running" Pid="2832" RunningSince="2016-07-13T21:01:48Z" JobChainsExist="51" OrdersExist="32" JobsExist="121" TasksExist="0" TasksEnqueued="0" surveyCreated="2016-07-15T00:56:10Z">
      <Agents>
        <Agent isTerminating="False" hostname="APMACWIN" currentTaskCount="0" startedAt="2016-07-13T21:01:52.591Z" version="1.10.5" totalTaskCount="0" Url="http://localhost:4445" MasterUrl="http://localhost:4444/" PSComputerName="localhost" RunspaceId="ec48894a-b518-4f30-a98d-814586cdb1cd" surveyCreated="2016-07-15T00:56:10Z" />
        <Agent isTerminating="" hostname="" currentTaskCount="" startedAt="" version="" totalTaskCount="" Url="http://andreas-macbook-pro.local:4445" MasterUrl="http://localhost:4444/" PSComputerName="localhost" RunspaceId="343bcade-cec6-4f1b-ab93-a101ed54e5f5" surveyCreated="2016-07-15T00:56:10Z" />
        <Agent isTerminating="" hostname="" currentTaskCount="" startedAt="" version="" totalTaskCount="" Url="http://wilma.sos:4445" MasterUrl="http://localhost:4444/" PSComputerName="localhost" RunspaceId="e9c5c335-d281-4f69-941d-30ead8d0ea4b" surveyCreated="2016-07-15T00:56:10Z" />
        <Agent isTerminating="" hostname="" currentTaskCount="" startedAt="" version="" totalTaskCount="" Url="http://galadriel.sos:4110" MasterUrl="http://localhost:4444/" PSComputerName="localhost" RunspaceId="5e8415ef-7838-4459-bdb7-8d066eb04f96" surveyCreated="2016-07-15T00:56:10Z" />
      </Agents>
    </Master>
  </Masters>
</Inventory>

Count licenses for a number of JobScheduler Master instances

The following sample shows how to use native PowerShell jobs to run a number of JobScheduler orders in parallel and to wait for completion of all orders. As orders are executed in parallel by JobScheduler it is more effective to use asynchronous native PowerShell jobs than to wait for each native PowerShell job individually as from the above sample:

Import-Module JobScheduler

# Write the inventory information for JobScheduler Master instances specified by a CSV input file to the specified XML output file
Get-JobSchedulerInventory -InputFile /tmp/inventory.csv -OutputFile /tmp/inventory.xml
 
# Create a list of JobScheduler Master instances that is piped to the cmdlet and write the inventory to the specified XML output file
$instances = @( 'http://localhost:4444', 'http://somehost:4444' )
$inventory = $instances | Get-JobSchedulerInventory -OutputFile /tmp/inventory.xml -Append

Explanations

• Line 4: Makes use of a CSV input file that contains the URLs of the respective JobScheduler Master instances as the first column.
• Line 7: Creates a hashmap of JobScheduler Master URLs.
• Line 8: Pipes the hashmap to the Get-JobSchedulerInventory cmdlet and appends the inventory information to the specified XML output file.

The CSV input file would look like this:

http://localhost:4444
http://somehost:4444