@pnp/cli-microsoft365 7.1.0-beta.aca68bd → 7.1.0-beta.ba486fa

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

@@ -32,13 +32,13 @@ Register CLI for Microsoft 365 or Azure AD application as a management applicati
 
 ## Examples
 
-List Microsoft Power Platform environments
+List Microsoft Power Platform environments.
 
 ```sh
 m365 pp environment list
 ```
 
-List all Microsoft Power Platform environments
+List all Microsoft Power Platform environments.
 
 ```sh
 m365 pp environment list --asAdmin
@@ -375,10 +375,8 @@ m365 pp environment list --asAdmin
   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

@@ -80,10 +80,7 @@ m365 pp gateway get --id 1f69e798-5852-4fdd-ab01-33bb14b6e934
   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

@@ -18,7 +18,7 @@ m365 pp gateway list [options]
 
 ## Examples
 
-List gateways for which the user is an admin
+List gateways for which the user is an admin.
 
 ```sh
 m365 pp gateway list
@@ -78,10 +78,7 @@ m365 pp gateway list
   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/purview/auditlog/auditlog-list.mdx

@@ -143,3 +143,7 @@ m365 purview auditlog list --contentType SharePoint --startTime "2023-01-01T00:0
   </TabItem>
 </Tabs>
 
+## More information
+
+- Explanation of all available audit log activities/operations: https://learn.microsoft.com/en-us/purview/audit-log-activities
+- Explanation of all available audit log properties: https://learn.microsoft.com/en-us/purview/audit-log-detailed-properties

package/docs/docs/cmd/purview/retentionevent/retentionevent-add.mdx

@@ -16,7 +16,7 @@ m365 purview retentionevent add [options]
 
 ```md definition-list
 `-n, --displayName <displayName>`
-: The display name of the event
+: The display name of the event.
 
 `-e, --eventTypeName [eventTypeName]`
 : Name of the event type associated with the event. Specify either `eventTypeId` or `eventTypeName` but not both.
@@ -25,7 +25,7 @@ m365 purview retentionevent add [options]
 : Id of the event type associated with the event. Specify either `eventTypeId` or `eventTypeName` but not both.
 
 `-d, --description [description]`
-: A description for the event
+: A description for the event.
 
 `--triggerDateTime [triggerDateTime]`
 : Optional time when the event should be triggered.
@@ -49,7 +49,7 @@ This command is based on an API that is currently in preview and is subject to c
 
 ## Examples
 
-Create a retention event to start retention at the end of 2022 for all employee documents that have been labeled and have the Asset ID _EmployeeNr1234_
+Create a retention event to start retention at the end of 2022 for all employee documents that have been labeled and have the Asset ID _EmployeeNr1234_.
 
 ```sh
 m365 purview retentionevent add --displayName 'Employee information expiration' --description 'Employee documents expired due to offboarding' --eventTypeName 'CustomRetentionTime' --triggerDateTime '2022-12-31' --assetIds 'ComplianceAssetId:EmployeeNr1234'
@@ -144,11 +144,6 @@ m365 purview retentionevent add --displayName 'Employee information expiration'
   createdDateTime | 2023-02-20T18:53:05Z
   lastModifiedDateTime | 2023-02-20T18:53:05Z
   id | 9f5c1a04-8f7a-4bff-e400-08db1373b324
-  eventQueries | [{"queryType":"files","query":"filesQuery,filesQuery1"},{"queryType":"messages","query":"messagesQuery,messagesQuery1"}]
-  eventStatus | {"error":null,"status":"pending"}
-  eventPropagationResults | []
-  createdBy | {"user":{"id":null,"displayName":"John Doe"}}
-  lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
   ```
 
   </TabItem>

package/docs/docs/cmd/purview/retentionevent/retentionevent-get.mdx

@@ -23,7 +23,7 @@ m365 purview retentionevent get [options]
 
 ## Examples
 
-Get a retention event by id
+Get a retention event by id.
 
 ```sh
 m365 purview retentionevent get --id c37d695e-d581-4ae9-82a0-9364eba4291e
@@ -130,8 +130,6 @@ This command is based on an API that is currently in preview and is subject to c
   createdDateTime | 2023-02-01T09:17:40Z
   lastModifiedDateTime | 2023-02-01T09:17:40Z
   id | c37d695e-d581-4ae9-82a0-9364eba4291e
-  createdBy | {"user":{"id":null,"displayName":"John Doe"}}
-  lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
   ```
 
   </TabItem>

package/docs/docs/cmd/purview/retentionevent/retentionevent-list.mdx

@@ -18,7 +18,7 @@ m365 purview retentionevent list [options]
 
 ## Examples
 
-Get a list of retention events
+Get a list of retention events.
 
 ```sh
 m365 purview retentionevent list
@@ -103,10 +103,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
   createdDateTime | 2023-02-03T13:51:40Z
   lastModifiedDateTime | 2023-02-03T13:51:40Z
   id | 7248cfa8-c03a-4ec1-49a4-08db05edc686
-  eventQueries | []
-  eventPropagationResults | []
-  createdBy | {"user":{"id":null,"displayName":"John Doe"}}
-  lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
   ```
 
   </TabItem>

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-add.mdx

@@ -107,8 +107,6 @@ m365 purview retentioneventtype add --displayName 'Contract Expiry' --descriptio
   createdDateTime | 2023-01-31T20:55:35Z
   lastModifiedDateTime | 2023-01-31T20:55:35Z
   id | ca0e1f8d-4e42-4a81-be85-022502d70c4e
-  createdBy | {"user":{"id":null,"displayName":"John Doe"}}
-  lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
   ```
 
   </TabItem>

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-get.mdx

@@ -31,7 +31,7 @@ This command is based on an API that is currently in preview and is subject to c
 
 ## Examples
 
-Get a retention event type by id
+Get a retention event type by id.
 
 ```sh
 m365 purview retentioneventtype get --id c37d695e-d581-4ae9-82a0-9364eba4291e
@@ -102,8 +102,6 @@ m365 purview retentioneventtype get --id c37d695e-d581-4ae9-82a0-9364eba4291e
   createdDateTime | 2023-01-29T09:30:42Z
   lastModifiedDateTime | 2023-01-29T09:30:42Z
   id | c37d695e-d581-4ae9-82a0-9364eba4291e
-  createdBy | {"user":{"id":null,"displayName":"John Doe"}}
-  lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
   ```
 
   </TabItem>

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-list.mdx

@@ -26,7 +26,7 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 ## Examples
 
-Get a list of retention event types
+Get a list of retention event types.
 
 ```sh
 m365 purview retentioneventtype list
@@ -96,8 +96,6 @@ m365 purview retentioneventtype list
   createdDateTime | 2023-02-02T15:47:54Z
   lastModifiedDateTime | 2023-02-02T15:47:54Z
   id | 81fa91bd-66cd-4c6c-b0cb-71f37210dc74
-  createdBy | {"user":{"id":"36155f4e-bdbd-4101-ba20-5e78f5fba9a9","displayName":null}}
-  lastModifiedBy | {"user":{"id":"36155f4e-bdbd-4101-ba20-5e78f5fba9a9","displayName":null}}
   ```
 
   </TabItem>

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-get.mdx

@@ -41,22 +41,21 @@ When operating in app-only mode, you have the option to use either the `userName
 
 :::
 
-
 ## Examples
 
-Get a sensitivity label
+Get a sensitivity label.
 
 ```sh
 m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e
 ```
 
-Get a sensitivity label that a specific user has access to by its Id
+Get a sensitivity label that a specific user has access to by its Id.
 
 ```sh
 m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e --userId 59f80e08-24b1-41f8-8586-16765fd830d3
 ```
 
-Get a sensitivity label that a specific user has access to by its UPN
+Get a sensitivity label that a specific user has access to by its UPN.
 
 ```sh
 m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e --userName john.doe@contoso.com
@@ -129,10 +128,8 @@ m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e --us
   tooltip | Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
   isActive | true
   isAppliable | true
-  contentFormats | ["file","email"]
   hasProtection | false
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-list.mdx

@@ -40,19 +40,19 @@ When operating in app-only mode, you have the option to use either the `userName
 
 ## Examples
 
-Get a list of sensitivity labels
+Get a list of sensitivity labels.
 
 ```sh
 m365 purview sensitivitylabel list
 ```
 
-Get a list of sensitivity labels that a specific user has access to by its Id
+Get a list of sensitivity labels that a specific user has access to by its Id.
 
 ```sh
 m365 purview sensitivitylabel list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
 ```
 
-Get a list of sensitivity labels that a specific user has access to by its UPN
+Get a list of sensitivity labels that a specific user has access to by its UPN.
 
 ```sh
 m365 purview sensitivitylabel list --userName john.doe@contoso.com
@@ -121,11 +121,9 @@ m365 purview sensitivitylabel list --userName john.doe@contoso.com
   tooltip | Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
   isActive | true
   isAppliable | true
-  contentFormats | ["file","email"]
   hasProtection | false
   parent | null
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/purview/threatassessment/threatassessment-get.mdx

@@ -16,23 +16,23 @@ m365 purview threatassessment get [options]
 
 ```md definition-list
 `-i, --id <id>`
-: The Id of the threat assessment
+: The Id of the threat assessment.
 
 `--includeResults`
-: Include the threat assessment results
+: Include the threat assessment results.
 ```
 
 <Global />
 
 ## Examples
 
-Get a threat assessment
+Get a threat assessment.
 
 ```sh
 m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 ```
 
-Get a threat assessment including results
+Get a threat assessment including results.
 
 ```sh
 m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --includeResults
@@ -113,7 +113,6 @@ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --in
   recipientEmail | john@contoso.com
   destinationRoutingReason | notJunk
   messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
-  createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
   ```
 
   </TabItem>
@@ -203,10 +202,7 @@ When we make use of the option `includeResults` the response will differ.
   recipientEmail | john@contoso.com
   destinationRoutingReason | notJunk
   messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
-  createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
-  results | [{"id":"a5455871-18d1-44d8-0866-08db16c68b85","createdDateTime":"2023-02-25T00:23:40.28Z","resultType":"checkPolicy","message":"No policy was hit."}]
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/spo/app/app-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo app add
 
@@ -14,16 +16,16 @@ m365 spo app add [options]
 
 ```md definition-list
 `-p, --filePath <filePath>`
-: Absolute or relative path to the solution package file to add to the app catalog
+: Absolute or relative path to the solution package file to add to the app catalog.
 
 `--overwrite`
-: Set to overwrite the existing package file
+: Set to overwrite the existing package file.
 
 `-s, --appCatalogScope [appCatalogScope]`
-: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+: Scope of the app catalog. Allowed values: `tenant`, `sitecollection`. Defaults to `tenant`.
 
 `-u, --appCatalogUrl [appCatalogUrl]`
-: The URL of the app catalog where the solution package will be added. It must be specified when the scope is `sitecollection`
+: The URL of the app catalog where the solution package will be added. It must be specified when the scope is `sitecollection`.
 ```
 
 <Global />
@@ -40,24 +42,109 @@ If you try to upload a package that already exists in the app catalog without sp
 
 ## Examples
 
-Add the _spfx.sppkg_ package to the tenant app catalog
+Add the package to the tenant app catalog.
 
 ```sh
 m365 spo app add --filePath /Users/pnp/spfx/sharepoint/solution/spfx.sppkg
 ```
 
-Overwrite the _spfx.sppkg_ package in the tenant app catalog with the newer version
+Overwrite the package in the tenant app catalog with the newer version.
 
 ```sh
 m365 spo app add --filePath sharepoint/solution/spfx.sppkg --overwrite
 ```
 
-Add the _spfx.sppkg_ package to the site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_
+Add the package to the site collection app catalog of the specified site.
 
 ```sh
 m365 spo app add --filePath c:\spfx.sppkg --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1
 ```
 
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "CheckInComment": "",
+    "CheckOutType": 2,
+    "ContentTag": "{4BBC7873-4638-487D-900B-EF917A907C5A},2,1",
+    "CustomizedPageStatus": 0,
+    "ETag": "\"{4BBC7873-4638-487D-900B-EF917A907C5A},2\"",
+    "Exists": true,
+    "ExistsAllowThrowForPolicyFailures": true,
+    "IrmEnabled": false,
+    "Length": "757211",
+    "Level": 1,
+    "LinkingUri": null,
+    "LinkingUrl": "",
+    "MajorVersion": 1,
+    "MinorVersion": 0,
+    "Name": "spfx.sppkg",
+    "ServerRelativeUrl": "/sites/apps/AppCatalog/spfx.sppkg",
+    "TimeCreated": "2023-10-02T06:53:30Z",
+    "TimeLastModified": "2023-10-02T06:53:30Z",
+    "Title": "spfx-client-side-solution",
+    "UIVersion": 512,
+    "UIVersionLabel": "1.0",
+    "UniqueId": "4bbc7873-4638-487d-900b-ef917a907c5a"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  e0f53330-61ec-4fee-882d-fadfb74b2033
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,ExistsAllowThrowForPolicyFailures,IrmEnabled,Length,Level,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
+  ,2,"{B9BCE524-2940-457B-A015-30CBAAB4C210},2,1",0,"""{B9BCE524-2940-457B-A015-30CBAAB4C210},2""",1,1,,757211,1,,1,0,spfx.sppkg,/sites/apps/AppCatalog/spfx.sppkg,2023-10-02T06:55:12Z,2023-10-02T06:55:12Z,spfx-client-side-solution,512,1.0,b9bce524-2940-457b-a015-30cbaab4c210
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo app add --filePath "C:\SPFx\sharepoint\solution\spfx.sppkg"
+
+  Date: 10/2/2023
+
+  ## spfx-client-side-solution (b05196d4-65a3-4ee3-bf92-4acfb7a05cd7)
+
+  Property | Value
+  ---------|-------
+  CheckInComment |
+  CheckOutType | 2
+  ContentTag | {B05196D4-65A3-4EE3-BF92-4ACFB7A05CD7},2,1
+  CustomizedPageStatus | 0
+  ETag | "{B05196D4-65A3-4EE3-BF92-4ACFB7A05CD7},2"
+  Exists | true
+  ExistsAllowThrowForPolicyFailures | true
+  IrmEnabled | false
+  Length | 757211
+  Level | 1
+  LinkingUrl |
+  MajorVersion | 1
+  MinorVersion | 0
+  Name | spfx.sppkg
+  ServerRelativeUrl | /sites/apps/AppCatalog/spfx.sppkg
+  TimeCreated | 2023-10-02T06:56:02Z
+  TimeLastModified | 2023-10-02T06:56:02Z
+  Title | spfx-client-side-solution
+  UIVersion | 512
+  UIVersionLabel | 1.0
+  UniqueId | b05196d4-65a3-4ee3-bf92-4acfb7a05cd7
+  ```
+
+  </TabItem>
+</Tabs>
+
 ## More information
 
 - Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-deploy.mdx

@@ -14,19 +14,19 @@ m365 spo app deploy [options]
 
 ```md definition-list
 `-i, --id [id]`
-: ID of the app to deploy. Specify the `id` or the `name` but not both
+: ID of the app to deploy. Specify the `id` or the `name` but not both.
 
 `-n, --name [name]`
-: Name of the app to deploy. Specify the `id` or the `name` but not both
+: Name of the app to deploy. Specify the `id` or the `name` but not both.
 
 `-u, --appCatalogUrl [appCatalogUrl]`
-: URL of the tenant or site collection app catalog. It must be specified when the scope is `sitecollection`
+: URL of the tenant or site collection app catalog. It must be specified when the scope is `sitecollection`.
 
 `--skipFeatureDeployment`
-: If the app supports tenant-wide deployment, deploy it to the whole tenant
+: If the app supports tenant-wide deployment, deploy it to the whole tenant.
 
 `-s, --appCatalogScope [appCatalogScope]`
-: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+: Scope of the app catalog. Allowed values: `tenant`, `sitecollection`. Defaults to `tenant`.
 ```
 
 <Global />
@@ -47,7 +47,7 @@ Deploy the specified app in the tenant app catalog. Try to resolve the URL of th
 m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3
 ```
 
-Deploy the specified app in the site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_
+Deploy the specified app in the site collection app catalog of the specified site.
 
 ```sh
 m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1
@@ -59,7 +59,7 @@ Deploy the app with the specified name in the tenant app catalog. Try to resolve
 m365 spo app deploy --name solution.sppkg
 ```
 
-Deploy the specified app in the tenant app catalog located at _https://contoso.sharepoint.com/sites/apps_
+Deploy the specified app in the tenant app catalog.
 
 ```sh
 m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl https://contoso.sharepoint.com/sites/apps
@@ -71,6 +71,10 @@ Deploy the specified app to the whole tenant at once. Features included in the s
 m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --skipFeatureDeployment
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)