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, Active Directory GroupA group is a collection of members and/or connections. Groups can be share recipients, thus making sharing simpler and more convenient. PolicyA policy is a configurable site-wide setting that dictates how Workplace will behave for your team. Software Installations (AD GPSI), Microsoft Intune, Microsoft System Center, or similar.

For information about installing silently via Datto RMM, please refer to Integrate with Datto RMM.

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 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 an Endpoint Management tool such as Datto RMM.

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:

/silent_install.sh “<DMG_NAME>” “APPLICATION_NAME (as created in application folder)>” <application_identifier> TEAM_KEY

So, for 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).