diff --git a/README.md b/README.md index 0e1d1bcf..7c43c06a 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ $ npm install -g @salesforce/cli $ sf COMMAND running command... $ sf (--version|-v) -@salesforce/cli/2.13.2 linux-x64 node-v18.18.0 +@salesforce/cli/2.13.3 linux-x64 node-v18.18.0 $ sf --help [COMMAND] USAGE $ sf COMMAND @@ -3093,7 +3093,8 @@ FLAGS stronger the password. -l, --length= [default: 13] Number of characters in the generated password; valid values are between 8 and 100. - -o, --on-behalf-of=... Comma-separated list of usernames or aliases to assign the password to. + -o, --on-behalf-of=... Comma-separated list of usernames or aliases to assign the password to; must have been + created locally with the "org create user" command. -u, --target-org= (required) Scratch org alias or login user. --api-version= Override the api version used for api requests made by this command @@ -3104,7 +3105,10 @@ DESCRIPTION Generate a random password for scratch org users. By default, new scratch orgs contain one admin user with no password. Use this command to generate or change a - password for any scratch org user. After it's set, you can’t unset a password, you can only change it. + password for this admin user. After it's set, you can’t unset a password, you can only change it. + + You can also use the --on-behalf-of flag to generate a password for a scratch org user that you've created locally + with the "org create user" command. This command doesn't work for users you created in the scratch org using Setup. To change the password strength, set the --complexity flag to a value between 0 and 5. Each value specifies the types of characters used in the generated password: @@ -3132,13 +3136,14 @@ EXAMPLES $ sf force user password generate --complexity 3 - Generate a password for the specified users in the default scratch org: + Generate a password for the specified users in the default scratch org; these users must have been created locally + with the "org create user" command: $ sf force user password generate --on-behalf-of user1@my.org --on-behalf-of user2@my.org --on-behalf-of \ user3@my.org ``` -_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.35/src/commands/force/user/password/generate.ts)_ +_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.36/src/commands/force/user/password/generate.ts)_ ## `sf help [COMMANDS]` @@ -3655,7 +3660,7 @@ EXAMPLES $ sf org assign permset --name DreamHouse --on-behalf-of user1@my.org --on-behalf-of user2 --on-behalf-of user ``` -_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.35/src/commands/org/assign/permset.ts)_ +_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.36/src/commands/org/assign/permset.ts)_ ## `sf org assign permsetlicense` @@ -3699,7 +3704,7 @@ EXAMPLES user3 ``` -_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.35/src/commands/org/assign/permsetlicense.ts)_ +_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.36/src/commands/org/assign/permsetlicense.ts)_ ## `sf org create sandbox` @@ -4055,7 +4060,7 @@ FLAG DESCRIPTIONS might be different than what you specify in the definition file. ``` -_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.35/src/commands/org/create/user.ts)_ +_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.36/src/commands/org/create/user.ts)_ ## `sf org delete sandbox` @@ -4219,7 +4224,7 @@ EXAMPLES $ sf org display user --target-org me@my.org --json ``` -_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.35/src/commands/org/display/user.ts)_ +_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.36/src/commands/org/display/user.ts)_ ## `sf org generate password` @@ -4230,7 +4235,8 @@ USAGE $ sf org generate password -o [--json] [-b ] [-l ] [-c ] [--api-version ] FLAGS - -b, --on-behalf-of=... Comma-separated list of usernames or aliases to assign the password to. + -b, --on-behalf-of=... Comma-separated list of usernames or aliases to assign the password to; must have been + created locally with the "org create user" command. -c, --complexity= [default: 5] Level of password complexity or strength; the higher the value, the stronger the password. -l, --length= [default: 13] Number of characters in the generated password; valid values are between @@ -4245,7 +4251,10 @@ DESCRIPTION Generate a random password for scratch org users. By default, new scratch orgs contain one admin user with no password. Use this command to generate or change a - password for any scratch org user. After it's set, you can’t unset a password, you can only change it. + password for this admin user. After it's set, you can’t unset a password, you can only change it. + + You can also use the --on-behalf-of flag to generate a password for a scratch org user that you've created locally + with the "org create user" command. This command doesn't work for users you created in the scratch org using Setup. To change the password strength, set the --complexity flag to a value between 0 and 5. Each value specifies the types of characters used in the generated password: @@ -4273,12 +4282,13 @@ EXAMPLES $ sf org generate password --complexity 3 - Generate a password for the specified users in the default scratch org: + Generate a password for the specified users in the default scratch org; these users must have been created locally + with the "org create user" command: $ sf org generate password --on-behalf-of user1@my.org --on-behalf-of user2@my.org --on-behalf-of user3@my.org ``` -_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.35/src/commands/org/generate/password.ts)_ +_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.36/src/commands/org/generate/password.ts)_ ## `sf org list` @@ -4500,7 +4510,7 @@ EXAMPLES $ sf org list users --target-org me@my.org ``` -_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.35/src/commands/org/list/users.ts)_ +_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/2.3.36/src/commands/org/list/users.ts)_ ## `sf org login access-token` diff --git a/package.json b/package.json index 3bc3ffc4..96e3f777 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@salesforce/cli", "description": "The Salesforce CLI", - "version": "2.13.2", + "version": "2.13.3", "author": "Salesforce", "bin": { "sf": "./bin/run.js", @@ -150,7 +150,7 @@ "@salesforce/plugin-telemetry": "2.3.6", "@salesforce/plugin-templates": "55.5.14", "@salesforce/plugin-trust": "2.6.18", - "@salesforce/plugin-user": "2.3.35", + "@salesforce/plugin-user": "2.3.36", "@salesforce/sf-plugins-core": "4.0.0", "debug": "^4.3.4" }, diff --git a/yarn.lock b/yarn.lock index 2b770179..78c29f72 100644 --- a/yarn.lock +++ b/yarn.lock @@ -1851,10 +1851,10 @@ shelljs "^0.8.4" tslib "^2" -"@salesforce/plugin-user@2.3.35": - version "2.3.35" - resolved "https://registry.yarnpkg.com/@salesforce/plugin-user/-/plugin-user-2.3.35.tgz#b7d7d5935c142de673466dba9e51c359b8eaed11" - integrity sha512-Iprqc6dEZ4nwt3xC3k0L+cVjwPoCrEm5byOvuSXyFTyXRy116Qz62VcSUKzKNtxHgVTjMzBlpMRHCH8bnQFVmA== +"@salesforce/plugin-user@2.3.36": + version "2.3.36" + resolved "https://registry.yarnpkg.com/@salesforce/plugin-user/-/plugin-user-2.3.36.tgz#7bd9e6f4414a2552684c4433222392d36c09a775" + integrity sha512-XzqNSg7TMRHAiMolm86tMJuQ42LDC5zq/lM/XEfaHA249KmNktsDb81TsK5WwYURVKZi+IS6zifLASAAdrnlpg== dependencies: "@oclif/core" "^2.15.0" "@salesforce/core" "^5.2.6"