Workplace has the ability to silently install the Workplace app on a user’s machine via Endpoint Management tool such as Datto RMM, Kaseya VSA, Active Directory Group Policy Software Installations (AD GPSI), Microsoft Intune, Microsoft System Center, or similar.
NOTE For information about installing silently via Datto RMM, please refer to Integrate with Datto RMM. For information about installing silently via Kaseya VSA, please refer to Integrate with Kaseya VSA 10
Once the Workplace app is remotely installed, the user simply launches the application from their Program Files folder, enters their credentials, and configures the Workplace app. If you have deployed Workplace via the Deployment feature in Workplace Online, users will receive an email asking them to approve the addition of the device. Workplace will begin syncing to the device immediately.
IMPORTANT While we encourage you to use silent installation, we recommend that you allow Datto to maintain user versions through the auto-update mechanism. This will ensure that users always have an up-to-date version of our Workplace app. Please do not enable the Restrict Update Automation policy unless you have an exceptionally good reason.
Windows installation syntax
The Workplace for Windows EXE file can be downloaded via the Download link on the Workplace Login page.
The Workplace app MSI file, required for installation via AD group policies, can be downloaded from the Downloads page in Workplace Manager.
The following commands are supported by the Workplace EXE installation package. The commands must be preceded by the Workplace installer name, for instance “DattoWorkplaceSetup_v10.0.0.42.exe”.
|/?||Displays a list of all possible commands.|
|/install||Checks system prerequisites, installs required components (for instance, .NET Framework and Visual C++ Runtime library), and Workplace app.|
|TeamKey (parameter of the install command)||
Enters the team key (you will generate a team key for each team on the Configure deployment page) automatically during silent installation. It is written "TeamKey=XXXXXXXXXX", where XXetc. is the actual team key. The complete install command with the team key parameter might be:
EXAMPLE DattoWorkplaceSetup_v18.104.22.168.exe /install /quiet TeamKey=a12b3456-6789-1cd2-3
|/uninstall||Removes Workplace, its binaries, and unregisters Windows components (shell extensions, Microsoft Office Add-in and others). It will not uninstall prerequisite components which include .NET Framework, Visual C++ Runtime or other similar components.
When used in combination with /quiet or /passive, the configuration and data are retained.
|/quiet||Nothing is displayed to the user.|
|/passive||Shows minimal UI with no ability to interact, but progress is displayed.|
|/norestart||Suppresses any attempt to restart the computer.|
|/log <PATH><FILENAME>.txt||Allows you to specify the path and filename to which installation logs are saved. By default, the path is %TEMP% and the filename is “Datto Workplace Setup _<date-time>.log”.|
|/repair||Repairs Workplace app and prerequisite components.|
Errors are reported by means of an exit code and detailed information can be found in the log file. Successful installation returns exit code 0.
Mac Installation Syntax
Workplace can be silently installed on a user’s machine via endpoint management tools such as Datto RMM and Kaseya VSA.
NOTE You can download the installer from the Download link on the Workplace Login page.
The command syntax for installing the Mac Agent remotely is:
For Version 10
/silent_install.sh “<DMG_NAME>” “APPLICATION_NAME (as created in application folder)>” com.datto.dwc TEAM_KEY
EXAMPLE ./silent_install.sh “DattoWorkplaceDesktop.dmg” “Datto Workplace Desktop” com.datto.dwc 123abc456
For Version 8
/silent_install.sh “<DMG_NAME>” “APPLICATION_NAME (as created in application folder)>” com.datto.dwp TEAM_KEY
EXAMPLE ./silent_install.sh “DattoWorkplaceDesktop.dmg” “Datto Workplace Desktop” com.datto.dwp 123abc456
IMPORTANT The script must be run under root!
The agent can be upgraded by using the same “silent_install.sh” shell script. In this scenario, the team key is optional. Download the install script.
To uninstall using a shell script, the command should be used as follows (assuming the default application name hasn’t been changed).
./silent_uninstall.sh com.datto.dwp “Datto Workplace Desktop” dwpPreferencePane 1