Experience Center
Deploying Zscaler Client Connector with Active Directory for Windows
This guide is for admins only. If you are an end-user, contact your organization’s administrator for deployment-related details.
This article provides instructions for deploying Zscaler Client Connector in an Active Directory (AD) environment. It also provides details on how to complete a silent installation on users' devices.
To deploy Zscaler Client Connector in an AD environment:
- 1. Prepare your AD environment.
- Log in to the AD environment (Domain Controller) as an admin user.
- Ensure that you have a well-defined organizational unit (OU) in the AD where you want to deploy the app. If you do not have an appropriate OU, create one by going to Server Manager > Active Directory Domain Services > [domain name] > New > Organizational Unit.
See image.
Alternatively, you can also apply Group Policy (GPO) to a group. If you do not have an appropriate group, create one by going to Server Manager > Active Directory Domain Services > [domain name] > New > Group.
- Ensure that the newly created OU has all the users and computer systems on which you want to deploy Zscaler Client Connector.
See image.
- 2. Create a network share.
- 3. Create a Group Policy (GPO) for Zscaler Client Connector installation.
You must create a new GPO policy for your OU in order to install Zscaler Client Connector.
- Go to Run and enter gpmc.msc to open the Group Policy Management editor.
- Select your OU, then right-click and select Create a GPO in this domain, and Link it here.
See image. - Under Security Filtering, specify the users, groups, and computers to which the policy must apply.
- 4. Install Zscaler Client Connector on the OU's Windows systems.
You must now edit the GPO policy for the OU in order to install Zscaler Client Connector on the OU's Windows systems. You can use either the MSI or EXE file, but Zscaler recommends using the MSI file because it integrates well with GPO.
- Deploying the MSI file to install Zscaler Client Connector
These steps provide details on how to complete a silent installation of the app on users' devices using an MSI file.
If you want to customize the MSI file and add install options (for example, you want to require users to enroll with Zscaler Client Connector before accessing the Internet), you must create an MST file before completing the steps below. To learn more, see Customizing Zscaler Client Connector with Install Options (MSI).
- Right-click on the GPO Policy you created and select Edit.
- Go to User Configuration > Policies > Software Settings > Software installation.
- Right-click and select New > Package.
- Double-click the MSI Windows Installer Package.
- In the Deploy Software window, select Advanced for the deployment method.
- Click OK.
See image. - To install the app on in silent mode, do the following, in Zscaler Properties window, click the Deployment tab. Do the following:
- For Deployment type, select Assigned.
- For Deployment options, select Install this application at logon.
- For Installation user interface option, select Basic.
- Do one of the following:
- If you did not create an MST, click OK.
- If you created an MST:
- Go to the Modifications tab.
- Click Add....
- Select the MST file.
- Click OK.
Zscaler Client Connector is automatically deployed the next time users' log into to their computers.
Close - Deploying the EXE file to install Zscaler Client Connector
Below are instructions for defining a system start-up script to install Zscaler Client Connector on user devices with an EXE file.
- Select the GPO Policy and go to Computer Configuration > Policies > Windows Settings > Scripts > Startup.
- Double-click to open.
- Select Add to open a new wizard.
- In the Script Name field, specify the absolute path to the EXE file. For example, \\SERVER\\share\Zscaler-windows-1.1.0.000213-installer.exe.
- In the Script Parameters field, do one of the following:
- If you want to deploy the EXE file without any install options, leave the Script Parameters field blank.
- If you want to customize the EXE file and include install options (e.g., you want to require users to enroll with the app before they can access the Internet), add the options to the Script Parameters field as described in Running the EXE File with Command-Line Options.
- Click OK.
- Click Apply, then run the following command:
gpupdate.exe /force
- Remotely reboot the OU computers on which you want to install the app using the following command:
shutdown.exe –r –m \\<Remote Computer Name> –t 0
Close
- Deploying the MSI file to install Zscaler Client Connector
- 5. Verify the installation of Zscaler Client Connector on the OU's Windows systems.
- Once the OU system is rebooted, log in to a remote system.
- Verify that the app is running in the desktop foreground and that the desktop shortcut is installed.
Close