Windows CLI and PS Install Commands

This article provides examples for installing the AppGate windows client via the command line in the windows Command terminal and in PowerShell. Examples are shown for the full, multi-user, headless and always-on as well the process to uninstall.

Client Downloads: https://sdpdownloads.appgate.com (Appgate SDP Service.exe is installed by initial install when headless or always-on is set as an option)

Install

Full Client

Run CMD or PowerShell as Administrator and run commands from same directory or specify file path.

start "" /WAIT "AppGate-SDP-x.y.z-Installer.exe" /S /PROFILES=“appgate://ctrls.example.com/ClientProfileForFullClient=="

Start-Process "AppGate-SDP-x.y.x-Installer.exe" -ArgumentList ' /S /PROFILES="appgate://ctrls.example.com/ClientProfileForFullClient=="' -Wait 

Multi-User Client

Run CMD or PowerShell as Administrator and run commands from same directory or specify file path.

start "" /WAIT "AppGate-SDP-x.y.z-Installer.exe" /S /MULTIUSER /PROFILES=“appgate://ctrls.example.com/ClientProfileForFullClient=="

Start-Process "AppGate-SDP-x.y.x-Installer.exe" -ArgumentList ' /S /MULTIUSER /PROFILES=“appgate://ctrls.example.com/ClientProfileForFullClient=="' -Wait 

Headless Client

Install

Run CMD or PowerShell as Administrator and run commands from same directory or specify file path

start "" /WAIT "AppGate-SDP-x.y.z-Installer.exe" /S /HEADLESS

Start-Process "AppGate-SDP-x.y.z-Installer.exe" -ArgumentList ' /S /HEADLESS' -Wait

Configuration

Run CMD or PowerShell as Administrator and run commands from same directory or specify file path

start "" /WAIT “c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator set --profile “appgate://ctrls.example.com/ClientProfileForHeadlessService==" --username headless --password password

& "C:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe" configurator set --profile “appgate://ctrls.example.com/ClientProfileForHeadlessService==" --username headless --password password

Always-on

Install

Run CMD or PowerShell as Administrator and run commands from same directory or specify file path

start "" /WAIT "AppGate-SDP-x.y.z-Installer.exe" /S /ALWAYSON /PROFILES=“appgate://ctrls.example.com/ClientProfileForFullClient=="

Start-Process "AppGate-SDP-x.y.x-Installer.exe" -argumentlist ' /S /ALWAYSON /PROFILES=“appgate://ctrls.example.com/ClientProfileForFullClient=="' -wait 

Configuration

start “” /WAIT “c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator set --profile “appgate://ctrls.example.com/ClientProfileForAlwaysonService==" --username alwayson --password password

& “c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator set --profile “appgate://ctrls.example.com/ClientProfileForAlwaysonService==" --username alwayson --password password

Uninstall

With installer

Run CMD or PowerShell as Administrator and run commands from same directory or specify file path.

start "" /WAIT "AppGate-SDP-x.y.z-Installer.exe" /S /UNINSTALL

Start-Process "AppGate-SDP-x.y.x-Installer.exe" -argumentlist ' /S /UNINSTALL' -Wait

With Uninstaller

start "" /WAIT "%programfiles%\appgate sdp\uninstaller.exe" /S

Start-Process "$env:ProgramFiles\appgate sdp\uninstaller.exe" -ArgumentList ' /S' -Wait

Status and Troubleshooting

Headless and Always-on Commands

Show Configuration:

“c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator get -c

& "c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator get -c

Show Details:

“c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator get -d

& "c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator get -d

Show Service:

“c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator get -s

& "c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator get -s

Reset Service:

“c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator reset -s

& "c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator reset -s

Reset Configuration:

“c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator reset -c

& "c:\Program Files\Appgate SDP\Service\Appgate SDP Service.exe” configurator reset -c

• User accounts need to be configured in the IDP that is associate with the headless or always-on client profile before service will connect.

• Client profiles created and downloaded from Admin UI > Identity > Client Profiles

• It is recommended to have a separate client profile for headless and always on even if the same IDP is being used for the full client.

• More information can be found in the admin guide.