@pnp/cli-microsoft365 6.0.0 → 6.1.0-beta.17b053d

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-list.md

@@ -0,0 +1,90 @@
+# pp dataverse table row list
+
+Lists table rows for the given Dataverse table
+
+## Usage
+
+```sh
+pp dataverse table row list [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment
+
+`--entitySetName [entitySetName]`
+: The entity set name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--tableName [tableName]`
+: The name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all table rows for the given environment based on the entity set name
+
+```sh
+m365 pp dataverse table row list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --entitySetName "cr6c3_accounts"
+```
+
+List all table rows for the given environment based on the table name
+
+```sh
+m365 pp dataverse table row list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "cr6c3_account"
+```
+
+List all table rows for the given environment based on the entity set name as Admin
+
+```sh
+m365 pp dataverse table row list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --entitySetName "cr6c3_accounts" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "cr6c3_accountsid": "95c80273-3764-ed11-9561-000d3a4bbea4",
+        "_owningbusinessunit_value": "6da087c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "statecode": 0,
+        "statuscode": 1,
+        "_createdby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_ownerid_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "modifiedon": "2022-11-14T16:14:45Z",
+        "_owninguser_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_modifiedby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "versionnumber": 1413873,
+        "createdon": "2022-11-14T16:14:45Z",
+        "cr6c3_name": "Column1 value",
+        "overriddencreatedon": null,
+        "importsequencenumber": null,
+        "_modifiedonbehalfby_value": null,
+        "utcconversiontimezonecode": null,
+        "_createdonbehalfby_value": null,
+        "_owningteam_value": null,
+        "timezoneruleversionnumber": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    cr6c3_accountsid                       _owningbusinessunit_value             statecode  statuscode  _createdby_value                      _ownerid_value                        modifiedon            _owninguser_value                     _modifiedby_value                     versionnumber  createdon             cr6c3_name      overriddencreatedon  importsequencenumber  _modifiedonbehalfby_value  utcconversiontimezonecode  _createdonbehalfby_value  _owningteam_value  timezoneruleversionnumber
+    ------------------------------------  ------------------------------------  ---------  ----------  ------------------------------------  ------------------------------------  --------------------  ------------------------------------  ------------------------------------  -------------  --------------------  ----------      -------------------  --------------------  -------------------------  -------------------------  ------------------------  -----------------  -------------------------
+    95c80273-3764-ed11-9561-000d3a4bbea4  6da087c1-1c4d-ed11-bba1-000d3a2caf7f  0          1           5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  2022-11-14T16:14:45Z  5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  1413873        2022-11-14T16:14:45Z  Column1 value   null                 null                  null                       null                       null                      null               null
+    ```
+
+=== "CSV"
+
+    ```csv
+    cr6c3_accountsid,_owningbusinessunit_value,statecode,statuscode,_createdby_value,_ownerid_value,modifiedon,_owninguser_value,_modifiedby_value,versionnumber,createdon,cr6c3_name,overriddencreatedon,importsequencenumber,_modifiedonbehalfby_value,utcconversiontimezonecode,_createdonbehalfby_value,_owningteam_value,timezoneruleversionnumber
+    95c80273-3764-ed11-9561-000d3a4bbea4,6da087c1-1c4d-ed11-bba1-000d3a2caf7f,0,1,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,2022-11-14T16:14:45Z,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,1413873,2022-11-14T16:14:45Z,Column1 value,,,,,,,
+    ```

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-remove.md

@@ -0,0 +1,61 @@
+# pp dataverse table row remove
+
+Removes a row from a dataverse table in a given environment.
+
+## Usage
+
+```sh
+pp dataverse table row remove [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment to remove a row from a table from.
+
+`-i, --id <id>`
+: The id of the row to remove.
+
+`--entitySetName [entitySetName]`
+: The entity set name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--tableName [tableName]`
+: The name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--confirm`
+: Don't prompt for confirmation
+
+`--asAdmin`
+: Set, to remove the row from the dataverse table as admin for environments you are not a member of.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a row from a dataverse table in a given environment
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4"
+```
+
+Removes a row from a dataverse table in a given environment as Admin
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --asAdmin
+```
+
+Removes a row from a dataverse table in a given environment without prompting for confirmation
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --confirm
+```
+
+Removes a row from a dataverse table in a given environment based on the entity set name without prompting for confirmation
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --entitySetName "cr6c3_accounts" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/environment/environment-get.md

@@ -16,6 +16,8 @@ m365 pp environment get [options]
 `--asAdmin`
 : Run the command as admin and retrieve details of environments you do not have explicitly assigned permissions to
 
+--8<-- "docs/cmd/_global.md"
+
 ## Remarks
 
 !!! attention

package/docs/docs/cmd/pp/solution/solution-publisher-add.md

@@ -0,0 +1,49 @@
+# pp solution publisher add
+
+Adds a specified publisher in a given environment
+
+## Usage
+
+```sh
+m365 pp solution publisher add [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-n, --name <name>`
+: The unique name of the publisher.
+
+`--displayName <displayName>`
+: The friendly name of the publisher.
+
+`--prefix <prefix>`
+: The prefix of the publisher.
+
+`--choiceValuePrefix <choiceValuePrefix>`
+: The choice value prefix of the publisher.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Add a specific publisher in a specific environment
+
+```sh
+m365 pp solution publisher add --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "Contoso" --displayName "Contoso" --prefix "new" --choiceValuePrefix 10000
+```
+
+Adds a specific publisher in a specific environment as Admin
+
+```sh
+m365 pp solution publisher add --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "Contoso" --displayName "Contoso" --prefix "new" --choiceValuePrefix 10000 --asAdmin
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/solution/solution-publisher-remove.md

@@ -1,4 +1,4 @@
-# solution remove
+# pp solution publisher remove
 
 Removes the specified publisher in the specified Power Platform environment
 

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-list.md

@@ -0,0 +1,81 @@
+# purview retentionlabel list
+
+Get a list of retention labels
+
+## Usage
+
+```sh
+m365 purview retentionlabel list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a list of retention labels
+
+```sh
+m365 purview retentionlabel list
+```
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+## Response
+
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "displayName": "Some label",
+        "descriptionForAdmins": "",
+        "descriptionForUsers": null,
+        "isInUse": true,
+        "retentionTrigger": "dateCreated",
+        "behaviorDuringRetentionPeriod": "retainAsRecord",
+        "actionAfterRetentionPeriod": "delete",
+        "createdDateTime": "2022-11-03T10:28:15Z",
+        "lastModifiedDateTime": "2022-11-03T10:28:15Z",
+        "labelToBeApplied": null,
+        "defaultRecordBehavior": "startLocked",
+        "id": "dc67203a-6cca-4066-b501-903401308f98",
+        "retentionDuration": {
+          "days": 365
+        },
+        "createdBy": {
+          "user": {
+            "id": "b52ffd35-d6fe-4b70-86d8-91cc01d76333",
+            "displayName": null
+          }
+        },
+        "lastModifiedBy": {
+          "user": {
+            "id": "b52ffd35-d6fe-4b70-86d8-91cc01d76333",
+            "displayName": null
+          }
+        },
+        "dispositionReviewStages": []
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                    displayName     isInUse
+    ------------------------------------  --------------  --------
+    dc67203a-6cca-4066-b501-903401308f98  Some label      true
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,displayName,isInUse
+    dc67203a-6cca-4066-b501-903401308f98,Some label,true
+    ```

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-remove.md

@@ -0,0 +1,36 @@
+# purview retentionlabel remove
+
+Delete a retention label
+
+## Usage
+
+```sh
+m365 purview retentionlabel remove [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the retention label.
+
+`--confirm`
+: Don't prompt for confirming to remove the label.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Delete a retention label
+
+```sh
+m365 purview retentionlabel remove --id 'e554d69c-0992-4f9b-8a66-fca3c4d9c531'
+```
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/search/externalconnection/externalconnection-add.md

@@ -41,3 +41,7 @@ Adds a new external connection with a limited number of authorized apps
 ```sh
 m365 search externalconnection add --id MyApp --name "Test" --description "Test" --authorizedAppIds  "00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002"
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/search/externalconnection/externalconnection-get.md

@@ -31,3 +31,41 @@ Get the External Connection by its name
 ```sh
 m365 search externalconnection get --name "Test"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "CLITest",
+      "name": "CLI-Test",
+      "description": "CLI Test",
+      "state": "draft",
+      "configuration": {
+        "authorizedApps": [
+          "31359c7f-bd7e-475c-86db-fdb8c937548e"
+        ],
+        "authorizedAppIds": [
+          "31359c7f-bd7e-475c-86db-fdb8c937548e"
+        ]
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    configuration: {"authorizedApps":["31359c7f-bd7e-475c-86db-fdb8c937548e"],"authorizedAppIds":["31359c7f-bd7e-475c-86db-fdb8c937548e"]}
+    description  : CLI Test
+    id           : CLITest
+    name         : CLI-Test
+    state        : draft
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name,description,state,configuration
+    CLITest,CLI-Test,CLI Test,draft,"{""authorizedApps"":[""31359c7f-bd7e-475c-86db-fdb8c937548e""],""authorizedAppIds"":[""31359c7f-bd7e-475c-86db-fdb8c937548e""]}"
+    ```

package/docs/docs/cmd/search/externalconnection/externalconnection-list.md

@@ -19,3 +19,41 @@ List external connections defined in Microsoft Search
 ```sh
 m365 search externalconnection list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "CLITest",
+        "name": "CLI-Test",
+        "description": "CLI Test",
+        "state": "draft",
+        "configuration": {
+          "authorizedApps": [
+            "31359c7f-bd7e-475c-86db-fdb8c937548e"
+          ],
+          "authorizedAppIds": [
+            "31359c7f-bd7e-475c-86db-fdb8c937548e"
+          ]
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id       name      state
+    -------  --------  -----
+    CLITest  CLI-Test  draft
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name,state
+    CLITest,CLI-Test,draft
+    ```

package/docs/docs/cmd/search/externalconnection/externalconnection-remove.md

@@ -38,3 +38,7 @@ Removes external connection with name _Test_. Will NOT prompt for confirmation b
 ```sh
 m365 search externalconnection remove --name "Test" --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spfx/project/project-upgrade.md

@@ -32,7 +32,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.16.0).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.16.1).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

package/docs/docs/cmd/spo/contenttype/contenttype-set.md

@@ -1,6 +1,6 @@
 # spo contenttype set
 
-Update existing content type
+Update an existing content type
 
 ## Usage
 
@@ -28,8 +28,16 @@ m365 spo contenttype set [options]
 `--listUrl [listUrl]`
 : URL of the list if you want to update a list content type. Specify either `listTitle`, `listId` or `listUrl`.
 
+`--updateChildren`
+: Specify if you want to push updates to child content types.
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! important "Updating child content types"
+    When specifying the `--updateChildren` flag, SharePoint will only propagate the changes that are made in the current request. If you want to know more about updating a content type and propagating changes to child content types, be sure to [read more here](https://learn.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ms442695(v=office.14)#considerations-when-updating-child-content-types). 
+
 ## Examples
 
 Move site content type to a different group
@@ -43,3 +51,9 @@ Rename list content type
 ```sh
 m365 spo contenttype set --name "My old item" --webUrl https://contoso.sharepoint.com --listTitle "My list" --Name "My item"
 ```
+
+Configure a form customizer with manifest ID _19890cce-15d8-4af9-bfcb-72da06d13ed8_ on a site content type and push changes to child content types.
+
+```sh
+m365 spo contenttype set --name "My content type" --webUrl https://contoso.sharepoint.com --DisplayFormClientSideComponentId "19890cce-15d8-4af9-bfcb-72da06d13ed8" --EditFormClientSideComponentId "19890cce-15d8-4af9-bfcb-72da06d13ed8" --NewFormClientSideComponentId "19890cce-15d8-4af9-bfcb-72da06d13ed8" --updateChildren
+```

package/docs/docs/cmd/spo/navigation/navigation-node-add.md

@@ -11,22 +11,22 @@ m365 spo navigation node add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: Absolute URL of the site to which navigation should be modified
+: Absolute URL of the site to which navigation should be modified.
 
 `-l, --location [location]`
-: Navigation type where the node should be added. Available options: `QuickLaunch`, `TopNavigationBar`
+: Navigation type where the node should be added. Available options: `QuickLaunch`, `TopNavigationBar`. Specify either `location` or `parentNodeId` but not both.
 
 `-t, --title <title>`
-: Navigation node title
+: Navigation node title.
 
 `--url <url>`
-: Navigation node URL
+: Navigation node URL.
 
 `--parentNodeId [parentNodeId]`
-: ID of the node below which the node should be added
+: ID of the node below which the node should be added. Specify either `location` or `parentNodeId` but not both.
 
 `--isExternal`
-: Set, if the navigation node points to an external URL
+: Set, if the navigation node points to an external URL.
 
 --8<-- "docs/cmd/_global.md"
 

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-permissionrequest-approve.md

@@ -16,9 +16,15 @@ m365 spo sp permissionrequest approve
 
 ## Options
 
-`-i, --id <id>`
+`-i, --id [id]`
 : ID of the permission request to approve
 
+`--all`
+: approve all pending permission requests
+
+`--resource [resource]`
+: The resource of the permissions requests to approve
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -30,8 +36,105 @@ The permission request you want to approve is denoted using its `ID`. You can re
 
 ## Examples
 
-Approve permission request with id _4dc4c043-25ee-40f2-81d3-b3bf63da7538_
+Approve permission request with id
 
 ```sh
 m365 spo serviceprincipal permissionrequest approve --id 4dc4c043-25ee-40f2-81d3-b3bf63da7538
 ```
+
+Approve all permission request
+
+```sh
+m365 spo serviceprincipal permissionrequest approve --all
+```
+
+Approve all permission request from a specific resource
+
+```sh
+m365 spo serviceprincipal permissionrequest approve --resource "Microsoft Graph"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientId": "90a2c08e-e786-4100-9ea9-36c261be6c0d",
+      "ConsentType": "AllPrincipals",
+      "IsDomainIsolated": false,
+      "ObjectId": "jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM",
+      "PackageName": null,
+      "Resource": "Microsoft Graph",
+      "ResourceId": "d6afc295-0a08-4777-a095-10bcb7e23903",
+      "Scope": "User.Read.All"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientId        : 90a2c08e-e786-4100-9ea9-36c261be6c0d
+    ConsentType     : AllPrincipals
+    IsDomainIsolated: false
+    ObjectId        : jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM
+    PackageName     : null
+    Resource        : Microsoft Graph
+    ResourceId      : d6afc295-0a08-4777-a095-10bcb7e23903
+    Scope           : User.Read.All
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    90a2c08e-e786-4100-9ea9-36c261be6c0d,AllPrincipals,,jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM,,Microsoft Graph,d6afc295-0a08-4777-a095-10bcb7e23903,User.Read.All
+    ```
+
+### `all`, `resource` response
+
+When we make use of the option `all` or `resource` the response will differ.
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "ClientId": "90a2c08e-e786-4100-9ea9-36c261be6c0d",
+        "ConsentType": "AllPrincipals",
+        "IsDomainIsolated": false,
+        "ObjectId": "jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM",
+        "PackageName": null,
+        "Resource": "Microsoft Graph",
+        "ResourceId": "d6afc295-0a08-4777-a095-10bcb7e23903",
+        "Scope": "User.Read.All"
+      },
+      {
+        "ClientId": "90a2c08e-e786-4100-9ea9-36c261be6c0d",
+        "ConsentType": "AllPrincipals",
+        "IsDomainIsolated": false,
+        "ObjectId": "jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM",
+        "PackageName": null,
+        "Resource": "Microsoft Graph",
+        "ResourceId": "d6afc295-0a08-4777-a095-10bcb7e23903",
+        "Scope": "Sites.Read.All"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    ClientId                              ConsentType    IsDomainIsolated  ObjectId                                     PackageName  Resource         ResourceId                            Scope
+    ------------------------------------  -------------  ----------------  -------------------------------------------  -----------  ---------------  ------------------------------------  -----------------------
+    90a2c08e-e786-4100-9ea9-36c261be6c0d  AllPrincipals  false             jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM  null         Microsoft Graph  d6afc295-0a08-4777-a095-10bcb7e23903  User.Read.All
+    90a2c08e-e786-4100-9ea9-36c261be6c0d  AllPrincipals  false             jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM  null         Microsoft Graph  d6afc295-0a08-4777-a095-10bcb7e23903  Sites.Read.All
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    90a2c08e-e786-4100-9ea9-36c261be6c0d,AllPrincipals,,jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM,,Microsoft Graph,d6afc295-0a08-4777-a095-10bcb7e23903,User.Read.All
+    90a2c08e-e786-4100-9ea9-36c261be6c0d,AllPrincipals,,jsCikIbnAEGeqTbCYb5sDZXCr9YICndHoJUQvLfiOQM,,Microsoft Graph,d6afc295-0a08-4777-a095-10bcb7e23903,Sites.Read.All
+    ```