@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.9.0-beta.289ab69

package/docs/docs/cmd/cli/completion/completion-sh-setup.md

@@ -40,6 +40,12 @@ m365 cli completion sh setup
     Command completion successfully registered. Restart your shell to load the completion
     ```
 
+=== "Markdown"
+
+    ```md
+    Command completion successfully registered. Restart your shell to load the completion
+    ```
+
 ## More information
 
 - Command completion: [https://pnp.github.io/cli-microsoft365/user-guide/completion/](https://pnp.github.io/cli-microsoft365/user-guide/completion/)

package/docs/docs/cmd/cli/config/config-get.md

@@ -51,6 +51,12 @@ When retrieving the `output` key, responses will look like this:
     json
     ```
 
+=== "Markdown"
+
+    ```md
+    json
+    ```
+
 ## More information
 
 - [Configuring the CLI for Microsoft 365](../../../user-guide/configuring-cli.md)

package/docs/docs/cmd/docs.md

@@ -0,0 +1,51 @@
+# docs
+
+Returns the CLI for Microsoft 365 docs webpage URL
+
+## Usage
+
+```sh
+m365 docs [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+Configure `autoOpenLinksInBrowser` using [cli config set](../cmd/cli/config/config-set.md) to automatically open the webpage in the default browser.
+
+## Examples
+
+Returns the CLI for Microsoft 365 docs webpage URL
+
+```sh
+m365 docs
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    "https://pnp.github.io/cli-microsoft365/"
+    ```
+
+=== "Text"
+
+    ```text
+    https://pnp.github.io/cli-microsoft365/
+    ```
+
+=== "CSV"
+
+    ```csv
+    https://pnp.github.io/cli-microsoft365/
+    ```
+
+=== "Markdown"
+
+    ```md
+    https://pnp.github.io/cli-microsoft365/
+    ```

package/docs/docs/cmd/flow/environment/environment-list.md

@@ -121,3 +121,21 @@ m365 flow environment list
     name,displayName
     d87a7535-dd31-4437-bfe1-95340acd55c5,Contoso Environment
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow environment list
+
+    Date: 2023-05-18
+
+    ## Contoso Environment (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4)
+
+    Property | Value
+    ---------|-------
+    name | Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+    location | europe
+    type | Microsoft.ProcessSimple/environments
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+    displayName | Contoso Environment
+    ```

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

@@ -417,3 +417,23 @@ m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --n
     name,displayName,description,triggers,actions
     ca76d7b8-3b76-4050-8c03-9fb310ad172f,My Flow,,OpenApiConnection,"OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem"
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow get --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4" --name "ca76d7b8-3b76-4050-8c03-9fb310ad172f"
+
+    Date: 2023-05-18
+
+    ## My Flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f)
+
+    Property | Value
+    ---------|-------
+    name | ca76d7b8-3b76-4050-8c03-9fb310ad172f
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f
+    type | Microsoft.ProcessSimple/environments/flows
+    displayName | My Flow
+    description | My Flow
+    triggers | OpenApiConnection
+    actions | OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem
+    ```

package/docs/docs/cmd/flow/flow-list.md

@@ -147,3 +147,20 @@ m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --
     name,displayName
     00afcb83-df7b-4fe0-ab9c-1542a1dc66a9,Contoso Invoicing Flow
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow list --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
+
+    Date: 2023-05-18
+
+    ## Contoso Invoicing Flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9)
+
+    Property | Value
+    ---------|-------
+    name | 00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
+    type | Microsoft.ProcessSimple/environments/flows
+    displayName | Contoso Invoicing Flow
+    ```

package/docs/docs/cmd/graph/changelog/changelog-list.md

@@ -51,3 +51,55 @@ Get all changes within Microsoft Graph that happend between _2021-01-01_ and _20
 ```sh
 m365 graph changelog list --startDate '2021-01-01' --endDate '2021-05-01'
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "guid": "2693683c-f49a-4715-a649-edadd3f54aadv1.0",
+        "category": "v1.0",
+        "title": "Teamwork and communications",
+        "description": "Added the **chatMessageActions** enumeration type.\r\\\nAdded the [chatMessageHistoryItem](https://learn.microsoft.com/en-us/graph/api/resources/chatMessageHistoryItem?view=graph-rest-1.0) resource type.\r\\\nAdded the **messageHistory** property to the [chatMessage](https://learn.microsoft.com/en-us/graph/api/resources/chatMessage?view=graph-rest-1.0) resource.\r\\\n",
+        "pubDate": "2023-05-18T23:04:05.000Z"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    category  title                        description
+    --------  ---------------------------  ----------------------------------------------
+    v1.0      Teamwork and communications  Added the chatMessageActions enumeration type.
+    ```
+
+=== "CSV"
+
+    ```csv
+    guid,category,title,description
+    2693683c-f49a-4715-a649-edadd3f54aadv1.0,v1.0,Teamwork and communications,"Added the **chatMessageActions** enumeration type.
+    Added the [chatMessageHistoryItem](https://learn.microsoft.com/en-us/graph/api/resources/chatMessageHistoryItem?view=graph-rest-1.0) resource type.
+    Added the **messageHistory** property to the [chatMessage](https://learn.microsoft.com/en-us/graph/api/resources/chatMessage?view=graph-rest-1.0) resource.
+    ```
+
+=== "Markdown"
+
+    ```md
+    # graph changelog list 
+
+    Date: 2023-05-22
+
+    ## Teamwork and communications
+
+    Property | Value
+    ---------|-------
+    guid | 2693683c-f49a-4715-a649-edadd3f54aadv1.0
+    category | v1.0
+    title | Teamwork and communications
+    description | Added the \*\*chatMessageActions\*\* enumeration type.
+    <br>Added the [chatMessageHistoryItem](https://learn.microsoft.com/en-us/graph/api/resources/chatMessageHistoryItem?view=graph-rest-1.0) resource type.
+    <br>Added the \*\*messageHistory\*\* property to the [chatMessage](https://learn.microsoft.com/en-us/graph/api/resources/chatMessage?view=graph-rest-1.0) resource.
+    ```

package/docs/docs/cmd/graph/schemaextension/schemaextension-add.md

@@ -59,3 +59,64 @@ Create a schema extension with a verified domain
 ```sh
 m365 graph schemaextension add --id contoso_MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties '[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]'
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "extb4lob7o4_MySchemaExtension",
+      "description": "My Schema Extension",
+      "targetTypes": [
+        "Group"
+      ],
+      "status": "InDevelopment",
+      "owner": "19b5bd1f-3d5e-404a-80f5-ca840b40a082",
+      "properties": [
+        {
+          "name": "myProp1",
+          "type": "Integer"
+        },
+        {
+          "name": "myProp2",
+          "type": "String"
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    description: My Schema Extension
+    id         : extuf4mntoy_MySchemaExtension
+    owner      : 19b5bd1f-3d5e-404a-80f5-ca840b40a082
+    properties : [{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]
+    status     : InDevelopment
+    targetTypes: ["Group"]
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,description,status,owner
+    extlywhx1h4_MySchemaExtension,My Schema Extension,InDevelopment,19b5bd1f-3d5e-404a-80f5-ca840b40a082
+    ```
+
+=== "Markdown"
+
+    ```md
+    # graph schemaextension add --id "MySchemaExtension" --description "My Schema Extension" --targetTypes "Group" --owner "19b5bd1f-3d5e-404a-80f5-ca840b40a082" --properties "[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]"
+
+    Date: 2023-05-22
+
+    ## extnevl1fo8_MySchemaExtension
+
+    Property | Value
+    ---------|-------
+    id | extnevl1fo8\_MySchemaExtension
+    description | My Schema Extension
+    status | InDevelopment
+    owner | 19b5bd1f-3d5e-404a-80f5-ca840b40a082
+    ```

package/docs/docs/cmd/graph/schemaextension/schemaextension-get.md

@@ -27,3 +27,64 @@ Gets properties of a schema extension definition with ID domain_myExtension
 ```sh
 m365 graph schemaextension get --id domain_myExtension 
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "extuf4mntoy_MySchemaExtension",
+      "description": "My Schema Extension",
+      "targetTypes": [
+        "Group"
+      ],
+      "status": "InDevelopment",
+      "owner": "19b5bd1f-3d5e-404a-80f5-ca840b40a082",
+      "properties": [
+        {
+          "name": "myProp1",
+          "type": "Integer"
+        },
+        {
+          "name": "myProp2",
+          "type": "String"
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    description: My Schema Extension
+    id         : extuf4mntoy_MySchemaExtension
+    owner      : 19b5bd1f-3d5e-404a-80f5-ca840b40a082
+    properties : [{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]
+    status     : InDevelopment
+    targetTypes: ["Group"]
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,description,status,owner
+    extuf4mntoy_MySchemaExtension,My Schema Extension,InDevelopment,19b5bd1f-3d5e-404a-80f5-ca840b40a082
+    ```
+
+=== "Markdown"
+
+    ```md
+    # graph schemaextension get --id "extuf4mntoy_MySchemaExtension"
+
+    Date: 2023-05-22
+
+    ## extuf4mntoy_MySchemaExtension
+
+    Property | Value
+    ---------|-------
+    id | extuf4mntoy\_MySchemaExtension
+    description | My Schema Extension
+    status | InDevelopment
+    owner | 19b5bd1f-3d5e-404a-80f5-ca840b40a082
+    ```

package/docs/docs/cmd/graph/schemaextension/schemaextension-list.md

@@ -48,6 +48,67 @@ Get a list of schemaExtension objects created in the current tenant, with owner
 m365 graph schemaextension list --owner 617720dc-85fc-45d7-a187-cee75eaf239e --pageNumber 2 --pageSize 10
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "adatumisv_exo2",
+        "description": "sample description",
+        "targetTypes": [
+          "Message"
+        ],
+        "status": "Available",
+        "owner": "617720dc-85fc-45d7-a187-cee75eaf239e",
+        "properties": [
+          {
+            "name": "p1",
+            "type": "String"
+          },
+          {
+            "name": "p2",
+            "type": "String"
+          }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id              description         targetTypes  status     owner                                 properties                                                                                                                  
+    --------------  ------------------  -----------  ---------  ------------------------------------  --------------------------------------------------------------
+    adatumisv_exo2  sample description  Message      Available  617720dc-85fc-45d7-a187-cee75eaf239e  [{"name":"p1","type":"String"},{"name":"p2","type":"String"}]
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,description,status,owner,properties
+    adatumisv_exo2,sample description,Available,617720dc-85fc-45d7-a187-cee75eaf239e,"[{""name"":""p1"",""type"":""String""},{""name"":""p2"",""type"":""String""}]"
+    ```
+
+=== "Markdown"
+
+    ```md
+    # graph schemaextension list
+
+    Date: 2023-05-22
+
+    ## adatumisv_exo2
+
+    Property | Value
+    ---------|-------
+    id | adatumisv\_exo2
+    description | sample description
+    status | Available
+    owner | 617720dc-85fc-45d7-a187-cee75eaf239e
+    properties | [{"name":"p1","type":"String"},{"name":"p2","type":"String"}]
+    ```
+
 ## More information
 
 [https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/schemaextension_list](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/schemaextension_list)

package/docs/docs/cmd/graph/schemaextension/schemaextension-remove.md

@@ -36,3 +36,7 @@ Removes specified Microsoft Graph schema extension with ID domain_myExtension wi
 ```sh
 m365 graph schemaextension remove --id domain_myExtension --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/graph/schemaextension/schemaextension-set.md

@@ -58,3 +58,7 @@ Change the status of a schema extension to 'Available'
 ```sh
 m365 graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --status Available
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/graph/subscription/subscription-add.md

@@ -62,3 +62,76 @@ Create a subscription using the maximum allowed expiration for Group resources
 ```sh
 m365 graph subscription add --resource groups --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "d2df2c16-26ee-4431-ab22-3b133556fb26",
+      "resource": "groups",
+      "applicationId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
+      "changeType": "updated",
+      "clientState": "some secret value",
+      "notificationUrl": "https://webhook.azurewebsites.net/api/changeNotificationHook",
+      "notificationQueryOptions": null,
+      "lifecycleNotificationUrl": null,
+      "expirationDateTime": "2023-05-23T18:23:45.935Z",
+      "creatorId": "0649d0bd-53dc-4e1d-a357-76f1d92d447b",
+      "includeResourceData": null,
+      "latestSupportedTlsVersion": "v1_2",
+      "encryptionCertificate": null,
+      "encryptionCertificateId": null,
+      "notificationUrlAppId": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    applicationId            : 31359c7f-bd7e-475c-86db-fdb8c937548e
+    changeType               : updated
+    clientState              : some secret value
+    creatorId                : 0649d0bd-53dc-4e1d-a357-76f1d92d447b
+    encryptionCertificate    : null
+    encryptionCertificateId  : null
+    expirationDateTime       : 2023-05-23T18:23:45.935Z
+    id                       : e2484150-c26d-4ad6-af45-84ccf6ac985a
+    includeResourceData      : null
+    latestSupportedTlsVersion: v1_2
+    lifecycleNotificationUrl : null
+    notificationQueryOptions : null
+    notificationUrl          : https://webhook.azurewebsites.net/api/changeNotificationHook
+    notificationUrlAppId     : null
+    resource                 : groups
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,resource,applicationId,changeType,clientState,notificationUrl,expirationDateTime,creatorId,latestSupportedTlsVersion
+    34270781-91cf-48ab-a930-072c5eedf808,groups,31359c7f-bd7e-475c-86db-fdb8c937548e,updated,some secret value,https://webhook.azurewebsites.net/api/changeNotificationHook,2023-05-23T18:23:45.935Z,0649d0bd-53dc-4e1d-a357-76f1d92d447b,v1_2
+    ```
+
+=== "Markdown"
+
+    ```md
+    # graph subscription add --resource "groups" --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/changeNotificationHook" --expirationDateTime "2023-05-23T18:23:45.935Z" --clientState "some secret value"
+
+    Date: 2023-05-22
+
+    ## 01d62711-6503-4b5b-8500-a5af0ee3967a
+
+    Property | Value
+    ---------|-------
+    id | 01d62711-6503-4b5b-8500-a5af0ee3967a
+    resource | groups
+    applicationId | 31359c7f-bd7e-475c-86db-fdb8c937548e
+    changeType | updated
+    clientState | some secret value
+    notificationUrl | https://webhook.azurewebsites.net/api/changeNotificationHook
+    expirationDateTime | 2023-05-23T18:23:45.935Z
+    creatorId | 0649d0bd-53dc-4e1d-a357-76f1d92d447b
+    latestSupportedTlsVersion | v1\_2
+    ```

package/docs/docs/cmd/login.md

@@ -46,7 +46,7 @@ m365 login [options]
 
 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).
+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-microsoft-365.md).
 
 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.