@pnp/cli-microsoft365 6.7.0-beta.54db310 → 6.7.0-beta.7321771

package/docs/docs/cmd/login.md

@@ -37,6 +37,9 @@ m365 login [options]
 `--tenant [tenant]`
 : ID of the tenant from which accounts should be able to authenticate. Use `common` or `organization` if the app is multitenant. If not specified, use the tenant specified in the `CLIMICROSOFT365_TENANT` environment variable. If the environment variable is not defined, use `common` as the tenant identifier
 
+`--cloud [cloud]`
+: Cloud to connect to. Allowed values `Public`, `USGov`, `USGovHigh`, `USGovDoD` and `China`. Default `Public`
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -45,8 +48,6 @@ Using the `login` command you can log in to Microsoft 365.
 
 By default, the `login` command uses device code OAuth flow to log in to Microsoft 365. Alternatively, you can authenticate using a user name and password or certificate, which are convenient for CI/CD scenarios, but which come with their own [limitations](../user-guide/connecting-office-365.md).
 
-When logging in to Microsoft 365, the `login` command stores in memory the access token and the refresh token. Both tokens are cleared from memory after exiting the CLI or by calling the [logout](logout.md) command.
-
 When logging in to Microsoft 365 using the user name and password, next to the access and refresh token, the CLI for Microsoft 365 will store the user credentials so that it can automatically re-authenticate if necessary. Similarly to the tokens, the credentials are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.
 
 When logging in to Microsoft 365 using a certificate, the CLI for Microsoft 365 will store the contents of the certificate so that it can automatically re-authenticate if necessary. The contents of the certificate are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.  
@@ -55,6 +56,8 @@ To log in to Microsoft 365 using a certificate or secret, you will typically [cr
 
 Managed identity in Azure Cloud Shell is the identity of the user. It is neither system- nor user-assigned and it can't be configured. To log in to Microsoft 365 using managed identity in Azure Cloud Shell, set `authType` to `identity` and don't specify the `userName` option.
 
+When connecting to clouds other than `Public`, you'll need to use an Azure AD application registered in a directory provisioned in that cloud. If you try to login using the default Azure AD application, login will fail.
+
 ## Examples
 
 Log in to Microsoft 365 using the device code

package/docs/docs/cmd/planner/task/task-add.md

@@ -50,7 +50,7 @@ m365 planner task add [options]
 : Hint used to order items of this type in a list view. The format is defined as outlined [here](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
 
 `--description [description]`
-: Description of the task
+: Description of the task.
 
 `--appliedCategories [appliedCategories]`
 : Comma-separated categories that should be added to the task. The possible options are: `category1`, `category2`, `category3`, `category4`, `category5` and/or `category6`. Additional info defined [here](https://docs.microsoft.com/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0).
@@ -81,6 +81,8 @@ When you specify an integer value for `priority`, consider the following:
 - values 5, 6 and 7 are interpreted as _Medium_
 - values 8, 9 and 10 are interpreted as _Low_
 
+When using `description` with a multiple lines value, use the new line character of the shell you are using to indicate line breaks. For PowerShell this is `` `n ``. For Zsh or Bash use `\n` with a `$` in front. E.g. `$"Line 1\nLine 2"`.
+
 ## Examples
 
 Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkSbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_

package/docs/docs/cmd/planner/task/task-set.md

@@ -50,16 +50,16 @@ m365 planner task set [options]
 : Comma-separated UPNs of the assignees that should be added to the task assignment. Specify either `assignedToUserIds` or `assignedToUserNames` but not both.
 
 `--description [description]`
-: Description of the task
+: Description of the task.
 
 `--orderHint [orderHint]`
-: Hint used to order items of this type in a list view
+: Hint used to order items of this type in a list view.
 
 `--assigneePriority [assigneePriority]`
-: Hint used to order items of this type in a list view
+: Hint used to order items of this type in a list view.
 
 `--appliedCategories [appliedCategories]`
-: Comma-separated categories that should be added to the task
+: Comma-separated categories that should be added to the task.
 
 `--priority [priority]`
 : Priority of the task: Urgent, Important, Medium, Low. Or an integer between 0 and 10 (check remarks section for more info).
@@ -83,6 +83,8 @@ When you specify an integer value for `priority`, consider the following:
 
 You can add up to 6 categories to the task. An example to add _category1_ and _category3_ would be `category1,category3`.
 
+When using `description` with a multiple lines value, use the new line character of the shell you are using to indicate line breaks. For PowerShell this is `` `n ``. For Zsh or Bash use `\n` with a `$` in front. E.g. `$"Line 1\nLine 2"`.
+
 ## Examples
 
 Updates a Microsoft Planner task name to _My Planner Task_ for the task with the ID _Z-RLQGfppU6H3663DBzfs5gAMD3o_

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

@@ -16,21 +16,106 @@ m365 spo file list [options]
 `-f, --folder <folder>`
 : The server- or site-relative URL of the folder from which to retrieve files
 
+`--fields [fields]`
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified.
+
+`--filter [filter]`
+: OData filter to use to query the list of items with
+
 `-r, --recursive`
 : Set to retrieve files from subfolders
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+When the `fields` option includes values with a `/`, for example: `ListItemAllFields/Id`, an additional `$expand` query parameter will be included on `ListItemAllFields`.
+
 ## Examples
 
-Return all files from folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return all files from a folder
 
 ```sh
 m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents'
 ```
 
-Return all files from the folder _Shared Documents_ and all the sub-folders of _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return all files from a folder and all the sub-folders
 
 ```sh
 m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --recursive
 ```
+
+Return the files from a folder with specific fields which will be expanded
+
+```sh
+m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --fields "Title,Length"
+```
+
+Return the files from a folder that meet the criteria of the filter with specific fields which will be expanded
+
+```sh
+m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --fields ListItemAllFields/Id --filter "Name eq 'document.docx'"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "CheckInComment": "",
+        "CheckOutType": 2,
+        "ContentTag": "{F09C4EFE-B8C0-4E89-A166-03418661B89B},9,12",
+        "CustomizedPageStatus": 0,
+        "ETag": "\"{F09C4EFE-B8C0-4E89-A166-03418661B89B},9\"",
+        "Exists": true,
+        "IrmEnabled": false,
+        "Length": 331673,
+        "Level": 1,
+        "LinkingUri": "https://contoso.sharepoint.com/sites/project-x/Shared Documents/Document.docx?d=wf09c4efeb8c04e89a16603418661b89b",
+        "LinkingUrl": "https://contoso.sharepoint.com/sites/project-x/Shared Documents/Document.docx?d=wf09c4efeb8c04e89a16603418661b89b",
+        "MajorVersion": 3,
+        "MinorVersion": 0,
+        "Name": "Document.docx",
+        "ServerRelativeUrl": "/sites/project-x/Shared Documents/Document.docx",
+        "TimeCreated": "2018-02-05T08:42:36Z",
+        "TimeLastModified": "2018-02-05T08:44:03Z",
+        "Title": "",
+        "UIVersion": 1536,
+        "UIVersionLabel": "3.0",
+        "UniqueId": "f09c4efe-b8c0-4e89-a166-03418661b89b"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Name                               ServerRelativeUrl                                UniqueId
+    ---------------------------------  -----------------------------------------------  ------------------------------------
+    Document.docx                      /sites/project-x/Shared Documents/Document.docx  5eb97525-2167-4d26-94b8-092a97d65716
+    ```
+
+=== "CSV"
+
+    ```csv
+    Name,ServerRelativeUrl,UniqueId
+    Document.docx,/sites/project-x/Shared Documents/Document.docx,5eb97525-2167-4d26-94b8-092a97d65716
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo file list --webUrl "https://contoso.sharepoint.com" --folder "Shared Documents"
+
+    Date: 23/3/2023
+
+    ## Document.docx (5eb97525-2167-4d26-94b8-092a97d65716)
+
+    Property | Value
+    ---------|-------
+    Name | Document.docx
+    ServerRelativeUrl | /sites/project-x/Shared Documents/Document.docx
+    UniqueId | 5eb97525-2167-4d26-94b8-092a97d65716
+    ```

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

@@ -16,6 +16,12 @@ m365 spo folder list [options]
 `-p, --parentFolderUrl <parentFolderUrl>`
 : Site-relative URL of the parent folder
 
+`-f, --fields [fields]`
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested.
+
+`--filter [filter]`
+: OData filter to use to query the list of folders with.
+
 `-r, --recursive`
 : Set to retrieve nested folders
 
@@ -23,7 +29,7 @@ m365 spo folder list [options]
 
 ## Examples
 
-Gets list of folders under a parent folder with site-relative url _/Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Gets list of folders under a parent folder
 
 ```sh
 m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents'
@@ -35,6 +41,12 @@ Gets recursive list of folders under a specific folder on a specific site
 m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --recursive
 ```
 
+Return a filtered list of folders and only return the list item ID
+
+```sh
+m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --fields ListItemAllFields/Id --filter "startswith(Name,'Folder')"
+```
+
 ## Response
 
 === "JSON"
@@ -70,3 +82,26 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
     Name,ServerRelativeUrl
     Folder A,/Shared Documents/Folder A
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo folder list --webUrl "https://contoso.sharepoint.com" --parentFolderUrl "/Shared Documents"
+
+    Date: 29/3/2023
+
+    ## Folder A (20523746-971b-4488-aa6d-b45d645f61c5)
+
+    Property | Value
+    ---------|-------
+    Exists | true
+    IsWOPIEnabled | false
+    ItemCount | 9
+    Name | Folder A
+    ProgID | null
+    ServerRelativeUrl | /Shared Documents/Folder A
+    TimeCreated | 2022-04-26T12:30:56Z
+    TimeLastModified | 2022-04-26T12:50:14Z
+    UniqueId | 20523746-971b-4488-aa6d-b45d645f61c5
+    WelcomePage |
+    ```

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

@@ -32,7 +32,7 @@ m365 spo listitem list [options]
 : OData filter to use to query the list of items with. Specify `camlQuery` or `filter` but not both.
 
 `-p, --pageSize [pageSize]`
-: Number of list items to return. Specify `camlQuery` or `pageSize` but not both.
+: Number of list items to return. Specify `camlQuery` or `pageSize` but not both. The default value is 5000.
 
 `-n, --pageNumber [pageNumber]`
 : Page number to return if `pageSize` is specified (first page is indexed as value of 0).
@@ -41,6 +41,8 @@ m365 spo listitem list [options]
 
 ## Remarks
 
+This command retrieves all items in the list, even if there are more than 5000. Use the `pageSize` and `pageNumber` options if you only want a specific amount of items. When using a CAML query, include a `RowLimit`-node to get all items. If you run into list view threshold exceptions, remove any Query-conditions or filters and also include a `RowLimit`-node.
+
 `pageNumber` is specified as a 0-based index. A value of `2` returns the third page of items.
 
 If you want to specify a lookup type in the `properties` option, define which columns from the related list should be returned.
@@ -53,12 +55,6 @@ Get all items from a list named Demo List
 m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-From a list named _Demo List_ get all items with title _Demo list item_ using a CAML query
-
-```sh
-m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query></View>"
-```
-
 Get all items from a list with ID _935c13a0-cc53-4103-8b48-c1d0828eaa7f_
 
 ```sh
@@ -83,10 +79,16 @@ From a list named _Demo List_ get all items with title _Demo list item_ using an
 m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --filter "Title eq 'Demo list item'"
 ```
 
+From a list named _Demo List_ get the first 100 items
+
+```sh
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 100 --pageNumber 0
+```
+
 From a list named _Demo List_ get the second batch of 10 items
 
 ```sh
-m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 2
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 1
 ```
 
 Get all items from a list by server-relative URL
@@ -95,6 +97,18 @@ Get all items from a list by server-relative URL
 m365 spo listitem list --listUrl /sites/project-x/documents --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
+From a list named _Demo List_ get all items with title _Demo list item_ using a CAML query
+
+```sh
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query><RowLimit Paged='TRUE'>5000</RowLimit></View>"
+```
+
+From a library named _Demo Library_ with 5000+ files and folders, get all items recursively without running into a list view threshold exception, using a CAML query
+
+```sh
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View Scope='RecursiveAll'><Query></Query><ViewFields><FieldRef Name='Title'/></ViewFields><RowLimit Paged='TRUE'>5000</RowLimit></View>"
+```
+
 ## Response
 
 === "JSON"

package/docs/docs/cmd/spo/site/site-recyclebinitem-clear.md

@@ -0,0 +1,45 @@
+# spo site recyclebinitem clear
+
+Permanently removes all items in a site recycle bin
+
+## Usage
+
+```sh
+m365 spo site recyclebinitem clear [options]
+```
+
+## Options
+
+`-u, --siteUrl <siteUrl>`
+: URL of the site where the recycle bin is located.
+
+`--secondary`
+: Remove all items from the second-stage recycle bin. When not specified, items from the first-stage recycle bin will be cleared.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! warning
+    Items in the recycle bin will be permanently removed without the ability to restore them.
+
+## Examples
+
+Clear all items from the first-stage recycle bin
+
+```sh
+m365 spo site recyclebinitem clear --siteUrl https://contoso.sharepoint.com/sites/sales
+```
+
+Clear all items from the second-stage recycle bin
+
+```sh
+m365 spo site recyclebinitem clear --siteUrl https://contoso.sharepoint.com/sites/sales --secondary
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -46,3 +46,15 @@ m365 spo get --output json
     SpoUrl
     https://contoso.sharepoint.com
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo get 
+
+    Date: 4/10/2023
+
+    Property | Value
+    ---------|-------
+    SpoUrl | https://contoso.sharepoint.com
+    ```

package/docs/docs/cmd/spo/spo-search.md

@@ -126,9 +126,9 @@ m365 spo search --queryText "*" --sourceId "6e71030e-5e16-4406-9bff-9c1829843083
 === "Text"
 
     ```text
-    Title                    OriginalPath
-    -----------------------  --------------------------------------------------------------------------------------------------------
-    Document                 https://contoso.sharepoint.com/Shared Documents/Document.docx
+    Title     OriginalPath
+    --------  -------------------------------------------------------------
+    Document  https://contoso.sharepoint.com/Shared Documents/Document.docx
     ```
 
 === "CSV"
@@ -138,3 +138,16 @@ m365 spo search --queryText "*" --sourceId "6e71030e-5e16-4406-9bff-9c1829843083
     Document,https://contoso.sharepoint.com/Shared Documents/Document.docx
     ```
 
+=== "Markdown"
+
+    ```md
+    # spo search --queryText "Title:Marketing*" --rowLimit "50" --trimDuplicates "true"
+
+    Date: 4/10/2023
+
+    ## Marketing lunch
+    Property | Value
+    ---------|-------
+    Title | Marketing lunch
+    OriginalPath | https://contoso.sharepoint.com/sites/contosoportal/SitePages/Marketing-Lunch.aspx
+    ```

package/docs/docs/cmd/spo/user/user-ensure.md

@@ -86,7 +86,7 @@ m365 spo user ensure --webUrl https://contoso.sharepoint.com/sites/project --use
 === "Markdown"
 
     ```md
-    # spo user ensure --webUrl "https://mathijsdev2.sharepoint.com" --userName "john@contoso.com"
+    # spo user ensure --webUrl "https://contoso.sharepoint.com" --userName "john@contoso.com"
 
     Date: 18/02/2023
 
@@ -104,6 +104,5 @@ m365 spo user ensure --webUrl https://contoso.sharepoint.com/sites/project --use
     IsEmailAuthenticationGuestUser | false
     IsShareByEmailGuestUser | false
     IsSiteAdmin | false
-    UserId | {"NameId":"100320009d80e5de","NameIdIssuer":"urn:federation:microsoftonline"}
     UserPrincipalName | john@contoso.com
     ```

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

@@ -91,3 +91,27 @@ m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --logi
     Id,IsHiddenInUI,LoginName,Title,PrincipalType,Email,Expiration,IsEmailAuthenticationGuestUser,IsShareByEmailGuestUser,IsSiteAdmin,UserId,UserPrincipalName
     10,,i:0#.f|membership|johndoe@contoso.onmicrosoft.com,John Doe,1,johndoe@contoso.onmicrosoft.com,,,,,"{""NameId"":""100320022ec308a7"",""NameIdIssuer"":""urn:federation:microsoftonline""}",johndoe@contoso.onmicrosoft.com
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo user get --webUrl "https://contoso.sharepoint.com" --loginName "i:0#.f|membership|john.doe@contoso.onmicrosoft.com"
+
+    Date: 4/10/2023
+
+    ## John Doe (9)
+
+    Property | Value
+    ---------|-------
+    Id | 10
+    IsHiddenInUI | false
+    LoginName | i:0#.f\|membership\|john.doe@contoso.onmicrosoft.com
+    Title | Reshmee Auckloo
+    PrincipalType | 1
+    Email | john.doe@contoso.onmicrosoft.com
+    Expiration | 
+    IsEmailAuthenticationGuestUser | false
+    IsShareByEmailGuestUser | false
+    IsSiteAdmin | false
+    UserPrincipalName | john.doe@contoso.onmicrosoft.com
+    ```

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

@@ -52,9 +52,9 @@ m365 spo user list --webUrl https://contoso.sharepoint.com/sites/project-x
 === "Text"
 
     ```text
-    Id          Title                           LoginName
-    ----------  ------------------------------  --------------------------------------------------------------------------
-    10          John Doe                        i:0#.f|membership|johndoe@contoso.onmicrosoft.com
+    Id   Title     LoginName
+    ---  --------  -------------------------------------------------
+    10   John Doe  i:0#.f|membership|johndoe@contoso.onmicrosoft.com
     ```
 
 === "CSV"
@@ -63,3 +63,27 @@ m365 spo user list --webUrl https://contoso.sharepoint.com/sites/project-x
     Id,Title,LoginName
     10,John Doe,i:0#.f|membership|johndoe@contoso.onmicrosoft.com
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo user list --webUrl "https://contoso.sharepoint.com/sites/project-x"
+
+    Date: 4/10/2023
+
+    ## John Doe (10)
+
+    Property | Value
+    ---------|-------
+    Id | 7
+    IsHiddenInUI | false
+    LoginName | c:0o.c\|membership\|johndoe@contoso.onmicrosoft.com
+    Title | John Doe
+    PrincipalType | 1
+    Email | johndoe@contoso.onmicrosoft.com
+    Expiration | 
+    IsEmailAuthenticationGuestUser | false
+    IsShareByEmailGuestUser | false
+    IsSiteAdmin | false
+    UserPrincipalName | johndoe@contoso.onmicrosoft.com
+    ```

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

@@ -611,4 +611,25 @@ m365 spo userprofile get --userName 'john.doe@mytenant.onmicrosoft.com'
     i:0#.f|membership|johndoe@contoso.onmicrosoft.com,[],John Doe,johndoe@contoso.onmicrosoft.com,[],"[""i:0#.f|membership|johndoe@contoso.onmicrosoft.com""]",,,[],https://contoso-my.sharepoint.com:443/,https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/,,,"[{""Key"":""UserProfile_GUID"",""Value"":""0b4f6da0-97db-456e-993d-80e035057600"",""ValueType"":""Edm.String""},{""Key"":""SID"",""Value"":""i:0h.f|membership|100320022ec308a7@live.com"",""ValueType"":""Edm.String""},{""Key"":""ADGuid"",""Value"":""System.Byte[]"",""ValueType"":""Edm.String""},{""Key"":""AccountName"",""Value"":""i:0#.f|membership|johndoe@contoso.onmicrosoft.com"",""ValueType"":""Edm.String""},{""Key"":""FirstName"",""Value"":""John"",""ValueType"":""Edm.String""},{""Key"":""SPS-PhoneticFirstName"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""LastName"",""Value"":""Doe"",""ValueType"":""Edm.String""},{""Key"":""SPS-PhoneticLastName"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""PreferredName"",""Value"":""John Doe"",""ValueType"":""Edm.String""},{""Key"":""SPS-PhoneticDisplayName"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""WorkPhone"",""Value"":""494594133"",""ValueType"":""Edm.String""},{""Key"":""Department"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""Title"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Department"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""Manager"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""AboutMe"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""PersonalSpace"",""Value"":""/personal/john_contoso_onmicrosoft_com/"",""ValueType"":""Edm.String""},{""Key"":""PictureURL"",""Value"":""https://contoso-my.sharepoint.com:443/User%20Photos/Profile%20Pictures/78ccf530-bbf0-47e4-aae6-da5f8c6fb142_MThumb.jpg"",""ValueType"":""Edm.String""},{""Key"":""UserName"",""Value"":""johndoe@contoso.onmicrosoft.com"",""ValueType"":""Edm.String""},{""Key"":""QuickLinks"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""WebSite"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""PublicSiteRedirect"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-JobTitle"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-DataSource"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-MemberOf"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Dotted-line"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Peers"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Responsibility"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-SipAddress"",""Value"":""johndoe@contoso.onmicrosoft.com"",""ValueType"":""Edm.String""},{""Key"":""SPS-MySiteUpgrade"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-DontSuggestList"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-ProxyAddresses"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-HireDate"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-DisplayOrder"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-ClaimID"",""Value"":""johndoe@contoso.onmicrosoft.com"",""ValueType"":""Edm.String""},{""Key"":""SPS-ClaimProviderID"",""Value"":""membership"",""ValueType"":""Edm.String""},{""Key"":""SPS-LastColleagueAdded"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-OWAUrl"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-ResourceSID"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-ResourceAccountName"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-MasterAccountName"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-UserPrincipalName"",""Value"":""johndoe@contoso.onmicrosoft.com"",""ValueType"":""Edm.String""},{""Key"":""SPS-O15FirstRunExperience"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-PersonalSiteInstantiationState"",""Value"":""2"",""ValueType"":""Edm.String""},{""Key"":""SPS-DistinguishedName"",""Value"":""CN=78ccf530-bbf0-47e4-aae6-da5f8c6fb142,OU=0cac6cda-2e04-4a3d-9c16-9c91470d7022,OU=Tenants,OU=MSOnline,DC=SPODS188311,DC=msft,DC=net"",""ValueType"":""Edm.String""},{""Key"":""SPS-SourceObjectDN"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-LastKeywordAdded"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-ClaimProviderType"",""Value"":""Forms"",""ValueType"":""Edm.String""},{""Key"":""SPS-SavedAccountName"",""Value"":""i:0#.f|membership|johndoe@contoso.onmicrosoft.com"",""ValueType"":""Edm.String""},{""Key"":""SPS-SavedSID"",""Value"":""System.Byte[]"",""ValueType"":""Edm.String""},{""Key"":""SPS-ObjectExists"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-PersonalSiteCapabilities"",""Value"":""36"",""ValueType"":""Edm.String""},{""Key"":""SPS-PersonalSiteFirstCreationTime"",""Value"":""9/12/2022 6:19:29 PM"",""ValueType"":""Edm.String""},{""Key"":""SPS-PersonalSiteLastCreationTime"",""Value"":""9/12/2022 6:19:29 PM"",""ValueType"":""Edm.String""},{""Key"":""SPS-PersonalSiteNumberOfRetries"",""Value"":""1"",""ValueType"":""Edm.String""},{""Key"":""SPS-PersonalSiteFirstCreationError"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-FeedIdentifier"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""WorkEmail"",""Value"":""johndoe@contoso.onmicrosoft.com"",""ValueType"":""Edm.String""},{""Key"":""CellPhone"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""Fax"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""HomePhone"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""Office"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Location"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""Assistant"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-PastProjects"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Skills"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-School"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Birthday"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-StatusNotes"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Interests"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-HashTags"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-EmailOptin"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-PrivacyPeople"",""Value"":""True"",""ValueType"":""Edm.String""},{""Key"":""SPS-PrivacyActivity"",""Value"":""4095"",""ValueType"":""Edm.String""},{""Key"":""SPS-PictureTimestamp"",""Value"":""63799442436"",""ValueType"":""Edm.String""},{""Key"":""SPS-PicturePlaceholderState"",""Value"":""1"",""ValueType"":""Edm.String""},{""Key"":""SPS-PictureExchangeSyncState"",""Value"":""1"",""ValueType"":""Edm.String""},{""Key"":""SPS-MUILanguages"",""Value"":""en-US"",""ValueType"":""Edm.String""},{""Key"":""SPS-ContentLanguages"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-TimeZone"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-RegionalSettings-FollowWeb"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Locale"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-CalendarType"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-AltCalendarType"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-AdjustHijriDays"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-ShowWeeks"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-WorkDays"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-WorkDayStartHour"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-WorkDayEndHour"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-Time24"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-FirstDayOfWeek"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-FirstWeekOfYear"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-RegionalSettings-Initialized"",""Value"":""True"",""ValueType"":""Edm.String""},{""Key"":""OfficeGraphEnabled"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-UserType"",""Value"":""0"",""ValueType"":""Edm.String""},{""Key"":""SPS-HideFromAddressLists"",""Value"":""False"",""ValueType"":""Edm.String""},{""Key"":""SPS-RecipientTypeDetails"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""DelveFlags"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""PulseMRUPeople"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""msOnline-ObjectId"",""Value"":""78ccf530-bbf0-47e4-aae6-da5f8c6fb142"",""ValueType"":""Edm.String""},{""Key"":""SPS-PointPublishingUrl"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-TenantInstanceId"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-SharePointHomeExperienceState"",""Value"":""17301504"",""ValueType"":""Edm.String""},{""Key"":""SPS-RefreshToken"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""SPS-MultiGeoFlags"",""Value"":"""",""ValueType"":""Edm.String""},{""Key"":""PreferredDataLocation"",""Value"":"""",""ValueType"":""Edm.String""}]",https://contoso-my.sharepoint.com:443/Person.aspx?accountname=i%3A0%23%2Ef%7Cmembership%7Cjohn%40contoso%2Eonmicrosoft%2Ecom
     ```
 
+=== "Markdown"
 
+    ```md
+    # spo userprofile get --userName "johndoe@mytenant.onmicrosoft.com"
+
+    Date: 4/10/2023
+
+    ## John Doe
+
+    Property | Value
+    ---------|-------
+    AccountName | i:0#.f\|membership\|johndoe@mytenant.onmicrosoft.com
+    DisplayName | John Doe
+    Email | johndoe@mytenant.onmicrosoft.com
+    IsFollowed | false
+    LatestPost | null
+    PersonalSiteHostUrl | https://johndoe-my.sharepoint.com:443/
+    PersonalUrl | https://johndoe-my.sharepoint.com/personal/johndoe\_johndoe\_onmicrosoft\_com/
+    PictureUrl | null
+    Title | null
+    UserUrl | https://johndoe-my.sharepoint.com:443/Person.aspx?accountname=i%3A0%23%2Ef%7Cmembership%7Cjohndoe%40johndoe%2Eonmicrosoft%2Ecom
+    ```

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

@@ -98,3 +98,27 @@ m365 spo web add --title Subsite --url subsite --webTemplate STS#0 --parentWebUr
     Configuration,Created,Description,Id,Language,LastItemModifiedDate,LastItemUserModifiedDate,ServerRelativeUrl,Title,WebTemplate,WebTemplateId
     0,2022-11-05T14:09:11,Subsite,0cbf2896-bac2-4244-b871-68b413ee7b2f,1033,2022-11-05T14:09:22Z,2022-11-05T14:09:22Z,/subsite,Subsite,STS,0
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo web add --title "Subsite" --url "subsite" --webTemplate "STS#0" --parentWebUrl "https://contoso.sharepoint.com" --inheritNavigation "true"
+
+    Date: 4/10/2023
+
+    ## Subsite (261ab6d3-0064-47d8-9189-82e5745d7a7f)
+
+    Property | Value
+    ---------|-------
+    Configuration | 0
+    Created | 2023-04-10T06:38:24
+    Description | 
+    Id | 261ab6d3-0064-47d8-9189-82e5745d7a7f
+    Language | 1033
+    LastItemModifiedDate | 2023-04-10T06:38:32Z
+    LastItemUserModifiedDate | 2023-04-10T06:38:32Z
+    ServerRelativeUrl | /subsite
+    Title | Subsite
+    WebTemplate | STS
+    WebTemplateId | 0
+    ```

package/docs/docs/cmd/spo/web/web-clientsidewebpart-list.md

@@ -51,3 +51,19 @@ m365 spo web clientsidewebpart list --webUrl https://contoso.sharepoint.com
     Id,Name,Title
     9cc0f495-db64-4d74-b06b-a3de16231fe1,9cc0f495-db64-4d74-b06b-a3de16231fe1,Dashboard for Viva Connections
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo web clientsidewebpart list --webUrl "https://contoso.sharepoint.com"
+
+    Date: 4/10/2023
+
+    ## Dashboard for Viva Connections (9cc0f495-db64-4d74-b06b-a3de16231fe1)
+
+    Property | Value
+    ---------|-------
+    Id | 9cc0f495-db64-4d74-b06b-a3de16231fe1
+    Name | 9cc0f495-db64-4d74-b06b-a3de16231fe1
+    Title | Dashboard for Viva Connections        
+    ```