@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.9.0-beta.1cd2525

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

@@ -0,0 +1,384 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp environment list
+
+Lists Microsoft Power Platform environments
+
+## Usage
+
+```sh
+m365 pp environment list [options]
+```
+
+## Options
+
+```md definition-list
+`--asAdmin`
+: Run the command as admin and retrieve all environments. Lists only environments you have explicitly are assigned permissions to by default.
+```
+
+<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.
+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
+
+```sh
+m365 pp environment list
+```
+
+List all Microsoft Power Platform environments
+
+```sh
+m365 pp environment list --asAdmin
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "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)"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  displayName                             name
+  --------------------------------------- --------------------------------------------
+  environmentName (default) (org6633050c) Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,displayName
+  Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d,contoso (default)
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pp environment list
+
+  Date: 9/1/2023
+
+  ## environmentName (default) (/providers/Microsoft.BusinessAppPlatform/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d)
+
+  Property | Value
+  ---------|-------
+  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)
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/pp/gateway/gateway-get.mdx

@@ -0,0 +1,89 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp gateway get
+
+Get information about the specified gateway
+
+## Usage
+
+```sh
+m365 pp gateway get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the Gateway.
+```
+
+<Global />
+
+## Examples
+
+Get information about the specified gateway.
+
+```sh
+m365 pp gateway get --id 1f69e798-5852-4fdd-ab01-33bb14b6e934
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id":"22660b34-31b3-4744-a99c-5e154458a784",
+    "gatewayId":0,
+    "name":"Contoso Gateway",
+    "type":"Resource",
+    "publicKey":{
+      "exponent":"AQAB",
+      "modulus":"okJBN8MJyaVkjfkN75B6OgP7RYiC3KFMFaky9KqqudqiTOcZPRXlsG+emrbnnBpFzw7ywe4gWtUGnPCqy01RKeDZrFA3QfkVPJpH28OWfrmgkMQNsI4Op2uxwEyjnJAyfYxIsHlpevOZoDKpWJgV+sH6MRf/+LK4hN3vNJuWKKpf90rNwjipnYMumHyKVkd4Vssc9Ftsu4Samu0/TkXzUkyje5DxMF2ZK1Nt2TgItBcpKi4wLCP4bPDYYaa9vfOmBlji7U+gwuE5bjnmjazFljQ5sOP0VdA0fRoId3+nI7n1rSgRq265jNHX84HZbm2D/Pk8C0dElTmYEswGPDWEJQ=="
+    },
+    "gatewayAnnotation":"{\"gatewayContactInformation\":[\"admin@contoso.onmicrosoft.com\"],\"gatewayVersion\":\"3000.122.8\",\"gatewayWitnessString\":\"{\\\"EncryptedResult\\\":\\\"UyfEqNSy0e9S4D0m9oacPyYhgiXLWusCiKepoLudnTEe68iw9qEaV6qNqTbSKlVUwUkD9KjbnbV0O3vU97Q/KTJXpw9/1SiyhpO+JN1rcaL51mPjyQo0WwMHMo2PU3rdEyxsLjkJxJZHTh4+XGB/lQ==\\\",\\\"IV\\\":\\\"QxCYjHEl8Ab9i78ZBYpnDw==\\\",\\\"Signature\\\":\\\"upVXK3DvWdj5scw8iUDDilzQz1ovuNgeuXRpmf0N828=\\\"}\",\"gatewayMachine\":\"SPFxDevelop\",\"gatewaySalt\":\"rA1M34AdgdCbOYQMvo/izA==\",\"gatewayWitnessStringLegacy\":null,\"gatewaySaltLegacy\":null,\"gatewayDepartment\":null,\"gatewayVirtualNetworkSubnetId\":null}"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id  : 22660b34-31b3-4744-a99c-5e154458a784    
+  name: Contoso Gateway 
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name
+  22660b34-31b3-4744-a99c-5e154458a784,Contoso Gateway
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pp gateway get --id 22660b34-31b3-4744-a99c-5e154458a784
+
+  Date: 9/1/2023
+
+  ## Contoso Gateway (22660b34-31b3-4744-a99c-5e154458a784)
+  
+  Property | Value
+  ---------|-------
+  id | 22660b34-31b3-4744-a99c-5e154458a784
+  gatewayId | 0
+  name | Contoso Gateway
+  type | Resource
+  publicKey | {"exponent":"AQAB","modulus":"okJBN8MJyaVkjfkN75B6OgP7RYiC3KFMFaky9KqqudqiTOcZPRXlsG+emrbnnBpFzw7ywe4gWtUGnPCqy01RKeDZrFA3QfkVPJpH28OWfrmgkMQNsI4Op2uxwEyjnJAyfYxIsHlpevOZoDKpWJgV+sH6MRf/+LK4hN3vNJuWKKpf90rNwjipnYMumHyKVkd4Vssc9Ftsu4Samu0/TkXzUkyje5DxMF2ZK1Nt2TgItBcpKi4wLCP4bPDYYaa9vfOmBlji7U+gwuE5bjnmjazFljQ5sOP0VdA0fRoId3+nI7n1rSgRq265jNHX84HZbm2D/Pk8C0dElTmYEswGPDWEJQ=="}
+  gatewayAnnotation | {\"gatewayContactInformation\":[\"admin@contoso.onmicrosoft.com\"],\"gatewayVersion\":\"3000.122.8\",\"gatewayWitnessString\":\"{\\\"EncryptedResult\\\":\\\"UyfEqNSy0e9S4D0m9oacPyYhgiXLWusCiKepoLudnTEe68iw9qEaV6qNqTbSKlVUwUkD9KjbnbV0O3vU97Q/KTJXpw9/1SiyhpO+JN1rcaL51mPjyQo0WwMHMo2PU3rdEyxsLjkJxJZHTh4+XGB/lQ==\\\",\\\"IV\\\":\\\"QxCYjHEl8Ab9i78ZBYpnDw==\\\",\\\"Signature\\\":\\\"upVXK3DvWdj5scw8iUDDilzQz1ovuNgeuXRpmf0N828=\\\"}\",\"gatewayMachine\":\"SPFxDevelop\",\"gatewaySalt\":\"rA1M34AdgdCbOYQMvo/izA==\",\"gatewayWitnessStringLegacy\":null,\"gatewaySaltLegacy\":null,\"gatewayDepartment\":null,\"gatewayVirtualNetworkSubnetId\":null}
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/pp/gateway/gateway-list.mdx

@@ -0,0 +1,87 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp gateway list
+
+Returns a list of gateways for which the user is an admin
+
+## Usage
+
+```sh
+m365 pp gateway list [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+List gateways for which the user is an admin
+
+```sh
+m365 pp gateway list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id":"22660b34-31b3-4744-a99c-5e154458a784",
+      "gatewayId":0,
+      "name":"Contoso Gateway",
+      "type":"Resource",
+      "publicKey":{
+        "exponent":"AQAB",
+        "modulus":"okJBN8MJyaVkjfkN75B6OgP7RYiC3KFMFaky9KqqudqiTOcZPRXlsG+emrbnnBpFzw7ywe4gWtUGnPCqy01RKeDZrFA3QfkVPJpH28OWfrmgkMQNsI4Op2uxwEyjnJAyfYxIsHlpevOZoDKpWJgV+sH6MRf/+LK4hN3vNJuWKKpf90rNwjipnYMumHyKVkd4Vssc9Ftsu4Samu0/TkXzUkyje5DxMF2ZK1Nt2TgItBcpKi4wLCP4bPDYYaa9vfOmBlji7U+gwuE5bjnmjazFljQ5sOP0VdA0fRoId3+nI7n1rSgRq265jNHX84HZbm2D/Pk8C0dElTmYEswGPDWEJQ=="
+      },
+      "gatewayAnnotation":"{\"gatewayContactInformation\":[\"admin@contoso.onmicrosoft.com\"],\"gatewayVersion\":\"3000.122.8\",\"gatewayWitnessString\":\"{\\\"EncryptedResult\\\":\\\"UyfEqNSy0e9S4D0m9oacPyYhgiXLWusCiKepoLudnTEe68iw9qEaV6qNqTbSKlVUwUkD9KjbnbV0O3vU97Q/KTJXpw9/1SiyhpO+JN1rcaL51mPjyQo0WwMHMo2PU3rdEyxsLjkJxJZHTh4+XGB/lQ==\\\",\\\"IV\\\":\\\"QxCYjHEl8Ab9i78ZBYpnDw==\\\",\\\"Signature\\\":\\\"upVXK3DvWdj5scw8iUDDilzQz1ovuNgeuXRpmf0N828=\\\"}\",\"gatewayMachine\":\"SPFxDevelop\",\"gatewaySalt\":\"rA1M34AdgdCbOYQMvo/izA==\",\"gatewayWitnessStringLegacy\":null,\"gatewaySaltLegacy\":null,\"gatewayDepartment\":null,\"gatewayVirtualNetworkSubnetId\":null}"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                   name
+  ------------------------------------ ---------------
+  22660b34-31b3-4744-a99c-5e154458a784 Contoso Gateway
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name
+  22660b34-31b3-4744-a99c-5e154458a784,Contoso Gateway
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pp gateway list
+
+  Date: 9/1/2023
+
+  ## Contoso Gateway (22660b34-31b3-4744-a99c-5e154458a784)
+  
+  Property | Value
+  ---------|-------
+  id | 22660b34-31b3-4744-a99c-5e154458a784
+  gatewayId | 0
+  name | Contoso Gateway
+  type | Resource
+  publicKey | {"exponent":"AQAB","modulus":"okJBN8MJyaVkjfkN75B6OgP7RYiC3KFMFaky9KqqudqiTOcZPRXlsG+emrbnnBpFzw7ywe4gWtUGnPCqy01RKeDZrFA3QfkVPJpH28OWfrmgkMQNsI4Op2uxwEyjnJAyfYxIsHlpevOZoDKpWJgV+sH6MRf/+LK4hN3vNJuWKKpf90rNwjipnYMumHyKVkd4Vssc9Ftsu4Samu0/TkXzUkyje5DxMF2ZK1Nt2TgItBcpKi4wLCP4bPDYYaa9vfOmBlji7U+gwuE5bjnmjazFljQ5sOP0VdA0fRoId3+nI7n1rSgRq265jNHX84HZbm2D/Pk8C0dElTmYEswGPDWEJQ=="}
+  gatewayAnnotation | {\"gatewayContactInformation\":[\"admin@contoso.onmicrosoft.com\"],\"gatewayVersion\":\"3000.122.8\",\"gatewayWitnessString\":\"{\\\"EncryptedResult\\\":\\\"UyfEqNSy0e9S4D0m9oacPyYhgiXLWusCiKepoLudnTEe68iw9qEaV6qNqTbSKlVUwUkD9KjbnbV0O3vU97Q/KTJXpw9/1SiyhpO+JN1rcaL51mPjyQo0WwMHMo2PU3rdEyxsLjkJxJZHTh4+XGB/lQ==\\\",\\\"IV\\\":\\\"QxCYjHEl8Ab9i78ZBYpnDw==\\\",\\\"Signature\\\":\\\"upVXK3DvWdj5scw8iUDDilzQz1ovuNgeuXRpmf0N828=\\\"}\",\"gatewayMachine\":\"SPFxDevelop\",\"gatewaySalt\":\"rA1M34AdgdCbOYQMvo/izA==\",\"gatewayWitnessStringLegacy\":null,\"gatewaySaltLegacy\":null,\"gatewayDepartment\":null,\"gatewayVirtualNetworkSubnetId\":null}
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/pp/managementapp/managementapp-add.mdx

@@ -0,0 +1,99 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp managementapp add
+
+Register management application for Power Platform
+
+## Usage
+
+```sh
+m365 pp managementapp add [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Application (client) ID of the Azure AD application registration to register as a management app. Specify either `appId`, `objectId` or `name`
+
+`--objectId [objectId]`
+: Object ID of the Azure AD application registration to register as a management app. Specify either `appId`, `objectId` or `name`
+
+`--name [name]`
+: Name of the Azure AD application registration to register as a management app. Specify either `appId`, `objectId` or `name`
+```
+
+<Global />
+
+## Remarks
+
+To execute this command the first time you'll need sign in using the Microsoft Azure PowerShell app registration. You can do this by executing `m365 login --appId 1950a258-227b-4e31-a9cf-717495945fc2`. To register the Azure AD app registration that CLI for Microsoft 365 uses by default, execute `m365 pp managementapp add--appId 31359c7f-bd7e-475c-86db-fdb8c937548e`.
+
+For best performance use the `appId` option to reference the Azure AD application registration to update. If you use `objectId` or `name`, this command will first need to find the corresponding `appId` for that application.
+
+If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
+
+## Examples
+
+Register CLI for Microsoft 365 as a management application for the Power Platform
+
+```sh
+m365 pp managementapp add --appId 31359c7f-bd7e-475c-86db-fdb8c937548e
+```
+
+Register Azure AD application with the specified object ID as a management application for the Power Platform
+
+```sh
+m365 pp managementapp add --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Register Azure AD application named _My app_ as a management application for the Power Platform
+
+```sh
+m365 pp managementapp add --name "My app"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "applicationId":"31359c7f-bd7e-475c-86db-fdb8c937548e"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  applicationId: 31359c7f-bd7e-475c-86db-fdb8c937548e
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  applicationId
+  31359c7f-bd7e-475c-86db-fdb8c937548e
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pp managementapp add --appId "31359c7f-bd7e-475c-86db-fdb8c937548e"
+
+  Date: 9/1/2023
+
+  Property | Value
+  ---------|-------
+  applicationId | 31359c7f-bd7e-475c-86db-fdb8c937548e
+  ```
+
+  </TabItem>
+</Tabs>
+