This document is a step-by-step guide to mass deploy Virtual Airtame applications on Windows machines, using a Mass Deployment Key mechanism.
The mass deployment key is a unique identifier key for an Airtame Cloud group that allows the Virtual Airtame apps that are deployed with it, to automatically receive a token from Airtame Cloud. Once the token has been exchanged, the Virtual Airtame is able to communicate with Airtame Cloud and will appear online in the group associated with the provided deployment key.
After the following steps are performed, your Virtual Airtame will:
- Appear online in the Cloud
- Get Airtame default settings
- Use the Windows machine name as default name
Pre-requisites:
- You should have an Airtame Cloud organization where the Virtual Airtame will be added. You can get more detailed information about Airtame Cloud in this knowledge center article: How to Create an Airtame Cloud account
- Download the Virtual Airtame for Windows package from the Airtame website
- Request access to this feature to the Airtame Support
Get the deployment key from Airtame Cloud
- Log into your Airtame Cloud organization
- Select a device group and click on +Add Airtame
- Scroll down inside the pop-up until the Deployment Key option appears.
- Copy the deployment key: the deployment key is tied to a group. The devices who get this deployment key will be added to this group when the deployment is done
The Deployment Key option inside the Add Airtame pop-up
Pass the deployment key through the msi installer
When deploying the msi, insert the deployment key as a command-line argument, following the below logic.
Note: This argument can be passed along with the other arguments we provide for the Virtual Airtame for Windows.
Argument | Type | Sample value | Description |
EXTRA_APP_ARGS | String | "deploymentKey=%deploymentkey%" | Pass a deployment to automatically provide an Airtame Cloud token to the Virtual Airtames. |
For example:
msiexec /i Virtual-Airtame-x.1.msi EXTRA_APP_ARGS="deploymentKey=cf861cd0-5937-43f6-a088-7f5exxxxxxx"