@pnp/cli-microsoft365 6.8.0 → 6.9.0-beta.bb31388

package/docs/docs/cmd/pa/connector/connector-export.mdx

@@ -0,0 +1,60 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# pa connector export
+
+Exports the specified Power Automate or Power Apps custom connector
+
+## Usage
+
+```sh
+m365 pa connector export [options]
+```
+
+## Alias
+
+```sh
+m365 flow connector export
+```
+
+## Options
+
+```md defintion-list
+`-e, --environmentName <environmentName>`
+: The name of the environment where the custom connector to export is located
+
+`-c, --connector <connector>`
+: The name of the custom connector to export
+
+`--outputFolder [outputFolder]`
+: Path where the folder with connector's files should be saved. If not specified, will create the connector's folder in the current folder.
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+If no output folder has been specified, the `pa connector export` command will create a folder named after the connector in the current folder. If the output folder has been specified, the folder named after the connector will be created in that folder.
+
+## Examples
+
+Export the specified custom connector
+
+```sh
+m365 pa connector export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --connector shared_connector-201-5f20a1f2d8d6777a75-5fa602f410652f4dfa
+```
+
+Export the specified custom connector to the specific directory
+
+```sh
+m365 pa connector export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --connector shared_connector-201-5f20a1f2d8d6777a75-5fa602f410652f4dfa --outputFolder connector
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pa/connector/connector-list.mdx

@@ -0,0 +1,158 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pa connector list
+
+Lists custom connectors in the given environment
+
+## Usage
+
+```sh
+m365 pa connector list [options]
+```
+
+## Alias
+
+```sh
+m365 flow connector list
+```
+
+## Options
+
+```md defintion-list
+`-e, --environmentName <environmentName>`
+: The name of the environment for which to retrieve custom connectors
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+## Examples
+
+List all custom connectors in the given environment
+
+```sh
+m365 pa connector list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "name":"shared_my-20connector-5f0027f520b23e81c1-5f9888a90360086012",
+      "id":"/providers/Microsoft.PowerApps/apis/shared_my-20connector-5f0027f520b23e81c1-5f9888a90360086012",
+      "type":"Microsoft.PowerApps/apis",
+      "properties":{
+        "displayName":"My connector",
+        "iconUri":"https://az787822.vo.msecnd.net/defaulticons/api-dedicated.png",
+        "iconBrandColor":"#007ee5",
+        "contact":{},
+        "license":{},
+        "apiEnvironment":"Shared",
+        "isCustomApi":true,
+        "connectionParameters":{},
+        "runtimeUrls":[
+          "https://europe-002.azure-apim.net/apim/my-20connector-5f0027f520b23e81c1-5f9888a90360086012"
+        ],
+        "primaryRuntimeUrl":"https://europe-002.azure-apim.net/apim/my-20connector-5f0027f520b23e81c1-5f9888a90360086012",
+        "metadata":{
+          "source":"powerapps-user-defined",
+          "brandColor":"#007ee5",
+          "contact":{},
+          "license":{},
+          "publisherUrl":null,
+          "serviceUrl":null,
+          "documentationUrl":null,
+          "environmentName":"Default-0d645e38-ec52-4a4f-ac58-65f2ac4015f6",
+          "xrmConnectorId":null,
+          "almMode":"Environment",
+          "createdBy":"{\"id\":\"03043611-d01e-4e58-9fbe-1a18ecb861d8\",\"displayName\":\"MOD Administrator\",\"email\":\"admin@contoso.OnMicrosoft.com\",\"type\":\"User\",\"tenantId\":\"0d645e38-ec52-4a4f-ac58-65f2ac4015f6\",\"userPrincipalName\":\"admin@contoso.onmicrosoft.com\"}",
+          "modifiedBy":"{\"id\":\"03043611-d01e-4e58-9fbe-1a18ecb861d8\",\"displayName\":\"MOD Administrator\",\"email\":\"admin@contoso.OnMicrosoft.com\",\"type\":\"User\",\"tenantId\":\"0d645e38-ec52-4a4f-ac58-65f2ac4015f6\",\"userPrincipalName\":\"admin@contoso.onmicrosoft.com\"}",
+          "allowSharing":false
+        },
+        "capabilities":[],
+        "description":"",
+        "apiDefinitions":{
+          "originalSwaggerUrl":"https://paeu2weu8.blob.core.windows.net/api-swagger-files/my-20connector-5f0027f520b23e81c1-5f9888a90360086012.json_original?sv=2018-03-28&sr=b&sig=cOkjAecgpr6sSznMpDqiZitUOpVvVDJRCOZfe3VmReU%3D&se=2019-12-05T19%3A53%3A49Z&sp=r",
+          "modifiedSwaggerUrl":"https://paeu2weu8.blob.core.windows.net/api-swagger-files/my-20connector-5f0027f520b23e81c1-5f9888a90360086012.json?sv=2018-03-28&sr=b&sig=rkpKHP8K%2F2yNBIUQcVN%2B0ZPjnP9sECrM%2FfoZMG%2BJZX0%3D&se=2019-12-05T19%3A53%3A49Z&sp=r"
+        },
+        "createdBy":{
+          "id":"03043611-d01e-4e58-9fbe-1a18ecb861d8",
+          "displayName":"MOD Administrator",
+          "email":"admin@contoso.OnMicrosoft.com",
+          "type":"User",
+          "tenantId":"0d645e38-ec52-4a4f-ac58-65f2ac4015f6",
+          "userPrincipalName":"admin@contoso.onmicrosoft.com"
+        },
+        "modifiedBy":{
+          "id":"03043611-d01e-4e58-9fbe-1a18ecb861d8",
+          "displayName":"MOD Administrator",
+          "email":"admin@contoso.OnMicrosoft.com",
+          "type":"User",
+          "tenantId":"0d645e38-ec52-4a4f-ac58-65f2ac4015f6",
+          "userPrincipalName":"admin@contoso.onmicrosoft.com"
+        },
+        "createdTime":"2019-12-05T18:45:03.4615313Z",
+        "changedTime":"2019-12-05T18:45:03.4615313Z",
+        "environment":{
+          "id":"/providers/Microsoft.PowerApps/environments/Default-0d645e38-ec52-4a4f-ac58-65f2ac4015f6",
+          "name":"Default-0d645e38-ec52-4a4f-ac58-65f2ac4015f6"
+        },
+        "tier":"Standard",
+        "publisher":"MOD Administrator",
+        "almMode":"Environment"
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  name                                                        displayName
+  ----------------------------------------------------------- ------------
+  shared_my-20connector-5f0027f520b23e81c1-5f9888a90360086012 My connector
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,displayName
+  shared_my-20connector-5f0027f520b23e81c1-5f9888a90360086012,My connector
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pa connector list --environmentName "Default-0d645e38-ec52-4a4f-ac58-65f2ac4015f6"
+
+  Date: 9/1/2023
+
+  ## My connector (/providers/Microsoft.PowerApps/apis/shared_my-20connector-5f0027f520b23e81c1-5f9888a90360086012)
+
+  Property | Value
+  ---------|-------
+  name | shared_my-20connector-5f0027f520b23e81c1-5f9888a90360086012
+  id | /providers/Microsoft.PowerApps/apis/shared_my-20connector-5f0027f520b23e81c1-5f9888a90360086012
+  type | Microsoft.PowerApps/apis
+  properties | {"displayName":"My connector","iconUri":"https://az787822.vo.msecnd.net/defaulticons/api-dedicated.png","iconBrandColor":"#007ee5","contact":{},"license":{},"apiEnvironment":"Shared","isCustomApi":true,"connectionParameters":{},"runtimeUrls":["https://europe-002.azure-apim.net/apim/my-20connector-5f0027f520b23e81c1-5f9888a90360086012"],"primaryRuntimeUrl":"https://europe-002.azure-apim.net/apim/my-20connector-5f0027f520b23e81c1-5f9888a90360086012","metadata":{"source":"powerapps-user-defined","brandColor":"#007ee5","contact":{},"license":{},"publisherUrl":null,"serviceUrl":null,"documentationUrl":null,"environmentName":"Default-0d645e38-ec52-4a4f-ac58-65f2ac4015f6","xrmConnectorId":null,"almMode":"Environment","createdBy":"{\"id\":\"03043611-d01e-4e58-9fbe-1a18ecb861d8\",\"displayName\":\"MOD Administrator\",\"email\":\"admin@contoso.OnMicrosoft.com\",\"type\":\"User\",\"tenantId\":\"0d645e38-ec52-4a4f-ac58-65f2ac4015f6\",\"userPrincipalName\":\"admin@contoso.onmicrosoft.com\"}","modifiedBy":"{\"id\":\"03043611-d01e-4e58-9fbe-1a18ecb861d8\",\"displayName\":\"MOD Administrator\",\"email\":\"admin@contoso.OnMicrosoft.com\",\"type\":\"User\",\"tenantId\":\"0d645e38-ec52-4a4f-ac58-65f2ac4015f6\",\"userPrincipalName\":\"admin@contoso.onmicrosoft.com\"}","allowSharing":false},"capabilities":[],"description":"","apiDefinitions":{"originalSwaggerUrl":"https://paeu2weu8.blob.core.windows.net/api-swagger-files/my-20connector-5f0027f520b23e81c1-5f9888a90360086012.json_original?sv=2018-03-28&sr=b&sig=cOkjAecgpr6sSznMpDqiZitUOpVvVDJRCOZfe3VmReU%3D&se=2019-12-05T19%3A53%3A49Z&sp=r","modifiedSwaggerUrl":"https://paeu2weu8.blob.core.windows.net/api-swagger-files/my-20connector-5f0027f520b23e81c1-5f9888a90360086012.json?sv=2018-03-28&sr=b&sig=rkpKHP8K%2F2yNBIUQcVN%2B0ZPjnP9sECrM%2FfoZMG%2BJZX0%3D&se=2019-12-05T19%3A53%3A49Z&sp=r"},"createdBy":{"id":"03043611-d01e-4e58-9fbe-1a18ecb861d8","displayName":"MOD Administrator","email":"admin@contoso.OnMicrosoft.com","type":"User","tenantId":"0d645e38-ec52-4a4f-ac58-65f2ac4015f6","userPrincipalName":"admin@contoso.onmicrosoft.com"},"modifiedBy":{"id":"03043611-d01e-4e58-9fbe-1a18ecb861d8","displayName":"MOD Administrator","email":"admin@contoso.OnMicrosoft.com","type":"User","tenantId":"0d645e38-ec52-4a4f-ac58-65f2ac4015f6","userPrincipalName":"admin@contoso.onmicrosoft.com"},"createdTime":"2019-12-05T18:45:03.4615313Z","changedTime":"2019-12-05T18:45:03.4615313Z","environment":{"id":"/providers/Microsoft.PowerApps/environments/Default-0d645e38-ec52-4a4f-ac58-65f2ac4015f6","name":"Default-0d645e38-ec52-4a4f-ac58-65f2ac4015f6"},"tier":"Standard","publisher":"MOD Administrator","almMode":"Environment"}
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/pa/environment/environment-get.mdx

@@ -0,0 +1,185 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pa environment get
+
+Gets information about the specified Power Apps environment
+
+## Usage
+
+```sh
+m365 pa environment get [options]
+```
+
+## Options
+
+```md defintion-list
+`-n, --name [name]`
+: The name of the environment. When not specified, the default environment is retrieved.
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
+
+## Examples
+
+Get information about the default Power Apps environment
+
+```sh
+m365 pa environment get
+```
+
+Get information about the Power Apps environment named _Default-d87a7535-dd31-4437-bfe1-95340acd55c5_
+
+```sh
+m365 pa environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "/providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
+    "name": "Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
+    "location": "europe",
+    "type": "Microsoft.PowerApps/environments",
+    "properties": {
+      "azureRegionHint": "westeurope",
+      "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",
+        "platformSku": "Standard"
+      },
+      "retentionPeriod": "P7D",
+      "lifecycleAuthority": "Environment",
+      "states": {
+        "management": {
+          "id": "NotSpecified"
+        },
+        "runtime": {
+          "runtimeReasonCode": "NotSpecified",
+          "requestedBy": {
+            "displayName": "SYSTEM",
+            "type": "NotSpecified"
+          },
+          "id": "Enabled"
+        }
+      },
+      "updateCadence": {
+        "id": "Frequent"
+      },
+      "connectedGroups": [],
+      "protectionStatus": {
+        "keyManagedBy": "Microsoft"
+      },
+      "trialScenarioType": "None",
+      "cluster": {
+        "category": "Prod",
+        "number": "109",
+        "uriSuffix": "eu-il109.gateway.prod.island",
+        "geoShortName": "EU",
+        "environment": "Prod"
+      },
+      "governanceConfiguration": {
+        "protectionLevel": "Basic"
+      }
+    },
+    "displayName": "contoso (default)",
+    "provisioningState": "Succeeded",
+    "environmentSku": "Default",
+    "azureRegionHint": "westeurope",
+    "isDefault": true
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  azureRegionHint  : westeurope
+  displayName      : environmentName (default)
+  environmentSku   : Default
+  id               : /providers/Microsoft.PowerApps/environments/Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e
+  isDefault        : true
+  location         : europe
+  name             : Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e
+  provisioningState: Succeeded
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,id,location,displayName,provisioningState,environmentSku,azureRegionHint,isDefault
+  Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e,/providers/Microsoft.PowerApps/environments/Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e,europe,environmentName (default),Succeeded,Default,westeurope,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pa environment get --name "Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d"
+
+  Date: 9/1/2023
+
+  ## environmentName (default) (org6633050c) (/providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d)
+
+  Property | Value
+  ---------|-------
+  id | /providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d
+  name | Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d
+  location | europe
+  type | Microsoft.PowerApps/environments
+  properties | {"azureRegionHint":"westeurope","displayName":"contoso (default) (org6633049a)","createdTime":"2020-03-12T13:39:17.9876946Z","createdBy":{"id":"SYSTEM","displayName":"SYSTEM","type":"NotSpecified"},"provisioningState":"Succeeded","creationType":"DefaultTenant","environmentSku":"Default","environmentType":"Production","isDefault":true,"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"},"linkedEnvironmentMetadata":{"type":"Dynamics365Instance","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","modifiedTime":"2022-10-29T14:04:14.0720726Z","hostNameSuffix":"crm4.dynamics.com","bapSolutionId":"00000001-0000-0000-0001-00000000009b","creationTemplates":["D365_CDS"],"webApiVersion":"v9.0","platformSku":"Standard"},"retentionPeriod":"P7D","lifecycleAuthority":"Environment","states":{"management":{"id":"NotSpecified"},"runtime":{"runtimeReasonCode":"NotSpecified","requestedBy":{"displayName":"SYSTEM","type":"NotSpecified"},"id":"Enabled"}},"updateCadence":{"id":"Frequent"},"connectedGroups":[],"protectionStatus":{"keyManagedBy":"Microsoft"},"trialScenarioType":"None","cluster":{"category":"Prod","number":"109","uriSuffix":"eu-il109.gateway.prod.island","geoShortName":"EU","environment":"Prod"},"governanceConfiguration":{"protectionLevel":"Basic"}}
+  displayName | contoso (default) (org6633049a)
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/pa/environment/environment-list.mdx

@@ -0,0 +1,169 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pa environment list
+
+Lists Microsoft Power Apps environments in the current tenant
+
+## Usage
+
+```sh
+m365 pa environment list [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+:::caution
+
+This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+## Examples
+
+List Microsoft Power Apps environments in the current tenant
+
+```sh
+m365 pa environment list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id":"/providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
+      "name":"Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
+      "location":"europe",
+      "type":"Microsoft.PowerApps/environments",
+      "properties":{
+        "azureRegionHint":"westeurope",
+        "displayName":"contoso (default) (org6633049a)",
+        "createdTime":"2020-03-12T13:39:17.9876946Z",
+        "createdBy":{
+          "id":"SYSTEM",
+          "displayName":"SYSTEM",
+          "type":"NotSpecified"
+        },
+        "provisioningState":"Succeeded",
+        "creationType":"DefaultTenant",
+        "environmentSku":"Default",
+        "environmentType":"Production",
+        "isDefault":true,
+        "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"
+        },
+        "linkedEnvironmentMetadata":{
+          "type":"Dynamics365Instance",
+          "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",
+          "modifiedTime":"2022-10-29T14:04:14.0720726Z",
+          "hostNameSuffix":"crm4.dynamics.com",
+          "bapSolutionId":"00000001-0000-0000-0001-00000000009b",
+          "creationTemplates":[
+            "D365_CDS"
+          ],
+          "webApiVersion":"v9.0",
+          "platformSku":"Standard"
+        },
+        "retentionPeriod":"P7D",
+        "lifecycleAuthority":"Environment",
+        "states":{
+          "management":{
+            "id":"NotSpecified"
+          },
+          "runtime":{
+            "runtimeReasonCode":"NotSpecified",
+            "requestedBy":{
+              "displayName":"SYSTEM",
+              "type":"NotSpecified"
+            },
+            "id":"Enabled"
+          }
+        },
+        "updateCadence":{
+          "id":"Frequent"
+        },
+        "connectedGroups":[],
+        "protectionStatus":{
+          "keyManagedBy":"Microsoft"
+        },
+        "trialScenarioType":"None",
+        "cluster":{
+          "category":"Prod",
+          "number":"109",
+          "uriSuffix":"eu-il109.gateway.prod.island",
+          "geoShortName":"EU",
+          "environment":"Prod"
+        },
+        "governanceConfiguration":{
+          "protectionLevel":"Basic"
+        }
+      },
+      "displayName":"contoso (default) (org6633049a)"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  displayName                             name
+  --------------------------------------- --------------------------------------------
+  environmentName (default) (org6633050c) Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,displayName
+  Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e,environmentName (default) (org6633050c)
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pa environment list
+
+  Date: 9/1/2023
+
+  ## environmentName (default) (org6633050c) (/providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d)
+
+  Property | Value
+  ---------|-------
+  id | /providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d
+  name | Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d
+  location | europe
+  type | Microsoft.PowerApps/environments
+  properties | {"azureRegionHint":"westeurope","displayName":"contoso (default) (org6633049a)","createdTime":"2020-03-12T13:39:17.9876946Z","createdBy":{"id":"SYSTEM","displayName":"SYSTEM","type":"NotSpecified"},"provisioningState":"Succeeded","creationType":"DefaultTenant","environmentSku":"Default","environmentType":"Production","isDefault":true,"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"},"linkedEnvironmentMetadata":{"type":"Dynamics365Instance","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","modifiedTime":"2022-10-29T14:04:14.0720726Z","hostNameSuffix":"crm4.dynamics.com","bapSolutionId":"00000001-0000-0000-0001-00000000009b","creationTemplates":["D365_CDS"],"webApiVersion":"v9.0","platformSku":"Standard"},"retentionPeriod":"P7D","lifecycleAuthority":"Environment","states":{"management":{"id":"NotSpecified"},"runtime":{"runtimeReasonCode":"NotSpecified","requestedBy":{"displayName":"SYSTEM","type":"NotSpecified"},"id":"Enabled"}},"updateCadence":{"id":"Frequent"},"connectedGroups":[],"protectionStatus":{"keyManagedBy":"Microsoft"},"trialScenarioType":"None","cluster":{"category":"Prod","number":"109","uriSuffix":"eu-il109.gateway.prod.island","geoShortName":"EU","environment":"Prod"},"governanceConfiguration":{"protectionLevel":"Basic"}}
+  displayName | contoso (default) (org6633049a)
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/pa/pcf/pcf-init.mdx

@@ -0,0 +1,56 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# pa pcf init
+
+Creates new PowerApps component framework project
+
+## Usage
+
+```sh
+m365 pa pcf init [options]
+```
+
+## Options
+
+```md defintion-list
+`--namespace <namespace>`
+: The namespace for the component.
+
+`--name <name>`
+: The name for the component.
+
+`--template <template>`
+: Choose a template for the component. `Field,Dataset`.
+```
+
+<Global />
+
+## Remarks
+
+Name cannot contain reserved Javascript words. Only characters within the ranges [A-Z], [a-z] or [0-9] are allowed. The first character may not be a number.
+
+Namespace cannot contain reserved Javascript words. Only characters within the ranges [A-Z], [a-z], [0-9], or '.' are allowed. The first and last character may not be the '.' character. Consecutive '.' characters are not allowed. Numbers are not allowed as the first character or immediately after a period.
+
+Template currently only supports Field or Dataset.
+
+## Examples
+
+Initialize the PowerApps Component Framework for a Field component
+
+```sh
+m365 pa pcf init --namespace yourNamespace --name yourCustomFieldComponent --template Field
+```
+
+Initialize the PowerApps Component Framework for a Dataset component
+
+```sh
+m365 pa pcf init --namespace yourNamespace --name yourCustomFieldComponent --template Dataset
+```
+
+## Response
+
+The response is a custom message which will show the location where the component framework has been created and a message to remind you to run `npm install` in the directory.
+
+## More information
+
+- Create and build a custom component: [https://docs.microsoft.com/en-us/powerapps/developer/component-framework/create-custom-controls-using-pcf](https://docs.microsoft.com/en-us/powerapps/developer/component-framework/create-custom-controls-using-pcf)