@pnp/cli-microsoft365 6.1.0-beta.a927083 → 6.1.0-beta.d86ff3a

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

@@ -11,13 +11,13 @@ m365 spo page section 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, --pageName <pageName>`
-: Name of the page to get section information of
+: Name of the page to get section information of.
 
 `-s, --section <sectionId>`
-: ID of the section for which to retrieve information
+: ID of the section for which to retrieve information.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -27,8 +27,40 @@ If the specified `pageName` doesn't refer to an existing modern page, you will g
 
 ## Examples
 
-Get information about the specified section of the modern page named _home.aspx_
+Get information about the specified section of the modern page
 
 ```sh
 m365 spo page section get --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --section 1
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "order": 1,
+      "columns": [
+        {
+          "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;"
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    columns: [{"factor":12,"order":1}]
+    order  : 1
+    ```
+
+=== "CSV"
+
+    ```csv
+    order,columns
+    1,"[{""factor"":12,""order"":1}]"
+    ```

package/docs/docs/cmd/spo/page/page-section-list.md

@@ -11,10 +11,10 @@ m365 spo page section list [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, --pageName <pageName>`
-: Name of the page to list sections of
+: Name of the page to list sections of.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -24,8 +24,43 @@ If the specified `pageName` doesn't refer to an existing modern page, you will g
 
 ## Examples
 
-List sections of a modern page named _home.aspx_
+List sections of a modern page
 
 ```sh
 m365 spo page section list --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "order": 1,
+        "columns": [
+          {
+            "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;"
+          }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    order  columns
+    -----  -------
+    1      1
+    ```
+
+=== "CSV"
+
+    ```csv
+    order,columns
+    1,1
+    ```

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

@@ -11,34 +11,34 @@ m365 spo page set [options]
 ## Options
 
 `-n, --name <name>`
-: Name of the page to update
+: Name of the page to update.
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the page to update is located
+: URL of the site where the page to update is located.
 
 `-l, --layoutType [layoutType]`
-: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`, `HeaderlessSearchResults`, `Spaces`, `Topic`
+: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`, `HeaderlessSearchResults`, `Spaces`, `Topic`.
 
 `-p, --promoteAs [promoteAs]`
-: Update the page purpose. Allowed values `HomePage`, `NewsPage`, `Template`
+: Update the page purpose. Allowed values `HomePage`, `NewsPage`, `Template`.
 
 `--demoteFrom [demoteFrom]`
-: Update the page purpose back to a regular article. Allowed values `NewsPage`
+: Update the page purpose back to a regular article. Allowed values `NewsPage`.
 
 `--commentsEnabled [commentsEnabled]`
-: Set to `true`, to enable comments on the page. Allowed values `true`, `false`
+: Set to `true`, to enable comments on the page. Allowed values `true`, `false`.
 
 `--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.
 
 `--title [title]`
-: The title to set for the page
+: The title to set for the page.
 
 --8<-- "docs/cmd/_global.md"
 

package/docs/docs/cmd/spo/page/page-template-list.md

@@ -11,7 +11,7 @@ m365 spo page template list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site from which to retrieve available pages
+: URL of the site from which to retrieve available pages.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -22,3 +22,60 @@ Lists all page templates in the given site
 ```sh
 m365 spo page template list --webUrl https://contoso.sharepoint.com/sites/team-a
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "AbsoluteUrl": "https://contoso.sharepoint.com/sites/SPDemo/SitePages/Templates/Company-Policy.aspx",
+        "AuthorByline": [
+          "i:0#.f|membership|user@contoso.com"
+        ],
+        "BannerImageUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/d22d83c8-3fb2-4168-8902-a29dc31e95b1/thumbnails/large.jpg?file=1131975775.jpg",
+        "BannerThumbnailUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/d22d83c8-3fb2-4168-8902-a29dc31e95b1/thumbnails/large.jpg?file=1131975775.jpg",
+        "CallToAction": "",
+        "Categories": null,
+        "ContentTypeId": "0x0101009D1CB255DA76424F860D91F20E6C411800F1678937A82C3142BEF3C962300813B5",
+        "Description": "Company policy are set in place to establish the rules of conduct within an organization, outlining the responsibilities of both employees and employers. The management of company policy and procedures aim to protect the rights of workers as well as…",
+        "DoesUserHaveEditPermission": true,
+        "FileName": "Company-Policy.aspx",
+        "FirstPublished": "0001-01-01T08:00:00Z",
+        "Id": 27,
+        "IsPageCheckedOutToCurrentUser": false,
+        "IsWebWelcomePage": false,
+        "Modified": "2022-11-26T10:51:12Z",
+        "PageLayoutType": "Article",
+        "Path": {
+          "DecodedUrl": "SitePages/Templates/Company-Policy.aspx"
+        },
+        "PromotedState": 0,
+        "Title": "Company Policy",
+        "TopicHeader": null,
+        "UniqueId": "06509101-7e2f-4467-afd2-97bad4a53ef2",
+        "Url": "SitePages/Templates/Company-Policy.aspx",
+        "Version": "0.1",
+        "VersionInfo": {
+          "LastVersionCreated": "0001-01-01T00:00:00-08:00",
+          "LastVersionCreatedBy": ""
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    FileName             Id  PageLayoutType  Title           Url
+    -------------------  --  --------------  --------------  ----------------------------------------
+    Company-Policy.aspx  27  Article         Company Policy  SitePages/Templates/Company-Policy.aspx
+    ```
+
+=== "CSV"
+
+    ```csv
+    Title,FileName,Id,PageLayoutType,Url
+    Company Policy,Company-Policy.aspx,27,Article,SitePages/Templates/Company-Policy.aspx
+    ```

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

@@ -11,22 +11,22 @@ m365 spo page text add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the page to add the text to is located
+: URL of the site where the page to add the text to is located.
 
 `-n, --pageName <pageName>`
-: Name of the page to which add the text
+: Name of the page to which add the text.
 
 `-t, --text <text>`
 : Text to add to the page
 
 `--section [section]`
-: Number of the section to which the text should be added (1 or higher)
+: Number of the section to which the text should be added (1 or higher).
 
 `--column [column]`
-: Number of the column in which the text should be added (1 or higher)
+: Number of the column in which the text should be added (1 or higher).
 
 `--order [order]`
-: Order of the text in the column
+: Order of the text in the column.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -53,3 +53,7 @@ Add text at the beginning of the default column on a modern page
 ```sh
 m365 spo page text add --webUrl https://contoso.sharepoint.com/sites/a-team --pageName page.aspx --text 'Hello world' --order 1
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/propertybag/propertybag-get.md

@@ -11,44 +11,64 @@ m365 spo propertybag get [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: The URL of the site from which the property bag value should be retrieved
+: The URL of the site from which the property bag value should be retrieved.
 
 `-k, --key <key>`
-: Key of the property for which the value should be retrieved. Case-sensitive
+: Key of the property for which the value should be retrieved. Case-sensitive.
 
 `-f, --folder [folder]`
-: Site-relative URL of the folder from which to retrieve property bag value. Case-sensitive
+: Site-relative URL of the folder from which to retrieve property bag value. Case-sensitive.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Returns the value of the _key1_ property from the property bag located in site _https://contoso.sharepoint.com/sites/test_
+Returns the value of the property from the property bag located in the given site
 
 ```sh
 m365 spo propertybag get --webUrl https://contoso.sharepoint.com/sites/test --key key1
 ```
 
-Returns the value of the _key1_ property from the property bag located in site root folder _https://contoso.sharepoint.com/sites/test_
+Returns the value of the property from the property bag located in root folder of the given site
 
 ```sh
 m365 spo propertybag get --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder /
 ```
 
-Returns the value of the _key1_ property from the property bag located in site document library _https://contoso.sharepoint.com/sites/test_
+Returns the value of the property from the property bag located in document library of the given site
 
 ```sh
 m365 spo propertybag get --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder '/Shared Documents'
 ```
 
-Returns the value of the _key1_ property from the property bag located in folder in site document library _https://contoso.sharepoint.com/sites/test_
+Returns the value of the property from the property bag located in folder in a document library located in the given site
 
 ```sh
 m365 spo propertybag get --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder '/Shared Documents/MyFolder'
 ```
 
-Returns the value of the _key1_ property from the property bag located in site list _https://contoso.sharepoint.com/sites/test_
+Returns the value of the property from the property bag located in a list in the given site
 
 ```sh
 m365 spo propertybag get --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder /Lists/MyList
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    "Approved Rejected Pending\\ Review"
+    ```
+
+=== "Text"
+
+    ```text
+    Approved Rejected Pending\\ Review
+    ```
+
+=== "CSV"
+
+    ```csv
+    Approved Rejected Pending\ Review
+    ```

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

@@ -11,41 +11,69 @@ m365 spo propertybag list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: The URL of the site from which the property bag value should be retrieved
+: The URL of the site from which the property bag value should be retrieved.
 
 `-f, --folder [folder]`
-: Site-relative URL of the folder from which to retrieve property bag value. Case-sensitive
+: Site-relative URL of the folder from which to retrieve property bag value. Case-sensitive.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Return property bag values located in site _https://contoso.sharepoint.com/sites/test_
+Return property bag values located in the given site
 
 ```sh
 m365 spo propertybag list --webUrl https://contoso.sharepoint.com/sites/test
 ```
 
-Return property bag values located in site root folder _https://contoso.sharepoint.com/sites/test_
+Return property bag values located in the given site root folder
 
 ```sh
 m365 spo propertybag list --webUrl https://contoso.sharepoint.com/sites/test --folder /
 ```
 
-Return property bag values located in site document library _https://contoso.sharepoint.com/sites/test_
+Return property bag values located in the given site document library
 
 ```sh
 m365 spo propertybag list --webUrl https://contoso.sharepoint.com/sites/test --folder '/Shared Documents'
 ```
 
-Return property bag values located in folder in site document library _https://contoso.sharepoint.com/sites/test_
+Return property bag values located in folder in the given site document library
 
 ```sh
 m365 spo propertybag list --webUrl https://contoso.sharepoint.com/sites/test --folder '/Shared Documents/MyFolder'
 ```
 
-Return property bag values located in site list _https://contoso.sharepoint.com/sites/test_
+Return property bag values located in the given site list
 
 ```sh
 m365 spo propertybag list --webUrl https://contoso.sharepoint.com/sites/test --folder /Lists/MyList
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "key": "vti_approvallevels",
+        "value": "Approved Rejected Pending\\ Review"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    key                   value                                                                             
+    --------------------  -----------------------------------
+    vti_approvallevels     Approved Rejected Pending\ Review
+    ```
+
+=== "CSV"
+
+    ```csv
+    key,value
+    vti_approvallevels,Approved Rejected Pending\ Review
+    ```

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

@@ -11,47 +11,51 @@ m365 spo propertybag remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: The URL of the site from which the property should be removed
+: The URL of the site from which the property should be removed.
 
 `-k, --key <key>`
-: Key of the property to be removed. Case-sensitive
+: Key of the property to be removed. Case-sensitive.
 
 `-f, --folder [folder]`
-: Site-relative URL of the folder from which to remove the property bag value
+: Site-relative URL of the folder from which to remove the property bag value.
 
 `--confirm`
-: Don't prompt for confirming removal of property bag value
+: Don't prompt for confirming removal of property bag value.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Removes the value of the _key1_ property from the property bag located in site _https://contoso.sharepoint.com/sites/test_
+Removes the value of the property from the property bag located the given site
 
 ```sh
 m365 spo propertybag remove --webUrl https://contoso.sharepoint.com/sites/test --key key1
 ```
 
-Removes the value of the _key1_ property from the property bag located in site root folder _https://contoso.sharepoint.com/sites/test_
+Removes the value of the property from the property bag located in the given site root folder
 
 ```sh
 m365 spo propertybag remove --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder / --confirm
 ```
 
-Removes the value of the _key1_ property from the property bag located in site document library _https://contoso.sharepoint.com/sites/test_
+Removes the value of the property from the property bag located in the given site document library
 
 ```sh
 m365 spo propertybag remove --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder '/Shared Documents'
 ```
 
-Removes the value of the _key1_ property from the property bag located in folder in site document library _https://contoso.sharepoint.com/sites/test_
+Removes the value of the property from the property bag located in folder in the given site document library
 
 ```sh
 m365 spo propertybag remove --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder '/Shared Documents/MyFolder'
 ```
 
-Removes the value of the _key1_ property from the property bag located in site list _https://contoso.sharepoint.com/sites/test_
+Removes the value of the property from the property bag located in the given site list
 
 ```sh
 m365 spo propertybag remove --webUrl https://contoso.sharepoint.com/sites/test --key key1 --folder /Lists/MyList
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -24,34 +24,42 @@ m365 spo propertybag set [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+SharePoint Online supports setting property bag values only in classic sites. On modern sites you will get a _Site has NoScript enabled, and setting property bag values is not supported_ error.
+
 ## Examples
 
-Sets the value of the _key1_ property in the property bag of site _https://contoso.sharepoint.com/sites/test_
+Sets the value of the property in the property bag of the given site
 
 ```sh
 m365 spo propertybag set --webUrl https://contoso.sharepoint.com/sites/test --key key1 --value value1
 ```
 
-Sets the value of the _key1_ property in the property bag of the root folder of site _https://contoso.sharepoint.com/sites/test_
+Sets the value of the property in the property bag of the root folder of the given site
 
 ```sh
 m365 spo propertybag set --webUrl https://contoso.sharepoint.com/sites/test --key key1 --value value1 --folder /
 ```
 
-Sets the value of the _key1_ property in the property bag of a document library located in site _https://contoso.sharepoint.com/sites/test_
+Sets the value of the property in the property bag of a document library located in the given site
 
 ```sh
 m365 spo propertybag set --webUrl https://contoso.sharepoint.com/sites/test --key key1 --value value1 --folder '/Shared Documents'
 ```
 
-Sets the value of the _key1_ property in the property bag of a folder in a document library located in site _https://contoso.sharepoint.com/sites/test_
+Sets the value of the property in the property bag of a folder in a document library located in the given site
 
 ```sh
 m365 spo propertybag set --webUrl https://contoso.sharepoint.com/sites/test --key key1 --value value1 --folder '/Shared Documents/MyFolder'
 ```
 
-Sets the value of the _key1_ property in the property bag of a list in site _https://contoso.sharepoint.com/sites/test_
+Sets the value of the property in the property bag of a list in the given site
 
 ```sh
 m365 spo propertybag set --webUrl https://contoso.sharepoint.com/sites/test --key key1 --value value1 --folder /Lists/MyList
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/report/report-activityfilecounts.md

@@ -11,10 +11,10 @@ m365 spo report activityfilecounts [options]
 ## Options
 
 `-p, --period <period>`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +37,35 @@ Gets the number of unique, licensed users who interacted with files stored on Sh
 ```sh
 m365 spo report activityfilecounts --period D7 --output json > "activityfilecounts.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Viewed Or Edited": "3",
+        "Synced": "",
+        "Shared Internally": "",
+        "Shared Externally": "",
+        "Report Date": "2022-11-26",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Viewed Or Edited,Synced,Shared Internally,Shared Externally,Report Date,Report Period
+    2022-11-26,3,,,,2022-11-26,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Viewed Or Edited,Synced,Shared Internally,Shared Externally,Report Date,Report Period
+    2022-11-26,3,,,,2022-11-26,7
+    ```

package/docs/docs/cmd/spo/report/report-activitypages.md

@@ -11,10 +11,10 @@ m365 spo report activitypages [options]
 ## Options
 
 `-p, --period <period>`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +37,32 @@ Gets the number of unique pages visited by users for the last week and exports t
 ```sh
 m365 spo report activitypages --period D7 --output json > "activitypages.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Visited Page Count": "10",
+        "Report Date": "2022-11-26",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Visited Page Count,Report Date,Report Period
+    2022-11-26,10,2022-11-26,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Visited Page Count,Report Date,Report Period
+    2022-11-26,10,2022-11-26,7
+    ```

package/docs/docs/cmd/spo/report/report-activityusercounts.md

@@ -11,10 +11,10 @@ m365 spo report activityusercounts [options]
 ## Options
 
 `-p, --period <period>`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -41,3 +41,36 @@ Gets the trend in the number of active users for the last week and exports the r
 ```sh
 m365 spo report activityusercounts --period D7 --output json > "activityusercounts.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Visited Page": "1",
+        "Viewed Or Edited": "1",
+        "Synced": "",
+        "Shared Internally": "",
+        "Shared Externally": "",
+        "Report Date": "2022-11-26",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Visited Page,Viewed Or Edited,Synced,Shared Internally,Shared Externally,Report Date,Report Period
+    2022-11-26,1,1,,,,2022-11-26,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Visited Page,Viewed Or Edited,Synced,Shared Internally,Shared Externally,Report Date,Report Period
+    2022-11-26,1,1,,,,2022-11-26,7
+    ```