@salesforce/plugin-settings 2.0.30 → 2.0.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -74,297 +74,9 @@ sf plugins
74
74
 
75
75
  <!-- commands -->
76
76
 
77
- - [`sf alias list`](#sf-alias-list)
78
- - [`sf alias set`](#sf-alias-set)
79
- - [`sf alias unset`](#sf-alias-unset)
80
- - [`sf config get`](#sf-config-get)
81
- - [`sf config list`](#sf-config-list)
82
- - [`sf config set`](#sf-config-set)
83
- - [`sf config unset`](#sf-config-unset)
77
+ # Command Topics
84
78
 
85
- ## `sf alias list`
86
-
87
- List all aliases currently set on your local computer.
88
-
89
- ```
90
- USAGE
91
- $ sf alias list [--json]
92
-
93
- GLOBAL FLAGS
94
- --json Format output as json.
95
-
96
- DESCRIPTION
97
- List all aliases currently set on your local computer.
98
-
99
- Aliases are global, which means that you can use all the listed aliases in any Salesforce DX project on your computer.
100
-
101
- ALIASES
102
- $ sf force alias list
103
-
104
- EXAMPLES
105
- List all the aliases you've set:
106
-
107
- $ sf alias list
108
- ```
109
-
110
- _See code: [src/commands/alias/list.ts](https://github.com/salesforcecli/plugin-settings/blob/2.0.30/src/commands/alias/list.ts)_
111
-
112
- ## `sf alias set`
113
-
114
- Set one or more aliases on your local computer.
115
-
116
- ```
117
- USAGE
118
- $ sf alias set [--json]
119
-
120
- GLOBAL FLAGS
121
- --json Format output as json.
122
-
123
- DESCRIPTION
124
- Set one or more aliases on your local computer.
125
-
126
- Aliases are user-defined short names that make it easier to use the CLI. For example, users often set an alias for a
127
- scratch org usernames because they're long and unintuitive. Check the --help of a CLI command to determine where you
128
- can use an alias.
129
-
130
- You can associate an alias with only one value at a time. If you set an alias multiple times, the alias points to the
131
- most recent value. Aliases are global; after you set an alias, you can use it in any Salesforce DX project on your
132
- computer.
133
-
134
- Use quotes to specify an alias value that contains spaces. You typically use an equal sign to set your alias, although
135
- you don't need it if you're setting a single alias in a command.
136
-
137
- ALIASES
138
- $ sf force alias set
139
-
140
- EXAMPLES
141
- Set an alias for a scratch org username:
142
-
143
- $ sf alias set my-scratch-org=test-sadbiytjsupn@example.com
144
-
145
- Set multiple aliases with a single command:
146
-
147
- $ sf alias set my-scratch-org=test-sadbiytjsupn@example.com my-other-scratch-org=test-ss0xut7txzxf@example.com
148
-
149
- Set an alias that contains spaces:
150
-
151
- $ sf alias set my-alias='alias with spaces'
152
-
153
- Set a single alias without using an equal sign:
154
-
155
- $ sf alias set my-scratch-org test-ss0xut7txzxf@example.com
156
- ```
157
-
158
- _See code: [src/commands/alias/set.ts](https://github.com/salesforcecli/plugin-settings/blob/2.0.30/src/commands/alias/set.ts)_
159
-
160
- ## `sf alias unset`
161
-
162
- Unset one or more aliases that are currently set on your local computer.
163
-
164
- ```
165
- USAGE
166
- $ sf alias unset [--json] [-a] [-p]
167
-
168
- FLAGS
169
- -a, --all Unset all currently set aliases.
170
- -p, --no-prompt Don't prompt the user for confirmation when unsetting all aliases.
171
-
172
- GLOBAL FLAGS
173
- --json Format output as json.
174
-
175
- DESCRIPTION
176
- Unset one or more aliases that are currently set on your local computer.
177
-
178
- Aliases are global, so when you unset one it's no longer available in any Salesforce DX project.
179
-
180
- ALIASES
181
- $ sf force alias unset
182
-
183
- EXAMPLES
184
- Unset an alias:
185
-
186
- $ sf alias unset my-alias
187
-
188
- Unset multiple aliases with a single command:
189
-
190
- $ sf alias unset my-alias my-other-alias
191
-
192
- Unset all aliases:
193
-
194
- $ sf alias unset --all [--no-prompt]
195
- ```
196
-
197
- _See code: [src/commands/alias/unset.ts](https://github.com/salesforcecli/plugin-settings/blob/2.0.30/src/commands/alias/unset.ts)_
198
-
199
- ## `sf config get`
200
-
201
- Get the value of a configuration variable.
202
-
203
- ```
204
- USAGE
205
- $ sf config get [--json] [--verbose]
206
-
207
- FLAGS
208
- --verbose Display whether the configuration variables are set locally or globally.
209
-
210
- GLOBAL FLAGS
211
- --json Format output as json.
212
-
213
- DESCRIPTION
214
- Get the value of a configuration variable.
215
-
216
- Run "sf config list" to see the configuration variables you've already set and their level (local or global).
217
-
218
- Run "sf config set" to set a configuration variable. For the full list of available configuration variables, see
219
- https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_dev_cli_config_values.htm.
220
-
221
- ALIASES
222
- $ sf force config get
223
-
224
- EXAMPLES
225
- Get the value of the "target-org" configuration variable.
226
-
227
- $ sf config get target-org
228
-
229
- Get multiple configuration variables and display whether they're set locally or globally:
230
-
231
- $ sf config get target-org api-version --verbose
232
- ```
233
-
234
- _See code: [src/commands/config/get.ts](https://github.com/salesforcecli/plugin-settings/blob/2.0.30/src/commands/config/get.ts)_
235
-
236
- ## `sf config list`
237
-
238
- List the configuration variables that you've previously set.
239
-
240
- ```
241
- USAGE
242
- $ sf config list [--json]
243
-
244
- GLOBAL FLAGS
245
- --json Format output as json.
246
-
247
- DESCRIPTION
248
- List the configuration variables that you've previously set.
249
-
250
- A config variable can be global or local, depending on whether you used the --global flag when you set it. Local
251
- config variables apply only to the current project and override global config variables, which apply to all projects.
252
- You can set all config variables as environment variables. Environment variables override their equivalent local and
253
- global config variables.
254
-
255
- The output of this command takes into account your current context. For example, let's say you run this command from a
256
- Salesforce DX project in which you've locally set the "target-org" config variable. The command displays the local
257
- value, even if you've also set "target-org" globally. If you haven't set the config variable locally, then the global
258
- value is displayed, if set. If you set the SF_TARGET_ORG environment variable, it's displayed as such and overrides
259
- any locally or globally set "target-org" config variable.
260
-
261
- For the full list of available configuration variables, see
262
- https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_dev_cli_config_values.htm.
263
-
264
- ALIASES
265
- $ sf force config list
266
-
267
- EXAMPLES
268
- List the global and local configuration variables that apply to your current context:
269
-
270
- $ sf config list
271
- ```
272
-
273
- _See code: [src/commands/config/list.ts](https://github.com/salesforcecli/plugin-settings/blob/2.0.30/src/commands/config/list.ts)_
274
-
275
- ## `sf config set`
276
-
277
- Set one or more configuration variables, such as your default org.
278
-
279
- ```
280
- USAGE
281
- $ sf config set [--json] [-g]
282
-
283
- FLAGS
284
- -g, --global Set the configuration variables globally, so they can be used from any Salesforce DX project.
285
-
286
- GLOBAL FLAGS
287
- --json Format output as json.
288
-
289
- DESCRIPTION
290
- Set one or more configuration variables, such as your default org.
291
-
292
- Use configuration variables to set CLI defaults, such as your default org or the API version you want the CLI to use.
293
- For example, if you set the "target-org" configuration variable, you don't need to specify it as a "sf deploy
294
- metadata" flag if you're deploying to your default org.
295
-
296
- Local configuration variables apply only to your current project. Global variables, specified with the --global flag,
297
- apply in any Salesforce DX project.
298
-
299
- The resolution order if you've set a flag value in multiple ways is as follows:
300
-
301
- 1. Flag value specified at the command line.
302
- 2. Local (project-level) configuration variable.
303
- 3. Global configuration variable.
304
-
305
- Run "sf config list" to see the configuration variables you've already set and their level (local or global).
306
-
307
- If you're setting a single config variable, you don't need to use an equal sign between the variable and value. But
308
- you must use the equal sign if setting multiple config variables.
309
-
310
- For the full list of available configuration variables, see
311
- https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_dev_cli_config_values.htm.
312
-
313
- ALIASES
314
- $ sf force config set
315
-
316
- EXAMPLES
317
- Set the local target-org configuration variable to an org username:
318
-
319
- $ sf config set target-org me@my.org
320
-
321
- Set the local target-org configuration variable to an alias:
322
-
323
- $ sf config set target-org my-scratch-org
324
-
325
- Set the global target-org and target-dev-hub configuration variables using aliases:
326
-
327
- $ sf config set --global target-org=my-scratch-org target-dev-hub=my-dev-hub
328
- ```
329
-
330
- _See code: [src/commands/config/set.ts](https://github.com/salesforcecli/plugin-settings/blob/2.0.30/src/commands/config/set.ts)_
331
-
332
- ## `sf config unset`
333
-
334
- Unset local or global configuration variables.
335
-
336
- ```
337
- USAGE
338
- $ sf config unset [--json] [-g]
339
-
340
- FLAGS
341
- -g, --global Unset the configuration variables globally.
342
-
343
- GLOBAL FLAGS
344
- --json Format output as json.
345
-
346
- DESCRIPTION
347
- Unset local or global configuration variables.
348
-
349
- Local configuration variables apply only to your current project. Global configuration variables apply in any
350
- Salesforce DX project.
351
-
352
- For the full list of available configuration variables, see
353
- https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_dev_cli_config_values.htm.
354
-
355
- ALIASES
356
- $ sf force config unset
357
-
358
- EXAMPLES
359
- Unset the local "target-org" configuration variable:
360
-
361
- $ sf config unset target-org
362
-
363
- Unset multiple configuration variables globally:
364
-
365
- $ sf config unset target-org api-version --global
366
- ```
367
-
368
- _See code: [src/commands/config/unset.ts](https://github.com/salesforcecli/plugin-settings/blob/2.0.30/src/commands/config/unset.ts)_
79
+ - [`sf alias`](docs/alias.md) - Use the alias commands to manage your aliases.
80
+ - [`sf config`](docs/config.md) - Commands to configure Salesforce CLI.
369
81
 
370
82
  <!-- commandsstop -->