ScreenConnect is a tool you can use to remote control your customers' assets to make remote support a breeze! With our integration, you can just click to have a session created with the details copied over from the ticket.
Table of Contents
Installation
Configuring ScreenConnect with Policies
Accessing ScreenConnect
Troubleshooting
Mac
Installation
- To get started, head to Admin > App Center > ScreenConnect app card.
- You will obtain your ScreenConnect URL and Instance ID in ConnectWise Control. In a new browser tab, login into your ScreenConnect account at https://cloud.screenconnect.com/#/account.
- If you don't already have an instance created, create one first.
- With the instance created, copy the Instance URL highlighted here:
- Note: The Instance ID shown in the ConnectWise portal is NOT the ID needed for this integration. This will be shown starting in step 7.
- In Syncro in the ScreenConnect URL field, paste the Instance URL. Make sure to include https:// in front of the URL.
- To get the Instance ID, you’ll need to access one of your endpoints that already has your ScreenConnect Client installed.
- On the endpoint, open the Task Manager.
- Click the Services tab.
- Scroll down to the ScreenConnect Client service.
- Copy down the Instance ID found in the parenthesis by the ScreenConnect Client name. (You may close the Task Manager after doing this.)
- In Syncro in the ScreenConnect Instance ID field, type the Instance ID.
- Click Save.
- Next, in ConnectWise Control click the Instance URL to launch the Host.
- Login.
Once you've launched the instance host, you'll be able to build the MSI installer to upload into Syncro.
Build an MSI Installer
- In ScreenConnect on the left-hand menu, click Access.
- Click the Build + button.
- Click the Type dropdown > Windows (.msi).
- Click DOWNLOAD.
- Click DONE when it finishes.
- IMPORTANT: Once it downloads, find the file (it should be called ConnectWiseControl.ClientSetup.msi).
- Rename the file to exactly screenconnect.msi before uploading it to Syncro.
- In Syncro, click Upload ScreenConnect MSI.
- Find the screenconnect.msi file (you renamed it to this in step 7 above, right?) and upload it.
- Once it finishes uploading, you'll see "All Set, we have your ScreenConnect MSI file."
That's it for authentication!
Configuring ScreenConnect with Policies
Now you will want to add the ScreenConnect integration to a Policy. Head to the Policies tab and select the Policy that will have ScreenConnect on it.
With ScreenConnect configured, there will be a new option to "BRING YOUR OWN SCREENCONNECT" to activate. Check the box and hit Save.
Once you activate this option, the system will begin to scan the Assets that have the Policy attached.
-If ScreenConnect is installed on the Asset with a ScreenConnect Instance ID that is different than the one you entered in the Settings step, then the system will install a new instance of ScreenConnect with the instance ID that was used in Syncro and upload the ScreenConnect unique GUID for the Asset.
-If ScreenConnect is not installed, we will install it using the ScreenConnect ID that was used during the Setup stage and upload the ScreenConnect unique GUID for the Asset.
*NOTE*: The sync can vary in time and of course depends if the Asset is online at the time. You will know if the Asset has synced if there is a ScreenConnect GUID in the Asset info.
*NOTE*: There is a ScreenConnect ID column you can turn on in the Device Settings button on the Device page.
Accessing ScreenConnect
Once everything is synced up, you can get to ScreenConnect by clicking the Device Quick Access or in the Device Details Screen using the Remote drop down.
Troubleshooting
- If you are getting an error stating "One or more errors occurred" or "Session group 'All Machines' does not exist" from ScreenConnect when you attempt to remote into the device from Syncro, please check that your main "Access" session group in ScreenConnect starts with "All Machines" and try again.
- You can either click the three dots by a name > Edit to rename one, or click + Create Session Group near the bottom.
- You can either click the three dots by a name > Edit to rename one, or click + Create Session Group near the bottom.
- If you use Syncro to remote into a machine, but you access a different computer in your ScreenConnect account, please make sure that you did not use the "End" button in ScreenConnect discussed here: https://docs.connectwise.com/ConnectWise_Control_Documentation/Get_started/Host_page/End_a_session
This will prevent Syncro from accessing the machine further, because ScreenConnect has permanently ended the session, and leaves the service installed on the machine, preventing Syncro from connecting or reinstalling ScreenConnect.
To resolve this issue, you will need to completely uninstall ScreenConnect from the machine, and clear the ScreenConnect GUID value from the asset's custom field so that Syncro can reinstall and repopulate the ScreenConnect GUID.
- If ScreenConnect installs on your assets, but the 'ScreenConnect GUID' asset field is blank and there is no option to connect via ScreenConnect, it is likely that the Instance ID that was entered in the ScreenConnect app card is incorrect.
You can quickly find the Instance ID by going to an asset that ScreenConnect was deployed to and looking for ScreenConnect in the 'Installed Apps' tab. The ID will be displayed between the parentheses after 'ScreenConnect Client':
Once you have that ID, head over to 'Admin > App Center > ScreenConnect' and update the Instance ID. As your assets sync with our servers, you should see the ScreenConnect GUID appear on the asset and an option to start a ScreenConnect remote session.
- If you do not have the option to install it on any policies and it is not installing on any new assets, make sure you have uploaded the screenconnect.msi as detailed in Build an MSI Installer above.
Mac
ScreenConnect managed installation is not officially supported on Macs at this current time. If this is not working for you, please install ScreenConnect outside of Syncro until further notice.