You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.md
+2Lines changed: 2 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -2,6 +2,8 @@
2
2
3
3
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.
Copy file name to clipboardExpand all lines: README.md
+26-22Lines changed: 26 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -107,7 +107,7 @@ EXAMPLES
107
107
108
108
## `sf env list`
109
109
110
-
By default, the command displays only active environments. For orgs, active means unexpired scratch orgs and orgs you’re currently logged into. For compute environments, active means the environments connected to orgs you’re currently logged into. Use the --all flag to list expired or deleted scratch orgs and compute environments that aren’t connected to logged-in orgs. Warning: the latter list could be very long.
110
+
The command displays only active environments. For orgs, active means unexpired scratch orgs and orgs you’re currently logged into.
111
111
112
112
```
113
113
USAGE
@@ -116,55 +116,59 @@ USAGE
116
116
117
117
FLAGS
118
118
-x, --extended Show extra columns.
119
-
--columns=<value>... Only show provided columns.
119
+
--columns=<value>... List of columns to display.
120
120
--csv Output in csv format [alias: --output=csv]
121
121
--filter=<value> Filter property by partial string matching.
122
122
--no-header Hide table header from output.
123
-
--no-truncate Do not truncate output to fit screen.
123
+
--no-truncate Don't truncate output to fit screen.
124
124
125
-
--output=<option> Output in a more machine friendly format.
125
+
--output=<option> Format in which to display the output.
126
126
<options: csv|json|yaml>
127
127
128
-
--sort=<value> Property to sort by (prepend '-' for descending).
128
+
--sort=<value> Column to sort by (prepend '-' for descending).
129
129
130
130
GLOBAL FLAGS
131
131
--json format output as json
132
132
133
133
DESCRIPTION
134
134
List the environments you’ve created or logged into.
135
135
136
-
By default, the command displays only active environments. For orgs, active means unexpired scratch orgs and orgs
137
-
you’re currently logged into. For compute environments, active means the environments connected to orgs you’re
138
-
currently logged into. Use the --all flag to list expired or deleted scratch orgs and compute environments that aren’t
139
-
connected to logged-in orgs. Warning: the latter list could be very long.
136
+
The command displays only active environments. For orgs, active means unexpired scratch orgs and orgs you’re currently
137
+
logged into.
140
138
141
139
Output is displayed in multiple tables, one for each environment type. For example, the Salesforce Orgs table lists
142
-
the non-scratch orgs you’re logged into, such as sandboxes, Dev Hubs, production orgs, and so on. Scratch orgs and
143
-
compute environments get their own tables.
140
+
the non-scratch orgs you’re logged into, such as sandboxes, Dev Hubs, production orgs, and so on. Scratch orgs get
141
+
their own table.
144
142
145
143
For non-scratch orgs, the Username column refers to the user you logged into the org with. For scratch orgs it refers
146
-
to the username that was generated for you when you created the scratch org. The first column indicates the default
147
-
environment for each type.
144
+
to the username that was generated for you when you created the scratch org. The table also displays the default
145
+
environment for each type, the instance URL, and how you authorized (logged into) the org, either using a web browser
146
+
or JWT.
147
+
148
+
Use the table-manipulation flags, such as --filter and --sort, to change how the data is displayed.
148
149
149
150
Run "sf env display" to view details about a specific environment.
150
151
151
152
EXAMPLES
152
-
List all environments:
153
-
154
-
$ sf env list --all
153
+
List all active environments:
155
154
156
-
Filter the output to list only connected orgs. Rows from only the Salesforce Orgs table are displayed because it’s
157
-
the only table with a "Status" column.
155
+
$ sf env list
158
156
159
-
$ sf env list --filter "Status=Connected"
157
+
Filter the output to list only orgs you authorized using a web browser; "OAuth Method" is the name of a column:
160
158
161
-
List only scratch orgs that expire after May 30, 2021:
162
-
163
-
$ sf env list --filter "Expiration>2021-05-30"
159
+
$ sf env list --filter "OAuth Method=web"
164
160
165
161
Display only the Alias column and sort the aliases in descending order:
166
162
167
163
$ sf env list --sort "-Alias" --columns "Alias"
164
+
165
+
Don't truncate the displayed output:
166
+
167
+
$ sf env list --no-truncate
168
+
169
+
Display only the table data, not the headers, in comma-separated value (csv) format:
0 commit comments