This page contains instructions for deploying and managing Desktop Connector using Configuration Manager (formerly called SCCM). To learn more about the Microsoft Configuration Manager, see the help topic Using Microsoft Configuration Manager to deploy and manage Autodesk products.
These instructions are intended for IT specialists with an understanding of Configuration Manager. For more information on deploying Autodesk software using Configuration Manager, refer to this Using Microsoft Configuration Manager to deploy and manage Autodesk products.
Always use the .EXE (ODIS installer) for installations and upgrades. This ensures that all necessary dependencies (like IDSDK/ADSSO, .Net runtime, C++ runtimes, etc.) are installed along with the software.
If you choose to use the .MSI file for installation, be aware that it does not bundle any dependencies - you are responsible for installing these separately.
Avoid mixing the installation methods (MSI/EXE). Use the same method for both the initial installation and any subsequent upgrades. This can help prevent dual entries in the Programs list or other potential issues.
Refer to Installing Desktop Connector using MSI vs. EXE within this document for more detailed information.
This PowerShell script demonstrates how Desktop Connector can be deployed as an IT administrator.
It is intended as a reference for IT administrators using Configuration Manager (formerly SCCM) deployments.
Do not run this script directly without first reading through the contents and making necessary changes.
This script supports install, upgrade, and uninstall operations.
For install workflows, this script should be run in the same directory as the Setup.exe executable.
Download the current version of the script here: Example Deployment Script.
Version | Date | Changes |
---|---|---|
3 | 3/24/2023 | Improved documentation in the scripts comments and console outputs |
2 | 3/21/2023 | Correctly stop DC before attempting install operations |
1 | 3/7/2023 | Initial version of sample script |
Download the latest version of Desktop Connector from the Latest Release Notes Page..
Open the downloaded package and allow it to extract.
The installer will now be available for use in deployments in a location similar to the one shown.
C:\Autodesk\Autodesk_Desktop_Connector_16_7_1_2164_Win_64bit
When installing for the first time, the installer prepared in the preceding section can be run directly.
When running the installer in a deployment, verify that you are providing the appropriate flags to run silently.
This is the first option for uninstalling Desktop Connector. It requires the original Setup.exe to still be available
Shut down all running Desktop Connector processes.
Execute the original Setup.exe
Setup.exe --silent -i uninstall
For more information, refer to Modify a deployment from Autodesk Account for additional information.
The second option for uninstalling Desktop Connector. It does not require any of the original install files. This is the method used in the example deployment script as shown:
Shut down all running Desktop Connector processes.
Obtain the uninstall string for the installed version of desktop connector.
HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\
Execute the uninstall string
After uninstalling Desktop Connector with Configuration Manager or other administrative means, users may be left with an unusable "ghost" drive like in the following picture:
If you are planning on reinstalling Desktop Connector, no further action is required. Desktop Connector will automatically clean up any disconnected drives when it starts up.
If you need to remove this "ghost" drive, have the affected user:
Download the ZIP file from this link: DC Reset Utility.
ResetDesktopConnector.exe
file included.For further information on the Reset Utility, refer to this video Reset Desktop Connector Automated Utility.
If you are running any version of the 15.x family of Desktop Connector and would like to upgrade, you must uninstall that version before upgrading to version 16.x. A clean uninstall must be performed to upgrade efficiently.
To uninstall Desktop Connector follow these steps:
Shut down all running Desktop Connector processes.
Uninstall Desktop Connector v15.x (or earlier).
After the uninstall confirms that local workspaces for all users have been deleted. If not, delete the local workspaces.
Local workspaces are any folders that are on your local machine. Delete these folders if found (to quickly navigate to your user profile folder type %userprofile%
in File Explorer address bar):
C:\Users\<USERNAME>\AppData\Local\Autodesk\Desktop Connector
C:\Users\<USERNAME>\AppData\Local\Autodesk\Web Services\DesktopConnector
C:\Program Files\Autodesk\Desktop Connector
C:\ProgramData\Autodesk\Desktop Connector
Install the v16.x version using the same steps described in the First-Time Installation section.
You may have to perform a reboot for Desktop Connector to become available in your system tray. Upon installation you can select your projects to be added to your local drive.
Shut down all running Desktop Connector processes.
Install the newer version using the same steps described in the First-Time Installation section.
Any older v16.x versions of Desktop Connector will be removed during the upgrade and no user action is required.
A MSI (Microsoft Installer) file and an EXE (executable) file are both types of installation files.
The main difference between them lies in their customization and deployment capabilities. MSI files are database files, used by Windows Installer, that store installation settings for software applications. They allow for more customization and are used for network-wide software deployment.
On the other hand, EXE files are standalone executable files that initiate an installer for a software program. They are simpler and less customizable.
The recommended method for installing the Desktop Connector is by running the downloaded .exe file located in the Downloads folder for the current user. When you download the desktop connector .exe it will be found at the following location:
C:\Users\<username>\Downloads
You will have to run the DesktopConnector-x64.exe
and allow it to self-extract to the default location: C:\Autodesk
. By allowing to self-extract you may find he CDX.msi at the following location on your hard drive:
Can I use the .msi file for installation?
Yes, you can use the .msi file for installation, but it does not bundle any dependencies. You will need to install these separately.
What happens if I use the .exe for installation and the .msi for upgrade (or vice versa)?
Using different methods for installation and upgrade might result in dual entries in the Programs list. It's best to use the same method for both.
What are the dependencies that I need to install if I choose the .msi file?
The dependencies include but are not limited to IDSDK/ADSSO, .Net runtime, and C++ runtimes.
Where can I find information about changes in dependencies if I decide to handle them myself?
Remember, these practices and FAQs are based on feedback and customer testing and might not cover all possible scenarios or questions. For the most accurate and comprehensive information, always refer to the official Autodesk support and documentation.
Related Concepts: