Uninstalling the Netskope Client
Uninstalling the Netskope Client
This section describes various options to uninstall the Client from end-user devices.
Uninstall Client in macOS
The following options list the steps to uninstall Netskope Client in your macOS device:
Option 1
- Go to Applications and click the Remove Netskope Client icon.
- Enter your credentials to proceed with the uninstallation of the client.
Option 2
Create a shell script (for example, uninstall.sh) using the following command and execute it on the user’s device to uninstall the Client.
#!bin/bash /Applications/Remove\ Netskope\ Client.app/Contents/MacOS/Remove\ Netskope\ Client uninstall_me exit
To uninstall using a password, use the following command:
#!/bin/bash
/Applications/Remove\ Netskope\ Client.app/Contents/MacOS/Remove\ Netskope\ Client uninstall_me <password in plain text> exit
Netskope
and Client
in this script.Option 3
The following section describes the instructions to uninstall Netskope Client using various MDMs.
Use the jamfuninstall_v2.sh
script available for download as part of JAMF scripts in the Downloads section of the Support portal. When using this script for uninstalling, enter your password as the fourth parameter in the script in the JAMF policy using the set command below:
set -- 0 0 0 <yourUninstallPassword>
– Setting the System Extension to Removable results in the extension unloading and the Netskope client disables as a result. To ensure proper execution, you must configure your MDM to make the System Extension Removable and then run the uninstall script.
– It is recommended that you create a separate configuration profile and script for the uninstallation for specific machines or users as required. Changing the existing configuration profile for the system extension will result in clients disabling and users receiving requests for manual approval.
Jamf
This section describes the steps to uninstall Netskope Client in macOS devices using Jamf.
Configuration Profile and Policy
Perform the following instructions to mark the system extension as removable:
-
In JAMF, go to Computers > Configuration Profiles > New.
-
Provide a Name for the Configuration Profile.
-
Select System Extensions > Configure.
-
Select Allow users to approve system extensions.
-
Under Allowed Team IDs and System Extensions, select System Extension Types as Removable System Extensions.
-
Add Network Extension Team ID: 24W52P9M7W
-
Click Add to include the following System Extension:
com.netskope.client.Netskope-Client.NetskopeClientMacAppProxy
-
Click Save under Removable System Extensions.
-
Click Save in the bottom right to save the Configuration Profile.
Once the Configuration Profile is configured, you must upload and configure the uninstall script in a Policy. Refer to Scripts for instructions to add a script. After you upload the script:
-
Go to Computers > Policies > New.
-
Give the Policy a name.
-
Select Login for the trigger and the frequency as Once per computer. You can optionally configure a different trigger if you’d like the script to run sooner or at a different interval.
-
Click Scripts > Configure.
-
Click Add on the uninstall script you uploaded.
-
Click Save.
You can now assign the Configuration Profile and Policy to users and computers in JAMF. It is recommended to use a Smart Group or ensure you remove users and computers from the Configuration Profile and Policy that are configured to install the client.
Intune
This section describes the steps to uninstall Netskope Client in macOS devices using Intune.
Create Configuration Profile
Perform the following instructions to mark the system extension as removable:
-
In Intune, go to Devices > macOS > Configuration Profiles > Create > New Policy.
-
Select macOS under Platform and Settings catalog under Profile Type.
-
Click Create.
-
Under Basics, provide a name for the profile.
-
Click Next.
-
Under Configuration Settings, click +Add settings.
-
In the Settings Picker window, select System Configuration > System Extensions.
-
Select the checkbox for Removable System Extensions.
-
Go to Configuration Settings on the left-pane and click +Edit Instance.
-
Enter the following:
-
Removable System Extensions name: com.netskope.client.Netskope-Client.NetskopeClientMacAppProxy
-
Team Identifier: 24W52P9M7W
-
-
Click Save.
-
Click Next to continue.
-
Provide Scope tags(optional).
-
Click Next to continue.
-
In Assignment, Add user or device assignments to uninstall the Netskope client.
-
Click Next to continue.
-
In Review+Create, you can review the policy configurations.
-
Click Create.
Run Uninstall Script
Once the Removable System Extension policy is configured, you must upload and configure the uninstall script. Refer to Shell Scripts for instructions to add a script. Intune does not support passing parameters to the script and hence you must add a set command to the script.
Perform the following instructions to run the uninstall script:
-
In Intune, go to Devices > macOS > Shell scripts.
-
Click +Add.
-
In Basics, enter a Name and Description.
-
Click Next.
-
In Script Settings, select to upload the uninstall script from your local storage in your computer. Make the following changes:
-
Run script as signed-in user – No
-
Hide script notifications on devices – Not configured
-
Script frequency – Not configured
-
Max number of times to retry if script fails – Not configured
Selecting Not Configured for all other parameters implies that the script runs only once.
Includeset -- 0 0 0 <yourUninstallPassword>
in the script to unsintall using password parameter.
-
-
Click Next.
-
Assign proper groups based on user or Devices by clicking Add groups and checking the box next to the appropriate groups.
-
Click Select.
-
Click Next to continue.
-
Click Add.
-
Kandji
Kandji does not support marking system extensions as removable. The steps provided for the Netskope install allow for any extension type from the Netskope team identifier.
Perform the following instructions to run the uninstall script:
-
In Kandji, go to Library.
-
Click +Add new.
-
Click Custom Scripts > Add & Configure.
-
Select the Blueprint you want to uninstall clients.
-
In ExecutionFrequency, select the option: Run once per device.
-
Enter the following script in the Audit Script text box:
#!/bin/bash #script for installing NSAgent on OSX machines #will check to see if Netskope is Installed function Test_NSClient(){ xz=$(/usr/bin/mdfind kMDItemFSName == Netskope Client.app -onlyin /Library/Application\ Support/) if [ -e "$xz" ]; then echo "$xz found netskope client is installed" exit 1 else echo "client does not exist" exit 0 fi } Test_NSClient #end script
-
Click +Add Remediation Script.
-
Paste the contents of the uninstall script you configured with the set command in the Remediation Script field.
-
Click Save.
Workspace One
This section describes the steps to uninstall Netskope Client for macOS devices using Intune.
Add Removable System Extension
Workspace One supports Removable System Extensions and smart groups with exclusions. Perform the following instructions to mark the system extension as removable:
-
Go to Resources > Profiles & Baselines > Profiles.
-
Click Add.
-
Click Add Profile from the Add dropdown options.
-
Select Apple macOS from the platform list.
-
Select Device Profile in Select Context.
-
Provide a name for the profile.
-
Start typing ‘System’ in the search text box of the configuration profile.
-
Expand System Extensions option and click Add.
-
Configure Removable System Extensions as follows:
-
Click Next.
-
Assign the profile to a Smart Group and necessary exclusions. This structure will depend on your environment.
-
Click SAVE & PUBLISH.
Run Uninstall Script
Once the Removable System Extension policy is configured, you must upload and configure the uninstall script. Follow the steps below to use the Scripts functionality of WorkSpace One. WorkSpace One also supports Files/Actions which allows for more granular scheduling based on specific triggers such as Logon or recurring checking.
-
Go to Resources > Scripts.
-
Click ADD > macOS.
-
In General, provide a Name for the uninstall script.
-
Click NEXT.
-
Click UPLOAD and select the file you have configured with the uninstall password.
-
Click NEXT.
-
Click SAVE.
-
Select the script that you previously uploaded and click ASSIGN.
-
Click NEW ASSIGNMENT.
-
Enter a name for the Assignment.
-
Select a SmartGroup for uninstall based on the devices or users that need the client uninstalled.
-
Click NEXT.
-
Select the deployment trigger. You can select Run Once Immediately if you want the script to push immediately.
-
Click ADD.
-
Uninstall Client in Windows
Option 1
Use the Add or Remove Programs option in the Windows control panel to uninstall the Client.
Option 2
Microsoft Endpoint Configuration Manager
@echo off
REM
REM This batch file is used to uninstall Password protected Netskope Client from SCCM
REM
SetLocal
for /f "tokens=2 delims==" %%f in ('wmic product where "Name like 'Netskope Client'" get IdentifyingNumber /value ^| find "="') do set "productCode=%%f"
IF DEFINED productCode (
msiexec /uninstall %productCode% PASSWORD="<password in plain text within quotes>" /qn /l*v %PUBLIC%nscuninstall.log
) ELSE (
REM Did not find product code for Netskope Client
)
EndLocal
Microsoft Group Policy Object(GPO)
Uninstalling can be done through GPO using a batch script similar to installation. The uninstallation script is:
wmic product where name="Netskope Client" call uninstall
Uninstall Client in Linux
Use the command sudo /opt/netskope/stagent/uninstall.sh
to uninstall Netskope Client in Linux.