@pnp/cli-microsoft365 6.1.0-beta.1da0a1d → 6.1.0-beta.240d88d

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/list/{list-label-get.md → list-retentionlabel-get.md}

@@ -1,11 +1,17 @@
-# spo list label get
+# spo list retentionlabel get
 
-Gets label set on the specified list
+Gets the default retention label set on the specified list or library.
 
 ## Usage
 
 ```sh
-m365 spo list label get  [options]
+m365 spo list retentionlabel get [options]
+```
+
+## Alias
+
+```sh
+m365 spo list label get [options]
 ```
 
 ## Options
@@ -26,28 +32,28 @@ m365 spo list label get  [options]
 
 ## Examples
 
-Gets label set on the list with specified title located in the specified site.
+Gets retention label set on the list with specified title located in the specified site.
 
 ```sh
-m365 spo list label get --listTitle ContosoList --webUrl https://contoso.sharepoint.com/sites/project-x
+m365 spo list retentionlabel get --listTitle ContosoList --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Gets label set on the list with specified id located in the specified site.
+Gets retention label set on the list with specified id located in the specified site.
 
 ```sh
-m365 spo list label get --listId cc27a922-8224-4296-90a5-ebbc54da2e85 --webUrl https://contoso.sharepoint.com/sites/project-x
+m365 spo list retentionlabel get --listId cc27a922-8224-4296-90a5-ebbc54da2e85 --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Gets label set on the list with specified server relative url located in the specified site.
+Gets retention label set on the list with specified server relative url located in the specified site.
 
 ```sh
-m365 spo list label get --listUrl 'sites/project-x/Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
+m365 spo list retentionlabel get --listUrl 'sites/project-x/Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Gets label set on the list with specified site-relative URL located in the specified site.
+Gets retention label set on the list with specified site-relative URL located in the specified site.
 
 ```sh
-m365 spo list label get --listUrl 'Shared Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
+m365 spo list retentionlabel get --listUrl 'Shared Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
 ## Response

package/docs/docs/cmd/spo/list/list-retentionlabel-set.md

@@ -0,0 +1,65 @@
+# spo list retentionlabel set
+
+Sets a default retention label on the specified list or library.
+
+## Usage
+
+```sh
+m365 spo list retentionlabel set [options]
+```
+
+## Alias
+
+```sh
+m365 spo list label set [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the list is located
+
+`--label <label>`
+: The label to set on the list
+
+`-t, --listTitle [listTitle]`
+: The title of the list on which to set the label. Specify only one of `listTitle`, `listId` or `listUrl`
+
+`-l, --listId [listId]`
+: The ID of the list on which to set the label. Specify only one of `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or web-relative URL of the list on which to set the label. Specify only one of `listTitle`, `listId` or `listUrl`
+
+`--syncToItems`
+: Specify, to set the label on all existing items in the list
+
+`--blockDelete`
+: Specify, to disallow deleting items in the list
+
+`--blockEdit`
+: Specify, to disallow editing items in the list
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+A list retention label is a default label that will be applied to all new items in the list. If you specify `syncToItems`, it is also synced to existing items. 
+
+## Examples
+
+Sets retention label "Some label" on the list _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list retentionlabel set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Shared Documents' --label 'Some label'
+```
+
+Sets retention label "Some label" and disables editing and deleting items on the list and all existing items for list for list _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list retentionlabel set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'Documents' --label 'Some label' --blockEdit --blockDelete --syncToItems
+```
+
+## Response
+
+The command won't return a response on success.

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/orgassetslibrary/orgassetslibrary-add.md

@@ -11,13 +11,13 @@ m365 spo orgassetslibrary add [options]
 ## Options
 
 `--libraryUrl <libraryUrl>`
-: The URL of the library to promote
+: The URL of the library to promote.
 
 `--thumbnailUrl <thumbnailUrl>`
-: The URL of the thumbnail to render
+: The URL of the thumbnail to render.
 
 `--cdnType [cdnType]`
-: Specifies the CDN type. `Public,Private`. Default is `Private`
+: Specifies the CDN type. Allowed values `Public`, `Private`. Default `Private`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -29,11 +29,15 @@ m365 spo orgassetslibrary add [options]
 Promotes an existing library to become an organization assets library
 
 ```sh
-m365 spo orgassetslibrary add --libraryUrl "https://contoso.sharepoint.com/assets"
+m365 spo orgassetslibrary add --libraryUrl "https://contoso.sharepoint.com/SiteAssets"
 ```
 
 Promotes an existing library to become an organization assets library with Thumbnail
 
 ```sh
-m365 spo orgassetslibrary --libraryUrl "https://contoso.sharepoint.com/assets" --thumbnailUrl "https://contoso.sharepoint.com/assets/logo.png"
+m365 spo orgassetslibrary --libraryUrl "https://contoso.sharepoint.com/SiteAssets" --thumbnailUrl "https://contoso.sharepoint.com/assets/logo.png"
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.md

@@ -22,3 +22,45 @@ List all libraries that are assigned as asset library
 ```sh
 m365 spo orgassetslibrary list
 ```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    {
+      "Url": "/",
+      "Libraries": [
+        {
+          "DisplayName": "Site Assets",
+          "LibraryUrl": "SiteAssets",
+          "ListId": "/Guid(0a327c3f-ba82-4b19-bfa1-628405539420)/",
+          "ThumbnailUrl": null
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Libraries: [{"DisplayName":"Site Assets","LibraryUrl":"SiteAssets","ListId":"/Guid(0a327c3f-ba82-4b19-bfa1-628405539420)/","ThumbnailUrl":null}]
+    Url      : /
+    ```
+
+=== "CSV"
+
+    ```csv
+    Url,Libraries
+    /,"[{""DisplayName"":""Site Assets"",""LibraryUrl"":""SiteAssets"",""ListId"":""/Guid(0a327c3f-ba82-4b19-bfa1-628405539420)/"",""ThumbnailUrl"":null}]"
+    ```
+
+### Response when no library is assigned as asset library
+
+=== "Text"
+
+    ```text
+    No libraries in Organization Assets
+    ```

package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.md

@@ -11,10 +11,10 @@ m365 spo orgassetslibrary remove [options]
 ## Options
 
 `--libraryUrl <libraryUrl>`
-: The server relative URL of the library to be removed as a central location for organization assets
+: The server relative URL of the library to be removed as a central location for organization assets.
 
 `--confirm`
-: Don't prompt for confirming removing the organization asset library
+: Don't prompt for confirming removing the organization asset library.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -23,8 +23,30 @@ m365 spo orgassetslibrary remove [options]
 
 ## Examples
 
-Removes organization assets library without confirmation
+Removes organization assets library without prompting for confirmation
 
 ```sh
 m365 spo orgassetslibrary remove --libraryUrl "/sites/branding/assets" --confirm
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "IsNull": false
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    IsNull: false
+    ```
+
+=== "CSV"
+
+    ```csv
+    IsNull
+    ```

package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.md

@@ -22,3 +22,25 @@ List all organizational news sites
 ```sh
 m365 spo orgnewssite list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      "https://contoso.sharepoint.com/sites/contosoNews"
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    https://contoso.sharepoint.com/sites/contosoNews
+    ```
+
+=== "CSV"
+
+    ```csv
+    https://contoso.sharepoint.com/sites/contosoNews
+    ```

package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.md

@@ -11,10 +11,10 @@ m365 spo orgnewssite remove [options]
 ## Options
 
 `-u, --url <url>`
-: Absolute URL of the site to remove
+: Absolute URL of the site to remove.
 
 `--confirm`
-: Don't prompt for confirmation
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -34,3 +34,7 @@ Remove a site from the list of organizational news sites, without prompting for
 ```sh
 m365 spo orgnewssite remove --url https://contoso.sharepoint.com/sites/site1 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -11,7 +11,7 @@ m365 spo orgnewssite set [options]
 ## Options
 
 `-u, --url <url>`
-: The URL of the site to mark as an organizational news site
+: The URL of the site to mark as an organizational news site.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -29,3 +29,7 @@ Set a site as an organizational news site
 ```sh
 m365 spo orgnewssite set --url https://contoso.sharepoint.com/sites/site1
 ```
+
+## Response
+
+The command won't return a response on success.