diff --git a/CHANGELOG.md b/CHANGELOG.md index aed82e19..63d8eabd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,20 @@ All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines. +## [1.6.0](https://github.com/salesforcecli/plugin-user/compare/v1.5.3...v1.6.0) (2021-11-22) + + +### Features + +* assign psl ([75965da](https://github.com/salesforcecli/plugin-user/commit/75965da74bbd9ded96dd2dfc0c3309e8e3eabcf7)) +* assign PSL with messages ([fd5a22f](https://github.com/salesforcecli/plugin-user/commit/fd5a22fe027a5ae9c8d837353a710c20897833b3)) + + +### Bug Fixes + +* oops, wrong exit code (68 is partial success) ([2236044](https://github.com/salesforcecli/plugin-user/commit/22360444ae98ca6bae8fd4bc6976403ead6ca4fa)) +* warning for duplicate PSL assignment ([6c71d6e](https://github.com/salesforcecli/plugin-user/commit/6c71d6e60e9647fdf526bb97f4a66c1c212bcb16)) + ### [1.5.3](https://github.com/salesforcecli/plugin-user/compare/v1.5.2...v1.5.3) (2021-11-18) ### [1.5.2](https://github.com/salesforcecli/plugin-user/compare/v1.5.1...v1.5.2) (2021-10-13) diff --git a/README.md b/README.md index c5054390..f73117f0 100644 --- a/README.md +++ b/README.md @@ -87,12 +87,12 @@ For more NUT options and examples, see - -- [`sfdx force:user:create [name=value...] [-a ] [-f ] [-s] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceusercreate-namevalue--a-string--f-string--s--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) -- [`sfdx force:user:display [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserdisplay--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) -- [`sfdx force:user:list [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserlist--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) -- [`sfdx force:user:password:generate [-o ] [-l ] [-c ] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpasswordgenerate--o-array--l-integer--c-integer--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) -- [`sfdx force:user:permset:assign -n [-o ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpermsetassign--n-array--o-array--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) +* [`sfdx force:user:create [name=value...] [-a ] [-f ] [-s] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceusercreate-namevalue--a-string--f-string--s--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) +* [`sfdx force:user:display [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserdisplay--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) +* [`sfdx force:user:list [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserlist--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) +* [`sfdx force:user:password:generate [-o ] [-l ] [-c ] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpasswordgenerate--o-array--l-integer--c-integer--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) +* [`sfdx force:user:permset:assign -n [-o ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpermsetassign--n-array--o-array--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) +* [`sfdx force:user:permsetlicense:assign -n [-o ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpermsetlicenseassign--n-string--o-array--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal) ## `sfdx force:user:create [name=value...] [-a ] [-f ] [-s] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]` @@ -103,7 +103,7 @@ create a user for a scratch org Create a user for a scratch org, optionally setting an alias for use by the CLI, assigning permission sets (e.g., permsets=ps1,ps2), generating a password (e.g., generatepassword=true), and setting User sObject fields. USAGE - $ sfdx force:user:create [name=value...] [-a ] [-f ] [-s] [-v ] [-u ] [--apiversion + $ sfdx force:user:create [name=value...] [-a ] [-f ] [-s] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] OPTIONS @@ -132,7 +132,7 @@ OPTIONS this command invocation DESCRIPTION - Create a user for a scratch org, optionally setting an alias for use by the CLI, assigning permission sets (e.g., + Create a user for a scratch org, optionally setting an alias for use by the CLI, assigning permission sets (e.g., permsets=ps1,ps2), generating a password (e.g., generatepassword=true), and setting User sObject fields. EXAMPLES @@ -142,7 +142,7 @@ EXAMPLES sfdx force:user:create -f config/project-user-def.json email=me@my.org generatepassword=true ``` -_See code: [src/commands/force/user/create.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.2/src/commands/force/user/create.ts)_ +_See code: [src/commands/force/user/create.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.3/src/commands/force/user/create.ts)_ ## `sfdx force:user:display [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]` @@ -153,7 +153,7 @@ displays information about a user of a scratch org Output includes the profile name, org ID, access token, instance URL, login URL, and alias if applicable. USAGE - $ sfdx force:user:display [-v ] [-u ] [--apiversion ] [--json] [--loglevel + $ sfdx force:user:display [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] OPTIONS @@ -179,7 +179,7 @@ EXAMPLES sfdx force:user:display -u me@my.org --json ``` -_See code: [src/commands/force/user/display.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.2/src/commands/force/user/display.ts)_ +_See code: [src/commands/force/user/display.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.3/src/commands/force/user/display.ts)_ ## `sfdx force:user:list [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]` @@ -190,7 +190,7 @@ list all authenticated users of an org The original scratch org admin is marked with "(A)" USAGE - $ sfdx force:user:list [-v ] [-u ] [--apiversion ] [--json] [--loglevel + $ sfdx force:user:list [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] OPTIONS @@ -217,7 +217,7 @@ EXAMPLES sfdx force:user:list --json > tmp/MyUserList.json ``` -_See code: [src/commands/force/user/list.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.2/src/commands/force/user/list.ts)_ +_See code: [src/commands/force/user/list.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.3/src/commands/force/user/list.ts)_ ## `sfdx force:user:password:generate [-o ] [-l ] [-c ] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]` @@ -229,19 +229,19 @@ Generates and sets a random password for one or more scratch org users. Targets If you haven’t set a default Dev Hub, or if your scratch org isn’t associated with your default Dev Hub, --targetdevhubusername is required. -To change the password strength, set the --complexity parameter to a value between 0 and 5. Each value specifies the types of characters used in the generated password: +To change the password strength, set the --complexity parameter to a value between 0 and 5. Each value specifies the types of characters used in the generated password: 0 - lower case letters only 1 - lower case letters and numbers only 2 - lower case letters and symbols only 3 - lower and upper case letters and numbers only 4 - lower and upper case letters and symbols only -5 - lower and upper case letters and numbers and symbols only +5 - lower and upper case letters and numbers and symbols only To see a password that was previously generated, run "sfdx force:user:display". USAGE - $ sfdx force:user:password:generate [-o ] [-l ] [-c ] [-v ] [-u ] + $ sfdx force:user:password:generate [-o ] [-l ] [-c ] [-v ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] OPTIONS @@ -271,21 +271,21 @@ OPTIONS this command invocation DESCRIPTION - Generates and sets a random password for one or more scratch org users. Targets the usernames listed with the + Generates and sets a random password for one or more scratch org users. Targets the usernames listed with the --onbehalfof parameter or the --targetusername parameter. Defaults to the defaultusername. - If you haven’t set a default Dev Hub, or if your scratch org isn’t associated with your default Dev Hub, + If you haven’t set a default Dev Hub, or if your scratch org isn’t associated with your default Dev Hub, --targetdevhubusername is required. - To change the password strength, set the --complexity parameter to a value between 0 and 5. Each value specifies the - types of characters used in the generated password: + To change the password strength, set the --complexity parameter to a value between 0 and 5. Each value specifies the + types of characters used in the generated password: 0 - lower case letters only 1 - lower case letters and numbers only 2 - lower case letters and symbols only 3 - lower and upper case letters and numbers only 4 - lower and upper case letters and symbols only - 5 - lower and upper case letters and numbers and symbols only + 5 - lower and upper case letters and numbers and symbols only To see a password that was previously generated, run "sfdx force:user:display". @@ -297,7 +297,7 @@ EXAMPLES sfdx force:user:password:generate -o "user1@my.org,user2@my.org,user3@my.org" ``` -_See code: [src/commands/force/user/password/generate.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.2/src/commands/force/user/password/generate.ts)_ +_See code: [src/commands/force/user/password/generate.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.3/src/commands/force/user/password/generate.ts)_ ## `sfdx force:user:permset:assign -n [-o ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]` @@ -308,7 +308,7 @@ assign a permission set to one or more users of an org To specify an alias for the -u or -o parameter, use the username alias you set with the "alias:set" CLI command, not the User.Alias value of the org user. USAGE - $ sfdx force:user:permset:assign -n [-o ] [-u ] [--apiversion ] [--json] [--loglevel + $ sfdx force:user:permset:assign -n [-o ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] OPTIONS @@ -331,7 +331,7 @@ OPTIONS this command invocation DESCRIPTION - To specify an alias for the -u or -o parameter, use the username alias you set with the "alias:set" CLI command, not + To specify an alias for the -u or -o parameter, use the username alias you set with the "alias:set" CLI command, not the User.Alias value of the org user. EXAMPLES @@ -340,6 +340,43 @@ EXAMPLES sfdx force:user:permset:assign -n DreamHouse -o "user1@my.org,user2,user3" ``` -_See code: [src/commands/force/user/permset/assign.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.2/src/commands/force/user/permset/assign.ts)_ +_See code: [src/commands/force/user/permset/assign.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.3/src/commands/force/user/permset/assign.ts)_ + +## `sfdx force:user:permsetlicense:assign -n [-o ] [-u ] [--apiversion ] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]` + +assign a permission set license to one or more users of an org + +``` +assign a permission set license to one or more users of an org + +USAGE + $ sfdx force:user:permsetlicense:assign -n [-o ] [-u ] [--apiversion ] [--json] + [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] + +OPTIONS + -n, --name=name (required) the name of the + permission set license to assign + + -o, --onbehalfof=onbehalfof comma-separated list of usernames or + aliases to assign the permission set + license to + + -u, --targetusername=targetusername username or alias for the target + org; overrides default target org + + --apiversion=apiversion override the api version used for + api requests made by this command + + --json format output as json + + --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for + this command invocation + +EXAMPLES + sfdx force:user:permsetlicense:assign -n DreamHouse + sfdx force:user:permsetlicense:assign -n DreamHouse -u me@my.org + sfdx force:user:permsetlicense:assign -n DreamHouse -o "user1@my.org,user2,user3" +``` +_See code: [src/commands/force/user/permsetlicense/assign.ts](https://github.com/salesforcecli/plugin-user/blob/v1.5.3/src/commands/force/user/permsetlicense/assign.ts)_ diff --git a/package.json b/package.json index c6ba50f8..f682c0c5 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@salesforce/plugin-user", "description": "Commands to interact with Users and Permission Sets", - "version": "1.5.3", + "version": "1.6.0", "author": "Salesforce", "bugs": "https://github.com/forcedotcom/cli/issues", "dependencies": {