Skip to 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 [OPTIONS]

Options

Option Description Required
--folder TEXT Folder location (must be Mobile Users) Yes
--name TEXT Name of the source application Yes
--application TEXT Application name (repeatable) Yes
--description TEXT Description No

Examples

$ scm set mobile-agent forwarding-profile-source-application \
    --folder "Mobile Users" \
    --name "office-apps" \
    --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 [OPTIONS]

Options

Option Description Required
--folder TEXT Folder location (must be Mobile Users) Yes
--name TEXT Name of the source application to show No

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 --folder "Mobile Users" --name "office-apps"

Delete Forwarding Profile Source Application

Remove a forwarding profile source application.

Syntax

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

Options

Option Description Required
--folder TEXT Folder location (must be Mobile Users) Yes
--name TEXT Name of the source application Yes
--force Skip confirmation prompt No

Examples

$ scm delete mobile-agent forwarding-profile-source-application --folder "Mobile Users" --name "office-apps" --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

Option Description Required
--folder TEXT Folder to backup from (defaults to Mobile Users) No
--file PATH Output 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

Option Description Required
--file PATH YAML file to load from Yes
--dry-run Simulate execution without applying changes No
--folder TEXT Override folder location for all objects No

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