@pnp/cli-microsoft365 6.0.0-beta.ff232be → 6.1.0-beta.11542c0

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

@@ -17,10 +17,13 @@ m365 spo listitem set [options]
 : ID of the list item to update.
 
 `-l, --listId [listId]`
-: ID of the list where the item should be updated. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be updated. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
 
 `-c, --contentType [contentType]`
 : The name or the ID of the content type to associate with the updated item
@@ -62,8 +65,67 @@ Update an item with id _147_ with Title _Demo Multi Person Field_ and a multi-se
 m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|adamb@conotoso.com'}]"
 ```
 
-Update an item with id _147_ with Title _Demo Hyperlink Field_ and a hyperlink field named _CustomHyperlink_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Update the field _Title_ and _CustomHyperlink_ of an item with a specific id in a list retrieved by server-relative URL in a specific site
+
+```sh
+m365 spo listitem set --listUrl '/sites/project-x/lists/Demo List' --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
+```
+
+Update an item with a specific Title and multi-choice value
 
 ```sh
-m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
+m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --MultiChoiceField "Choice 1;#Choice 2;#Choice 3"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 236,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ID": 236,
+      "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
+      "Title": "Updated Title",
+      "Modified": "2022-11-16T21:10:06Z",
+      "Created": "2022-11-16T20:56:31Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "7.0",
+      "Attachments": true,
+      "GUID": "cac57513-e870-4e7a-9f23-f4ea10e14f4e",
+      "ComplianceAssetId": null,
+      "OData__vti_ItemDeclaredRecord": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments                  : true
+    AuthorId                     : 10
+    ComplianceAssetId            : null
+    ContentTypeId                : 0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803
+    Created                      : 2022-11-16T20:56:31Z
+    EditorId                     : 10
+    FileSystemObjectType         : 0
+    GUID                         : cac57513-e870-4e7a-9f23-f4ea10e14f4e
+    ID                           : 236
+    Id                           : 236
+    Modified                     : 2022-11-16T21:10:37Z
+    OData__UIVersionString       : 8.0
+    OData__vti_ItemDeclaredRecord: null
+    ServerRedirectedEmbedUri     : null
+    ServerRedirectedEmbedUrl     :
+    Title                        : Updated Title
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+    0,236,,,236,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Updated Title,2022-11-16T21:10:55Z,2022-11-16T20:56:31Z,10,10,9.0,1,cac57513-e870-4e7a-9f23-f4ea10e14f4e,,
+    ```

package/docs/docs/cmd/spo/mail/mail-send.md

@@ -59,3 +59,7 @@ Send an e-mail to _user@contoso.com_ with additional headers
 ```sh
 m365 spo mail send --webUrl https://contoso.sharepoint.com/sites/project-x --to "user@contoso.com" --subject "Email sent via CLI for Microsoft 365" --body "<h1>CLI for Microsoft 365</h1>Email sent via <b>command</b>." --additionalHeaders "'{\"X-MC-Tags\":\"CLI for Microsoft 365\"}'"
 ```
+
+## 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`
+`-l, --location [location]`
+: 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"
 
@@ -49,3 +49,42 @@ Add a navigation node below an existing node
 ```sh
 m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --parentNodeId 2010 --title About --url /sites/team-s/sitepages/about.aspx
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "AudienceIds": null,
+      "CurrentLCID": 1033,
+      "Id": 2030,
+      "IsDocLib": true,
+      "IsExternal": true,
+      "IsVisible": true,
+      "ListTemplateType": 0,
+      "Title": "Navigation Link",
+      "Url": "https://contoso.sharepoint.com"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    AudienceIds     : null
+    CurrentLCID     : 1033
+    Id              : 2031
+    IsDocLib        : true
+    IsExternal      : true
+    IsVisible       : true
+    ListTemplateType: 0
+    Title           : Navigation Link
+    Url             : https://contoso.sharepoint.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    AudienceIds,CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
+    ,1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
+    ```

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

@@ -31,3 +31,32 @@ Retrieve nodes from the quick launch
 ```sh
 m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Id": 2032,
+        "Title": "Navigation Link",
+        "Url": "https://contoso.sharepoint.com"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id    Title            Url
+    ----  ---------------  ------------------------------
+    2032  Navigation Link  https://contoso.sharepoint.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Title,Url
+    2032,Navigation Link,https://contoso.sharepoint.com
+    ```

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

@@ -37,3 +37,7 @@ Remove a node from the quick launch without prompting for confirmation
 ```sh
 m365 spo navigation node remove --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --id 2003 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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.

package/docs/docs/cmd/spo/page/page-add.md

@@ -11,31 +11,31 @@ m365 spo page add [options]
 ## Options
 
 `-n, --name <name>`
-: Name of the page to create
+: Name of the page to create.
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the page should be created
+: URL of the site where the page should be created.
 
 `-t, --title [title]`
-: Title of the page to create. If not specified, will use the page name as its title
+: Title of the page to create. If not specified, will use the page name as its title.
 
 `-l, --layoutType [layoutType]`
-: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`,`HeaderlessSearchResults`, `Spaces`, `Topic`. Default `Article`
+: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`, `HeaderlessSearchResults`, `Spaces`, `Topic`. Default `Article`.
 
 `-p, --promoteAs [promoteAs]`
-: Create the page for a specific purpose. Allowed values `HomePage`, `NewsPage`
+: Create the page for a specific purpose. Allowed values `HomePage`, `NewsPage`, `Template`.
 
 `--commentsEnabled`
-: Set to enable comments on the page
+: Set to enable comments on the page.
 
 `--publish`
-: Set to publish the page
+: Set to publish the page.
 
 `--publishMessage [publishMessage]`
-: Message to set when publishing the page
+: Message to set when publishing the page.
 
 `--description [description]`
-: The description to set for the page
+: The description to set for the page.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -100,3 +100,7 @@ Create new article page with description
 ```sh
 m365 spo page add --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --description "Description to add for the page"
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/page/page-clientsidewebpart-add.md

@@ -11,31 +11,31 @@ m365 spo page clientsidewebpart add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the page to add the web part to is located
+: URL of the site where the page to add the web part to is located.
 
 `-n, --pageName <pageName>`
-: Name of the page to which add the web part
+: Name of the page to which add the web part.
 
 `--standardWebPart [standardWebPart]`
-: Name of the standard web part to add (see the possible values below)
+: Name of the standard web part to add (see the possible values below). Specify either `standardWebPart` or `webPartId` but not both.
 
 `--webPartId [webPartId]`
-: ID of the custom web part to add
+: ID of the custom web part to add. Specify either `standardWebPart` or `webPartId` but not both.
 
 `--webPartProperties [webPartProperties]`
-: JSON string with web part properties to set on the web part. Specify `webPartProperties` or `webPartData` but not both
+: JSON string with web part properties to set on the web part. Specify either `webPartProperties` or `webPartData` but not both.
 
 `--webPartData [webPartData]`
-: JSON string with web part data as retrieved from the web part maintenance mode. Specify `webPartProperties` or `webPartData` but not both
+: JSON string with web part data as retrieved from the web part maintenance mode. Specify either `webPartProperties` or `webPartData` but not both.
 
 `--section [section]`
-: Number of the section to which the web part should be added (1 or higher)
+: Number of the section to which the web part should be added (1 or higher).
 
 `--column [column]`
-: Number of the column in which the web part should be added (1 or higher)
+: Number of the column in which the web part should be added (1 or higher).
 
 `--order [order]`
-: Order of the web part in the column
+: Order of the web part in the column.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -45,7 +45,8 @@ If the specified `pageName` doesn't refer to an existing modern page, you will g
 
 To add a standard web part to the page, specify one of the following values: _ContentRollup, BingMap, ContentEmbed, DocumentEmbed, Image, ImageGallery, LinkPreview, NewsFeed, NewsReel, PowerBIReportEmbed, QuickChart, SiteActivity, VideoEmbed, YammerEmbed, Events, GroupCalendar, Hero, List, PageTitle, People, QuickLinks, CustomMessageRegion, Divider, MicrosoftForms, Spacer_.
 
-When specifying the JSON string with web part properties on Windows, you have to escape double quotes in a specific way. Considering the following value for the _webPartProperties_ option: `{"Foo":"Bar"}`, you should specify the value as \`"{""Foo"":""Bar""}"\`. In addition, when using PowerShell, you should use the `--%` argument.
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--webPartProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
 ## Examples
 
@@ -67,20 +68,18 @@ Add a custom web part to the modern page
 m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --webPartId 3ede60d3-dc2c-438b-b5bf-cc40bb2351e1
 ```
 
-Using PowerShell, add the standard Bing Map web part with the specific properties to a modern page
-
-```PowerShell
-m365 --% spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart BingMap --webPartProperties `"{""Title"":""Foo location""}"`
-```
-
-Using Windows command line, add the standard Bing Map web part with the specific properties to a modern page
+Add the standard Bing Map web part with the specific properties to a modern page
 
 ```sh
-m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart BingMap --webPartProperties `"{""Title"":""Foo location""}"`
+m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart BingMap --webPartProperties '{"Title":"Foo location"}'
 ```
 
 Add the standard Image web part with the preconfigured image
 
 ```sh
-m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart Image --webPartData '`{ "dataVersion": "1.8", "serverProcessedContent": {"htmlStrings":{},"searchablePlainTexts":{"captionText":""},"imageSources":{"imageSource":"/sites/team-a/SiteAssets/work-life-balance.png"},"links":{}}, "properties": {"imageSourceType":2,"altText":"a group of people on a beach","overlayText":"Work life balance","fileName":"48146-OFF12_Justice_01.png","siteId":"27664b85-067d-4be9-a7d7-89b2e804d09f","webId":"a7664b85-067d-4be9-a7d7-89b2e804d09f","listId":"37664b85-067d-4be9-a7d7-89b2e804d09f","uniqueId":"67664b85-067d-4be9-a7d7-89b2e804d09f","imgWidth":650,"imgHeight":433,"fixAspectRatio":false,"isOverlayTextEnabled":true}}`'
+m365 spo page clientsidewebpart add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --standardWebPart Image --webPartData '{ "dataVersion": "1.8", "serverProcessedContent": {"htmlStrings":{},"searchablePlainTexts":{"captionText":""},"imageSources":{"imageSource":"/sites/team-a/SiteAssets/work-life-balance.png"},"links":{}}, "properties": {"imageSourceType":2,"altText":"a group of people on a beach","overlayText":"Work life balance","fileName":"48146-OFF12_Justice_01.png","siteId":"27664b85-067d-4be9-a7d7-89b2e804d09f","webId":"a7664b85-067d-4be9-a7d7-89b2e804d09f","listId":"37664b85-067d-4be9-a7d7-89b2e804d09f","uniqueId":"67664b85-067d-4be9-a7d7-89b2e804d09f","imgWidth":650,"imgHeight":433,"fixAspectRatio":false,"isOverlayTextEnabled":true}}'
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/page/page-column-get.md

@@ -11,27 +11,90 @@ m365 spo page column get [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the page to retrieve is located
+: URL of the site where the page to retrieve is located.
 
-`-n, --name <name>`
-: Name of the page to get column information of
+`-n, --pageName <pageName>`
+: Name of the page to get column information of.
 
 `-s, --section <section>`
-: ID of the section where the column is located
+: ID of the section where the column is located.
 
 `-c, --column <column>`
-: ID of the column for which to retrieve more information
+: ID of the column for which to retrieve more information.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-If the specified name doesn't refer to an existing modern page, you will get a _File doesn't exists_ error.
+If the specified `pageName` doesn't refer to an existing modern page, you will get a _File doesn't exists_ error.
 
 ## Examples
 
-Get information about the first column in the first section of a modern page with name _home.aspx_
+Get information about the first column in the first section of a modern page
 
 ```sh
-m365 spo page column get --webUrl https://contoso.sharepoint.com/sites/team-a --name home.aspx --section 1 --column 1
+m365 spo page column get --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --section 1 --column 1
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "factor": 12,
+      "order": 1,
+      "dataVersion": "1.0",
+      "jsonData": "&#123;&quot;displayMode&quot;&#58;2,&quot;position&quot;&#58;&#123;&quot;sectionFactor&quot;&#58;12,&quot;sectionIndex&quot;&#58;1,&quot;zoneIndex&quot;&#58;1&#125;&#125;",
+      "controls": [
+        {
+          "controlType": 3,
+          "dataVersion": "1.0",
+          "order": 1,
+          "id": "7558d804-0334-49ca-b14a-53870cf6caae",
+          "controlData": {
+            "controlType": 3,
+            "displayMode": 2,
+            "id": "7558d804-0334-49ca-b14a-53870cf6caae",
+            "position": {
+              "controlIndex": 1,
+              "sectionIndex": 1,
+              "zoneIndex": 1,
+              "sectionFactor": 12,
+              "layoutIndex": 1
+            },
+            "webPartId": "e377ea37-9047-43b9-8cdb-a761be2f8e09",
+            "emphasis": {}
+          },
+          "title": "Bing Maps",
+          "description": "Display a location on a map using Bing Maps.",
+          "propertieJson": {
+            "pushPins": [],
+            "maxNumberOfPushPins": 1,
+            "shouldShowPushPinTitle": true,
+            "zoomLevel": 12,
+            "mapType": "road"
+          },
+          "webPartId": "e377ea37-9047-43b9-8cdb-a761be2f8e09",
+          "htmlProperties": "",
+          "serverProcessedContent": null,
+          "canvasDataVersion": "1.0"
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    controls: 7558d804-0334-49ca-b14a-53870cf6caae (Bing Maps)
+    factor  : 12
+    order   : 1
+    ```
+
+=== "CSV"
+
+    ```csv
+    factor,order,controls
+    12,1,7558d804-0334-49ca-b14a-53870cf6caae (Bing Maps)
+    ```