Skip to main content

Cisco Secure Client Parameter

Summary

This company-level custom field stores the parameter to install the Cisco Secure Client package using the SWM - Software Install - Task - Cisco Secure Client Package Installation (Windows) task.

Parameters must be set in a manner consistent with the agnostic script SWM - Software Install - Agnostic - Install-CiscoSecureClient.

Dependencies

SWM - Software Install - Task - Cisco Secure Client Package Installation (Windows)

Details

Field NameType of FieldDescription
Cisco Secure Client ParameterCompanyStores the parameter to install the Cisco Secure Client package using the Cisco Secure Client Package Installation (Windows) task. How to use parameters: Install-CiscoSecureClient

Screenshot

Screenshot

How to Use the Custom Field

  • Navigate to Client Management > Company Management
    Step 1

  • Select the desired client from the Company List
    Step 2

  • Go to the Custom Fields section in the Company Details
    Step 3
    Step 3.2

  • Click the edit button for the Cisco Secure Client Parameter Custom Field
    Step 4

  • This pop-up will appear on the screen
    Step 5

  • Write the required parameter in the Value text box and click the Confirm button to save.
    Step 6

Sample Values

Value:

-DownloadURL 'https://downloadpath/CiscoSecureClient.zip' -core -Umbrella -UserID 1234567 -Fingerprint oash098ashuiue -OrgId 394058

Outcome:
The task will install the Core VPN (keeping it hidden from the end-user) and Umbrella Modules. Because Umbrella is being installed, the UserID, Fingerprint, and OrgId are required. Also, it's mandatory to install the Core VPN module to install the Umbrella module.
Outcome 1

Value:

-DownloadURL 'https://downloadpath/CiscoSecureClient.zip' -Dart -Nvm -Posture

Outcome:
The task will install the Diagnostics and Reporting, VPN Posture (HostScan), and Network Visibility Modules.
Outcome 2

Value:

-DownloadURL 'https://downloadpath/CiscoSecureClient.zip' -core -Umbrella -Dart -Nvm -UserID 1234567 -Fingerprint oash098ashuiue -OrgId 394058

Outcome:
The task will install the Core VPN module (keeping it hidden from the end-user), Umbrella, Diagnostics and Reporting, and Network Visibility Modules. Because Umbrella is being installed, the UserID, Fingerprint, and OrgId are required.
Outcome 3

Value:

-DownloadURL 'https://downloadpath/CiscoSecureClient.zip' -core -ShowVPN -Umbrella -Dart -Nvm -UserID 1234567 -Fingerprint oash098ashuiue -OrgId 394058

Outcome:
The task will install the Core VPN module (visible to the end-user in the system tray icon), Umbrella, Diagnostics and Reporting, and Network Visibility Modules. Because Umbrella is being installed, the UserID, Fingerprint, and OrgId are required.
Outcome 4

Value:

-DownloadURL 'https://downloadpath/CiscoSecureClient.zip' -All -UserID 1234567 -Fingerprint oash098ashuiue -OrgId 394058

Outcome:
The task will install all modules, including Umbrella, which require the UserID, Fingerprint, and OrgId to be provided. Programmatically creates a JSON authentication file for access by the Umbrella module.
Outcome 5

Note:
The DownloadURL, Fingerprint, OrgID, and UserID provided above are for illustrative purposes only. When executing the script, it is essential to set the correct values for these parameters according to the specific requirements.

Agnostic Script Parameters

Different installation parameters can be created by using these parameters from the agnostic script.

ParameterRequiredDefaultTypeParameter Set MembersDescription
AllFalseSwitchAllInstalls all modules. Requires dynamic parameters.
UserIDTrueStringDynamic: All, UmbrellaCisco Client ID: Required for Umbrella and all switches.
FingerPrintTrueStringDynamic: All, UmbrellaCisco Fingerprint: Required for Umbrella and all switches.
orgIDTrueStringDynamic: All, UmbrellaCisco Org ID: Required for Umbrella and all switches.
coreFalseSwitchCustomInstalls the Core VPN module.
showVPNFalseSwitchDynamic: All, coreDisplays the Core VPN module in the system tray icon.
SBLFalseSwitchCustomInstalls the Start Before Login module.
DARTFalseSwitchCustomInstalls the Diagnostic and Reporting Tool module.
NVMFalseStringCustomInstalls the Network Visibility module.
NAMFalseStringCustomInstalls the Network Access Manager module.
PostureFalseStringCustomInstalls the VPN Posture (HostScan) module.
ISEPostureFalseStringCustomInstalls the ISE Posture module.
UmbrellaFalseStringCustomInstalls the Umbrella module. Requires dynamic parameters.
DownloadURLTrueStringCore, All, Custom, UmbrellaURL to download the CiscoSecureClient.zip file.