Workplace"Workplace" describes the Autotask Workplace service in its entirety. has the ability to silently install Workplace DesktopAlso known as the Workplace Desktop app, and in the context of this documentation, simply "the app," Workplace Desktop is the software installed on a computer that is responsible for synchronizing data between the local drive and the cloud. 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 Autotask 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 Workplace Desktop is remotely installed, the user simply launches the application from their Program Files folder, enters their credentials, and configures Workplace Desktop. If you have deployed Workplace Desktop via the Deployment feature in Workplace OnlineWorkplace Online is the web portal that users within a team can use to access their data and administer their team., users will receive an email asking them to approve the addition of the device. Workplace Desktop will begin syncing immediately.
Windows Installation Syntax
Workplace Desktop for Windows EXE file can be downloaded via the Download link on the Workplace Login page.
The following commands are supported by the Workplace Desktop EXE installation package. The commands must be preceded by Workplace Desktop installer name, for instance “AutotaskWorkplaceSetup_v18.104.22.168.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 Desktop.|
|TeamKey (parameter of the install command)||
Workplace Desktop 6.0 or later is required for use of a team key for installation.
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:
AutotaskWorkplaceSetup_v22.214.171.124.exe /install /quiet TeamKey=a12b3456-6789-1cd2-3
|/uninstall||Removes Workplace Desktop , 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 “Autotask Workplace Setup _<date-time>.log”.|
|/repair||Repairs Workplace Desktopand 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 Desktop can be silently installed on a user’s machine via an Endpoint Management tool such as Autotask Endpoint Management.
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)>” TEAM_KEY
So, for example:
./silent_install.sh “<DMG_NAME>” “APPLICATION_NAME (as created in application folder)>” TEAM_KEY
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.
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.autotask.awp" "Autotask Workplace” “awpPreferencePane”
|Forward this topic to others|