DESKTOP > Install or Uninstall Workplace Desktop > Silent Installation

Silent Installation

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 Autotask Endpoint Management (AEM), 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 AEM, please refer to Integrate with Autotask Endpoint Management

Silent installation will only work for new installations or upgrading Workplace Desktop already running version 5.2 or later.

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_v6.0.1.34.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 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_v6.0.1.34.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