Client Connector
Interacting with Zscaler Client Connector Remotely
This feature is available only for Zscaler Client Connector version 4.4 and later for Windows and Zscaler Client Connector version 4.3 and later for macOS.
You can use a CLI to interact with Zscaler Client Connector remotely to view the status of services. You can also enable or disable the Zscaler Private Access (ZPA) service. This feature is useful if you must interact with services on behalf of users (for example, an outage requires you to disable ZPA for all users).
Enabling the CLI
- Windows
To enable the CLI for Windows devices:
- In the Zscaler Client Connector Portal, go to App Profiles. To learn more, see Configuring Zscaler Client Connector Profiles.
- Click Add Windows Policy.
- In the Command Line Interface Access section, enable the Command Line Interface.
(Optional) In the Disable Services section, enable Disable ZPA Password to require a password when disabling the ZPA service using the CLI.
If enabled, a Generate ZPA Disable Password option appears.
The ZPA service is the only service that can require a password. The Zscaler Internet Access (ZIA) and Zscaler Digital Experience (ZDX) services cannot require a password.
- macOS
To enable the CLI for macOS devices:
- In the Zscaler Client Connector Portal, go to App Profiles. To learn more, see Configuring Zscaler Client Connector Profiles.
- Click Add macOS Policy.
- In the Command Line Interface Access section, enable Command Line Interface.
(Optional) In the Disable Services section, enable Disable ZPA Password to require a password when disabling the ZPA service using the CLI.
If enabled, a Generate ZPA Disable Password option appears.
The ZPA service is the only service that can require a password. The Zscaler Internet Access (ZIA) and Zscaler Digital Experience (ZDX) services cannot require a password.
Using the CLI
- Windows
To use CLI for Windows devices:
- Start a command prompt as an administrator.
- Use one of the following file paths, depending on your Windows system version:
- For 64-bit:
C:\Program Files\Zscaler\ZSACli\ZSACli.exe
<command>
- For 32-bit:
C:\Program Files (x86)\Zscaler\ZSACli\ZSACli.exe
<command>
- For 64-bit:
Replace
<command>
with one of the following commands and pressEnter
.Command Result Notes enable -s zpa
Turn on ZPA. If you are enabling ZPA for a partner tenant, add
-u
<partner username>
afterzpa
.Can be run five or fewer times per minute.
disable -s zpa
Turn off ZPA. If you enabled Disable ZPA Password and generated a password in app profiles, add
-p
<disable password>
afterzpa
.Example:
ZSAcli.exe disable -s zpa -p
<disable password>
Can be run three or fewer times per minute.
status -s
<service>
Display the status in a JSON format of the entered service, or for all services if you enter all
.Possible values for
<service>
:zia
(indicates Zscaler Internet Access)zpa
(indicates Zscaler Private Access)zdx
(indicates Zscaler Digital Experience)deception
(indicates Zscaler Deception- zep (indicates Anti-Tampering)
all
(indicates all services)
help
Displays help information about the CLI arguments. N/A If a message displays indicating that the CLI is disabled from the policy, enable the Command Line Interface option in the app profile.
- macOS
- Start a command prompt as an administrator.
Use the following file path:
/Applications/Zscaler/Zscaler.app/Contents/PlugIns/zscli
Replace
<command>
with one of the following commands and pressEnter
.Command Result Notes enable -s zpa
Turn on ZPA. If you are enabling ZPA for a partner tenant, add
-u
<partner username>
afterzpa
.Can be run five or fewer times per minute.
disable -s zpa
Turn off ZPA. If you enabled Disable ZPA Password and generated a password in app profiles, add
-p
<disable password>
afterzpa
.Example:
zscli disable -s zpa -p
<disable password>
Can be run three or fewer times per minute.
status -s
<service>
Display the status in a JSON format of the entered service, or for all services if you enter all
.Possible values for
<service>
:zia
(indicates Zscaler Internet Access)zpa
(indicates Zscaler Private Access)zdx
(indicates Zscaler Digital Experience)zdp
(indicates Endpoint Data Loss Prevention)all
(indicates all services)
help
Displays help information about the CLI arguments. Possible examples for
help
:zscli -h
zscli enable -h
zscli disable -h
zscli status -h
If a message displays indicating that the CLI is disabled from the policy, enable the Command Line Interface option in the app profile.