Profile
Commands to manage profiles in your project or org
sfp profile merge
Merge changes made in the profile directly in the org to the profile files in the local project
USAGE
$ sfp profile merge -o <value> [--json] [-f <value>...] [-n <value>...] [-m <value>...] [-d] [--apiversion
<value>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
FLAGS
-d, --delete set this flag to delete profile files that does not exist in the org.
-f, --folder=<value>... comma separated list of folders to scan for profiles. If ommited, the folders in the
packageDirectories configuration will be used.
-m, --metadata=<value>... comma separated list of metadata for which the permissions will be retrieved.
-n, --profilelist=<value>... comma separated list of profiles. If ommited, all the profiles found in the folder(s)
will be merged
-o, --targetorg=<value> (required) Username or alias of the target org.
--apiversion=<value> Override the api version used for api requests made by this command
--loglevel=<option> [default: info] logging level for this command invocation
<options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Merge changes made in the profile directly in the org to the profile files in the local project
EXAMPLES
$ sfp profile:merge -o sandbox
$ sfp profile:merge -f force-app -n "My Profile" -u sandbox
$ sfp profile:merge -f "module1, module2, module3" -n "My Profile1, My profile2" -u sandboxSee code: src/commands/profile/merge.ts
sfp profile reconcile
Reconcile profiles in the local directory only with the attributes that are available in the target org
USAGE
$ sfp profile reconcile -o <value> [--json] [-f <value>...] [-n <value>...] [-d <value>] [-s] [--apiversion <value>]
[--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
FLAGS
-d, --destfolder=<value> the destination folder for reconciled profiles, if omitted existing profiles will be
reconciled and will be rewritten in the current location
-f, --folder=<value>... path to the folder which contains the profiles to be reconciled,if project contain
multiple package directories, please provide a comma seperated list, if omitted, all the
package directories will be checked for profiles
-n, --profilelist=<value>... list of profiles to be reconciled. If ommited, all the profiles components will be
reconciled.
-o, --targetorg=<value> (required) Username or alias of the target org.
-s, --sourceonly set this flag to reconcile profiles only against component available in the project
only. Configure ignored perissions in sfdx-project.json file in the array
plugins->sfpowerkit->ignoredPermissions.
--apiversion=<value> Override the api version used for api requests made by this command
--loglevel=<option> [default: info] logging level for this command invocation
<options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Reconcile profiles in the local directory only with the attributes that are available in the target org
EXAMPLES
$ sfp profile:reconcile --folder force-app -d destfolder -s
$ sfp profile:reconcile --folder force-app,module2,module3 -o sandbox -d destfolder
$ sfp profile:reconcile -o myscratchorg -d destfolderSee code: src/commands/profile/reconcile.ts
sfp profile retrieve
Retrieve profiles from the salesforce org with all its associated permissions. Common use case for this command is to migrate profile changes from a integration environment to other higher environments [overcomes SFDX CLI Profile retrieve issue where it doesnt fetch the full profile unless the entire metadata is present in source], or retrieving profiles from production to lower environments for testing.
USAGE
$ sfp profile retrieve -o <value> [--json] [-f <value>...] [-n <value>...] [-d] [--apiversion <value>] [--loglevel
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
FLAGS
-d, --delete set this flag to delete profile files that does not exist in the org, when retrieving in
bulk
-f, --folder=<value>... retrieve only updated versions of profiles found in this directory, If ignored, all
profiles will be retrieved.
-n, --profilelist=<value>... comma separated list of profiles to be retrieved. Use it for selectively retrieving an
existing profile or retrieving a new profile
-o, --targetorg=<value> (required) Username or alias of the target org.
--apiversion=<value> Override the api version used for api requests made by this command
--loglevel=<option> [default: info] logging level for this command invocation
<options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Retrieve profiles from the salesforce org with all its associated permissions. Common use case for this command is to
migrate profile changes from a integration environment to other higher environments [overcomes SFDX CLI Profile
retrieve issue where it doesnt fetch the full profile unless the entire metadata is present in source], or retrieving
profiles from production to lower environments for testing.
EXAMPLES
$ sfp profile:retrieve -o prod
$ sfp profile:retrieve -f force-app -n "My Profile" -o prod
$ sfp profile:retrieve -f "module1, module2, module3" -n "My Profile1, My profile2" -o prodSee code: src/commands/profile/retrieve.ts