Silent installation

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”.

Command Result
/? 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_v6.0.1.34.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

Download the uninstall script (Workplace Desktop v8).

Download the uninstall script (Workplace v10.3 or later).