@pnp/cli-microsoft365 6.7.0-beta.f5f5666 → 6.7.0

package/docs/docs/cmd/flow/run/run-get.md

@@ -19,6 +19,9 @@ m365 flow run get [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
+`--includeTriggerInformation`
+: If specified, include information about the trigger details
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -32,6 +35,8 @@ If the Microsoft Flow with the name you specified doesn't exist, you will get th
 
 If the run with the name you specified doesn't exist, you will get the `The provided workflow run name is not valid.` error.
 
+If the option `includeTriggerInformation` is specified, but the trigger does not contain an outputsLink such as for example with a `Recurrence` trigger, this option will be ignored.
+
 ## Examples
 
 Get information about the given run of the specified Power Automate flow
@@ -40,6 +45,11 @@ Get information about the given run of the specified Power Automate flow
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
 
+Get information about the given run of the specified Power Automate flow including trigger information
+
+```sh
+m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --includeTriggerInformation
+```
 
 ## Response
 
@@ -61,7 +71,7 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
         "trigger": {
           "name": "When_a_new_response_is_submitted",
           "inputsLink": {
-            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerInputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=jmdMRWvY7uGoxTmqd3_a2bJtegXuVyuKTKKUVLiwh38",
+            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerInputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=",
             "contentVersion": "6ZrBBE+MJg7IvhMgyJLMmA==",
             "contentSize": 349,
             "contentHash": {
@@ -70,7 +80,7 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
             }
           },
           "outputsLink": {
-            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerOutputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=Y3qqjuWrrcQJrmF7uvm6LVzQy5w-dNOFWJ8Yt8khXvA",
+            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerOutputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=",
             "contentVersion": "Z/4a8tfYygNAR1xpc44iww==",
             "contentSize": 493,
             "contentHash": {
@@ -97,17 +107,108 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 === "Text"
 
     ```text
-    endTime    :
-    name       : 08585329112602833828909892130CU17
-    startTime  : 2022-11-17T14:33:45.2763872Z
-    status     : Running
-    triggerName: When_a_new_response_is_submitted
+    endTime    : 2023-03-04T09:05:22.5880202Z
+    name       : 08585236861638480597867166179CU104
+    startTime  : 2023-03-04T09:05:21.8066368Z
+    status     : Succeeded
+    triggerName: When_an_email_is_flagged_(V4)
     ```
 
 === "CSV"
 
     ```csv
     name,startTime,endTime,status,triggerName
-    08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,,Running,When_a_new_response_is_submitted
+    08585236861638480597867166179CU104,2023-03-04T09:05:21.8066368Z,2023-03-04T09:05:22.5880202Z,Succeeded,When_an_email_is_flagged_(V4)
+    ```
+
+=== "Markdown"
+
+    ```md
+    # flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+
+    Date: 04/03/2023
+
+    ## 08586653536760200319026785874CU62 (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/5923cb07-ce1a-4a5c-ab81-257ce820109a/runs/08586653536760200319026785874CU62)
+
+    Property | Value
+    ---------|-------
+    name | 08586653536760200319026785874CU62
+    id | /providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/c3c707b5-fefd-4f7a-a96c-b8e0d5ca3cc1/runs/08585208964855963748594654409CU47
+    type | Microsoft.ProcessSimple/environments/flows/runs
+    startTime | 2023-03-04T09:05:21.8066368Z
+    endTime | 2023-03-04T09:05:22.5880202Z
+    status | Succeeded
+    triggerName | When\_an\_email\_is\_flagged\_(V4)
+    ```
+
+### `includeTriggerInformation` response
+
+When using the option `includeTriggerInformation`, the response for the json-output will differ.
+
+=== "JSON"
+
+    ```json
+    {
+      "name": "08585236861638480597867166179CU104",
+      "id": "/providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/24335774-daf6-4183-acb7-f5155c2cd2fe/runs/08585236861638480597867166179CU104",
+      "type": "Microsoft.ProcessSimple/environments/flows/runs",
+      "properties": {
+        "startTime": "2023-03-04T09:05:21.8066368Z",
+        "endTime": "2023-03-04T09:05:22.5880202Z",
+        "status": "Succeeded",
+        "correlation": {
+          "clientTrackingId": "08585236861638480598867166179CU131"
+        },
+        "trigger": {
+          "name": "When_an_email_is_flagged_(V4)",
+          "inputsLink": {
+            "uri": "https://prod-130.westeurope.logic.azure.com:443/workflows/3ebadb794f6641e0b7f4fda131cdfb0b/runs/08585236861638480597867166179CU104/contents/TriggerInputs?api-version=2016-06-01&se=2023-03-04T14%3A00%3A00.0000000Z&sp=%2Fruns%2F08585236861638480597867166179CU104%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=",
+            "contentVersion": "2v/VLXFrKV6JvwSdcN7aHg==",
+            "contentSize": 343,
+            "contentHash": {
+              "algorithm": "md5",
+              "value": "2v/VLXFrKV6JvwSdcN7aHg=="
+            }
+          },
+          "outputsLink": {
+            "uri": "https://prod-130.westeurope.logic.azure.com:443/workflows/3ebadb794f6641e0b7f4fda131cdfb0b/runs/08585236861638480597867166179CU104/contents/TriggerOutputs?api-version=2016-06-01&se=2023-03-04T14%3A00%3A00.0000000Z&sp=%2Fruns%2F08585236861638480597867166179CU104%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=",
+            "contentVersion": "AHZEeWNlQ0bLe48yDmpzrQ==",
+            "contentSize": 3478,
+            "contentHash": {
+              "algorithm": "md5",
+              "value": "AHZEeWNlQ0bLe48yDmpzrQ=="
+            }
+          },
+          "startTime": "2023-03-04T09:05:21.6192576Z",
+          "endTime": "2023-03-04T09:05:21.7442626Z",
+          "scheduledTime": "2023-03-04T09:05:21.573561Z",
+          "originHistoryName": "08585236861638480598867166179CU131",
+          "correlation": {
+            "clientTrackingId": "08585236861638480598867166179CU131"
+          },
+          "code": "OK",
+          "status": "Succeeded"
+        }
+      },
+      "startTime": "2023-03-04T09:05:21.8066368Z",
+      "endTime": "2023-03-04T09:05:22.5880202Z",
+      "status": "Succeeded",
+      "triggerName": "When_an_email_is_flagged_(V4)",
+      "triggerInformation": {
+        "from": "john@contoso.com",
+        "toRecipients": "doe@contoso.com",
+        "subject": "Dummy email",
+        "body": "<html><head>\r\\\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"></head><body><p>This is dummy content</p></body></html>",
+        "importance": "normal",
+        "bodyPreview": "This is dummy content",
+        "hasAttachments": false,
+        "id": "AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALUqy81AAA=",
+        "internetMessageId": "<DB7PR03MB5018879914324FC65695809FE1AD9@DB7PR03MB5018.eurprd03.prod.outlook.com>",
+        "conversationId": "AAQkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgAQAMqP9zsK8a1CnIYEgHclLTk=",
+        "receivedDateTime": "2023-03-01T15:06:57+00:00",
+        "isRead": false,
+        "attachments": [],
+        "isHtml": true
+      }
+    }
     ```
-	

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/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        
+    ```