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¶
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¶
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¶
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¶
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¶
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