Skip to content

pp environment list

Lists Microsoft Power Platform environments

Usage

m365 pp environment list [options]

Options

--asAdmin
Run the command as admin and retrieve all environments. Lists only environments you have explicitly are assigned permissions to by default.
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

Attention

This command is based on an API that is currently in preview and is subject to change once the API reached general availability. Register CLI for Microsoft 365 or Azure AD application as a management application for the Power Platform using m365 pp managementapp add [options]

Examples

List Microsoft Power Platform environments

m365 pp environment list

List all Microsoft Power Platform environments

m365 pp environment list --asAdmin

Response

[
  {
    "id":"/providers/Microsoft.BusinessAppPlatform/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
    "type":"Microsoft.BusinessAppPlatform/environments",
    "location":"europe",
    "name":"Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
    "properties":{
      "tenantId":"e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
      "azureRegion":"northeurope",
      "displayName":"contoso (default)",
      "createdTime":"2020-03-12T13:39:17.9876946Z",
      "createdBy":{
        "id":"SYSTEM",
        "displayName":"SYSTEM",
        "type":"NotSpecified"
      },
      "provisioningState":"Succeeded",
      "creationType":"DefaultTenant",
      "environmentSku":"Default",
      "isDefault":true,
      "clientUris":{
        "admin":"https://admin.powerplatform.microsoft.com/environments/environment/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/hub",
        "maker":"https://make.powerapps.com/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/home"
      },
      "runtimeEndpoints":{
        "microsoft.BusinessAppPlatform":"https://europe.api.bap.microsoft.com",
        "microsoft.CommonDataModel":"https://europe.api.cds.microsoft.com",
        "microsoft.PowerApps":"https://europe.api.powerapps.com",
        "microsoft.PowerAppsAdvisor":"https://europe.api.advisor.powerapps.com",
        "microsoft.PowerVirtualAgents":"https://powervamg.eu-il109.gateway.prod.island.powerapps.com",
        "microsoft.ApiManagement":"https://management.EUROPE.azure-apihub.net",
        "microsoft.Flow":"https://emea.api.flow.microsoft.com"
      },
      "databaseType":"CommonDataService",
      "linkedEnvironmentMetadata":{
        "resourceId":"5041ef46-5a1c-4a0f-a185-6bb49b5c6686",
        "friendlyName":"contoso (default)",
        "uniqueName":"unq5041ef465a1c4a0fa1856bb49b5c6",
        "domainName":"org6633049a",
        "version":"9.2.22101.00168",
        "instanceUrl":"https://org6633049a.crm4.dynamics.com/",
        "instanceApiUrl":"https://org6633049a.api.crm4.dynamics.com",
        "baseLanguage":1033,
        "instanceState":"Ready",
        "createdTime":"2021-10-08T09:50:41.283Z",
        "backgroundOperationsState":"Enabled",
        "scaleGroup":"EURCRMLIVESG644",
        "platformSku":"Standard"
      },
      "trialScenarioType":"None",
      "retentionPeriod":"P7D",
      "states":{
        "management":{
          "id":"NotSpecified"
        },
        "runtime":{
          "runtimeReasonCode":"NotSpecified",
          "requestedBy":{
            "displayName":"SYSTEM",
            "type":"NotSpecified"
          },
          "id":"Enabled"
        }
      },
      "updateCadence":{
        "id":"Frequent"
      },
      "retentionDetails":{
        "retentionPeriod":"P7D",
        "backupsAvailableFromDateTime":"2022-10-23T23:27:16.8059564Z"
      },
      "protectionStatus":{
        "keyManagedBy":"Microsoft"
      },
      "cluster":{
        "category":"Prod",
        "number":"109",
        "uriSuffix":"eu-il109.gateway.prod.island",
        "geoShortName":"EU",
        "environment":"Prod"
      },
      "connectedGroups":[

      ],
      "lifecycleOperationsEnforcement":{
        "allowedOperations":[
          {
            "type":{
              "id":"Backup"
            }
          },
          {
            "type":{
              "id":"Edit"
            }
          },
          {
            "type":{
              "id":"Enable"
            }
          },
          {
            "type":{
              "id":"Disable"
            }
          },
          {
            "type":{
              "id":"EnableGovernanceConfiguration"
            }
          }
        ],
        "disallowedOperations":[
          {
            "type":{
              "id":"Provision"
            },
            "reason":{
              "message":"Provision cannot be performed because there is no linked CDS instance or the CDS instance version is not supported."
            }
          },
          {
            "type":{
              "id":"Unlock"
            },
            "reason":{
              "message":"Unlock cannot be performed because there is no linked CDS instance or the CDS instance version is not supported."
            }
          },
          {
            "type":{
              "id":"Convert"
            },
            "reason":{
              "message":"Convert cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"Copy"
            },
            "reason":{
              "message":"Copy cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"Delete"
            },
            "reason":{
              "message":"Delete cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"Promote"
            },
            "reason":{
              "message":"Promote cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"Recover"
            },
            "reason":{
              "message":"Recover cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"Reset"
            },
            "reason":{
              "message":"Reset cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"Restore"
            },
            "reason":{
              "message":"Restore cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"UpdateProtectionStatus"
            },
            "reason":{
              "message":"UpdateProtectionStatus cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"NewCustomerManagedKey"
            },
            "reason":{
              "message":"NewCustomerManagedKey cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"RotateCustomerManagedKey"
            },
            "reason":{
              "message":"RotateCustomerManagedKey cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"RevertToMicrosoftKey"
            },
            "reason":{
              "message":"RevertToMicrosoftKey cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"NewNetworkInjection"
            },
            "reason":{
              "message":"NewNetworkInjection cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"SwapNetworkInjection"
            },
            "reason":{
              "message":"SwapNetworkInjection cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"RevertNetworkInjection"
            },
            "reason":{
              "message":"RevertNetworkInjection cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"NewIdentity"
            },
            "reason":{
              "message":"NewIdentity cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"SwapIdentity"
            },
            "reason":{
              "message":"SwapIdentity cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"RevertIdentity"
            },
            "reason":{
              "message":"RevertIdentity cannot be performed on environment of type Default."
            }
          },
          {
            "type":{
              "id":"DisableGovernanceConfiguration"
            },
            "reason":{
              "message":"DisableGovernanceConfiguration cannot be performed on Power Platform environment because of the governance configuration."
            }
          },
          {
            "type":{
              "id":"UpdateGovernanceConfiguration"
            },
            "reason":{
              "message":"UpdateGovernanceConfiguration cannot be performed on Power Platform environment because of the governance configuration."
            }
          }
        ]
      },
      "governanceConfiguration":{
        "protectionLevel":"Basic"
      }
    },
    "displayName":"contoso (default)"
  }
]
displayName                             name
--------------------------------------- --------------------------------------------
environmentName (default) (org6633050c) Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e
name,displayName
Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d,contoso (default)