- 10 Apr 2024
- 2 Minutes to read
- Print
- DarkLight
- PDF
Deploying a Pre-installed Client
- Updated on 10 Apr 2024
- 2 Minutes to read
- Print
- DarkLight
- PDF
If you are supporting employees, you might decide to deploy the Windows MSI or MacOS PKG files to your employees’ machines.
Doing so will enable them to open the ScreenMeet desktop application to enter the remote support code rather than navigate to a URL to download the on-demand client.
If you are updating the ScreenMeet client from an older version below 2.61.6, you will need to uninstall the previous version before you install the new client.
Windows Client
The Windows MSI can be downloaded here.
When deploying the ScreenMeet.msi you can pass certain configuration options in a command line for faster deployment.
Here's a list of the configuration options you can specify and an example command.
Command Line Reference
Common settings
APPLICATIONFOLDER - Path to the folder where the ScreenMeet application will be installed. The default value is “[Path to ProgramFilesx86]\ScreenMeet”.
PROGRAMMENUSHORTCUT - Add a shortcut to the Program Menu. PROGRAMMENUSHORTCUT="1" will add a shortcut. PROGRAMMENUSHORTCUT="" disables the shortcut. Default value is “1“.
DESKTOPSHORTCUT - Add a shortcut to the Desktop. DESKTOPSHORTCUT="1" adds a desktop shortcut. DESKTOPSHORTCUT="" disables the desktop shortcut. The default value is “1”.
AUTOCHECKUPDATES - Automatically check for updates [“False“, “True“]. Default “True“.
AUTOUPGRADE - Automatically download and install client updates [“False“, “True“]. Default “True“. Can be set to “True“ only if AUTOCHECKUPDATES is also “True“.
ADDLOCAL - Provide a comma-separated list of features to be installed: [“SupportFeature“, “SupportFeature,BeamFeature“]. Default “SupportFeature,BeamFeature“. SupportFeature allows the application to be used for attended remote support sessions. The end user can open the application and enter the PIN created by the Agent.
ORGRESTRICT - Restricts usage for specific organizations listed in ORGRESTRICTLIST. [“0“, “1”]. Default “0”.
ORGRESTRICTLIST - List of comma-separated organization IDs (e.g., “82,154“) which are allowed to use the client. The ScreenMeet Organization IDs can be obtained from https://console.screenmeet.com under Organization.
Example Command
msiexec /i ScreenMeet.msi /quiet APPLICATIONFOLDER="C:\Program Files (x86)\ScreenMeetApp" ADDLOCAL=”SupportFeature” DESKTOPSHORTCUT=”1”
This example will perform a silent install of the ScreenMeet application to the folder C:\Program Files (x86)\ScreenMeetApp, enable the Remote Support application, and create a desktop shortcut.
NOTE:
When Installing on Windows, you will be given the option to install the Beam service. This service is required by the Beam application for unattended remote control. If you do not want to install the Beam service, you can select to have the feature unavailable, as shown below.
MacOS Client
The MacOS Client PKG can be downloaded here. Unlike the Windows Installer, the MacOS client is configured post-installation by executing the Application package with specific parameters.
Note
Unlike the Windows Installer where configuration is performed during installation, the MacOS client is configured post-installation by executing the Application package with specific parameters.
Command-line Reference
After installation of the PKG, the client can be configured from the command-line:
open -n -a "/Applications/ScreenMeetSupport.app" --args <argument>=<value>
Supported Session Parameters
Argument | Value | Example Value | Description |
---|---|---|---|
| <session pin> |
| If specified will attempt to connect to this session upon application start. |
| <true|false> |
| Skips the consent screen from screen sharing. |
| <1-4> |
| Controls the level of logging output (if file logging is enabled) |
| <url> |
| If using a proxy, the proxy URL. |
| <username> |
| The proxy username. |
| <password> |
| The proxy password. |
Supported Configuration Parameters
Argument | Value | Example Value | Description |
---|---|---|---|
| Returns the stored value for the allowed organization IDs. Supported in 2.95 and later.
| ||
| <comma-separated list of organization IDs> |
| A comma-separated list of allowed organization IDs for this client. Setting this with an empty value will DISABLE the restriction feature. Supported in 2.95 and later. |