Skip to main content

Forwarding Profile Source Application

Forwarding profile source applications define the lists of applications used as source-application match criteria by GlobalProtect forwarding profiles in Strata Cloud Manager. The scm CLI provides commands to create, update, delete, show, backup, and load source applications.

Overview

The forwarding-profile-source-application commands allow you to:

  • Create source application lists for forwarding profile rules
  • Update existing source application configurations
  • Delete source applications that are no longer needed
  • Bulk import source applications from YAML files
  • Export source applications for backup or migration
note

Forwarding profile source applications live exclusively in the Mobile Users folder. Snippet and device locations are not supported.

Set Forwarding Profile Source Application

Create or update a forwarding profile source application.

Syntax

scm set mobile-agent forwarding-profile-source-application NAME [OPTIONS]

Arguments

ArgumentDescriptionRequired
NAMEName of the source applicationYes

Options

OptionDescriptionRequired
--folder TEXTFolder location (must be Mobile Users)Yes
--application TEXTApplication name (repeatable)Yes
--description TEXTDescriptionNo

Examples

$ scm set mobile-agent forwarding-profile-source-application "office-apps" \
--folder "Mobile Users" \
--application slack \
--application zoom \
--description "Collaboration applications"
Created forwarding profile source application: office-apps in folder Mobile Users

Show Forwarding Profile Source Application

Display forwarding profile source applications.

Syntax

scm show mobile-agent forwarding-profile-source-application [NAME] [OPTIONS]

Arguments

ArgumentDescriptionRequired
NAMEName of the source application to show; omit to list allNo

Options

OptionDescriptionRequired
--folder TEXTFolder location (must be Mobile Users)Yes
--output, -o [table|json|yaml]Output format (default: table)No
--max-results INTEGERMaximum number of results to displayNo

Examples

# List all source applications in the folder
$ scm show mobile-agent forwarding-profile-source-application --folder "Mobile Users"

# Show a specific source application by name
$ scm show mobile-agent forwarding-profile-source-application "office-apps" --folder "Mobile Users"

Delete Forwarding Profile Source Application

Remove a forwarding profile source application.

Syntax

scm delete mobile-agent forwarding-profile-source-application NAME [OPTIONS]

Arguments

ArgumentDescriptionRequired
NAMEName of the source applicationYes

Options

OptionDescriptionRequired
--folder TEXTFolder location (must be Mobile Users)Yes
--forceSkip confirmation promptNo

Examples

$ scm delete mobile-agent forwarding-profile-source-application "office-apps" --folder "Mobile Users" --force
Deleted forwarding profile source application: office-apps from folder Mobile Users

Backup Forwarding Profile Source Application

Export all forwarding profile source applications from a folder to a YAML file.

Syntax

scm backup mobile-agent forwarding-profile-source-application [OPTIONS]

Options

OptionDescriptionRequired
--folder TEXTFolder to backup from (defaults to Mobile Users)No
--file PATHOutput file path (defaults to forwarding-profile-source-application-{location}.yaml)No

Examples

$ scm backup mobile-agent forwarding-profile-source-application --folder "Mobile Users"
Successfully backed up 2 forwarding profile source applications to forwarding-profile-source-application-mobile-users.yaml

Load Forwarding Profile Source Application

Bulk import forwarding profile source applications from a YAML file.

Syntax

scm load mobile-agent forwarding-profile-source-application [OPTIONS]

Options

OptionDescriptionRequired
--file PATHYAML file to load fromYes
--dry-runSimulate execution without applying changesNo
--folder TEXTOverride folder location for all objectsNo

YAML Schema

forwarding_profile_source_applications:
- name: office-apps
folder: "Mobile Users"
description: Collaboration applications
applications:
- slack
- zoom
- name: dev-apps
folder: "Mobile Users"
applications:
- github

Examples

# Preview without applying
$ scm load mobile-agent forwarding-profile-source-application --file source_applications.yml --dry-run

# Apply the configurations
$ scm load mobile-agent forwarding-profile-source-application --file source_applications.yml
Created forwarding profile source application: office-apps
Created forwarding profile source application: dev-apps

Summary: 2 created, 0 updated, 0 unchanged