pac env

Work with your Dataverse organization.

Note

With pac cli version 1.32, the pac org command was changed to pac env. org will continue to work, but we recommend using env going forward.

Commands

Command Description
pac env fetch Performs FetchXML query against Dataverse
pac env list Lists all of the Dataverse organizations the user has access to
pac env list-settings List environment settings
pac env select Select default organization for current authentication profile.
pac env update-settings Update environment settings
pac env who Displays information about the current Dataverse organization.

pac env fetch

Performs FetchXML query against Dataverse

Optional Parameters for env fetch

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

--xml -x

FetchXML query to run

--xmlFile -xf

File with FetchXML query to run

pac env list

Lists all of the Dataverse organizations the user has access to

Example

pac env list --filter myenv

The filter parameter is a regular expression based filter.

Optional Parameters for env list

--filter -f

Show only environments containing filter criteria.

pac env list-settings

List environment settings

Example

C:\Users\you>pac env list-settings --filter number
Connected as you@yourorg.com
Setting                              Value
currentbulkoperationnumber           1,000
currentcampaignnumber                1,000
currentcasenumber                    1
currentcategorynumber                1,000
currentcontractnumber                1,000
currentimportsequencenumber          1
currentinvoicenumber                 1,000
currentkanumber                      1,000
currentkbnumber                      1,000
currentordernumber                   1,000
currentparsedtablenumber             1
currentquotenumber                   1,000
maximumtrackingnumber                999
nexttrackingnumber                   0
numberformat                         us
numbergroupformat                    3
numberseparator                      ,
recurrencedefaultnumberofoccurrences 10
showweeknumber                       No
timezoneruleversionnumber            0
versionnumber                        19,810,412

Optional Parameters for env list-settings

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

--filter -f

Show only settings containing filter criteria

Remarks

Each environment has an Organization table with a single row that stores settings for the environment.

Unless you apply the --filter parameter, this command returns all the columns from the first and only row of the organization entity type.

Use the pac env update-settings command to change the values for some of these settings.

Learn more about reading and updating environment settings

pac env select

Select default organization for current authentication profile.

Examples

The following examples show the use of the pac env select command.

Select env by using environment URL

This example shows how to select an env by using an environment URL.

pac env select --environment "https://contosotest.crm.dynamics.com"

Select env by using environment ID

This example shows how to select an env by using an environment ID.

pac env select --environment 00000000-0000-0000-0000-000000000000

Optional Parameters for env select

--environment -env

Default environment (ID, url, unique name, or partial name).

pac env update-settings

Update environment settings

Required Parameters for env update-settings

--name -n

Name of the setting to update

Optional Parameters for env update-settings

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

--value -v

Value to which setting should be updated to

Remarks

The pac env list-settings command returns all the columns from the first and only row of the organization entity type. Use pac env update-settings to change those settings.

Learn more about reading and updating environment settings

pac env who

Displays information about the current Dataverse organization.

Optional Parameters for env who

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

--json

Returns the output of the command as a JSON formatted string.

See also

Microsoft Power Platform CLI Command Groups
Microsoft Power Platform CLI overview