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