@pnp/cli-microsoft365 6.8.0-beta.e41be56 → 6.8.0

package/docs/docs/cmd/onedrive/report/report-usagestorage.md

@@ -37,3 +37,40 @@ Gets the trend on the amount of storage you are using in OneDrive for Business f
 ```sh
 m365 onedrive report usagestorage --period D7 --output json > "usagestorage.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2023-05-20",
+        "Site Type": "OneDrive",
+        "Storage Used (Byte)": "104122210",
+        "Report Date": "2023-05-20",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period
+    2023-05-20,OneDrive,104122210,2023-05-20,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period
+    2023-05-20,OneDrive,104122210,2023-05-20,7
+    ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period
+    2023-05-20,OneDrive,104122210,2023-05-20,7
+    ```

package/docs/docs/cmd/onenote/notebook/notebook-list.md

@@ -65,6 +65,85 @@ List Microsoft OneNote notebooks for site https://contoso.sharepoint.com/sites/t
 m365 onenote notebook list --webUrl https://contoso.sharepoint.com/sites/testsite
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "1-9cf762f6-b931-4035-8bf3-67c710887c5a",
+        "self": "https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a",
+        "createdDateTime": "2018-11-17T13:06:42Z",
+        "displayName": "TeamsNotebook(Shared)",
+        "lastModifiedDateTime": "2018-11-17T13:06:42Z",
+        "isDefault": false,
+        "userRole": "Owner",
+        "isShared": false,
+        "sectionsUrl": "https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a/sections",
+        "sectionGroupsUrl": "https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a/sectionGroups",
+        "createdBy": {
+          "user": {
+            "id": "0649d0bd-53dc-4e1d-a357-76f1d92d447b",
+            "displayName": "John"
+          }
+        },
+        "lastModifiedBy": {
+          "user": {
+            "id": "0649d0bd-53dc-4e1d-a357-76f1d92d447b",
+            "displayName": "John"
+          }
+        },
+        "links": {
+          "oneNoteClientUrl": {
+            "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/TeamsNotebook(Shared)"
+          },
+          "oneNoteWebUrl": {
+            "href": "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/TeamsNotebook(Shared)"
+          }
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    createdDateTime: 2018-11-17T13:06:42Z
+    displayName    : TeamsNotebook(Shared)
+    id             : 1-9cf762f6-b931-4035-8bf3-67c710887c5a
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,self,createdDateTime,displayName,lastModifiedDateTime,isDefault,userRole,isShared,sectionsUrl,sectionGroupsUrl
+    1-9cf762f6-b931-4035-8bf3-67c710887c5a,https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a,2018-11-17T13:06:42Z,TeamsNotebook(Shared),2018-11-17T13:06:42Z,,Owner,,https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a/sections,https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a/sectionGroups
+    ```
+
+=== "Markdown"
+
+    ```md
+    # onenote notebook list
+
+    Date: 2023-05-22
+
+    ## TeamsNotebook(Shared) (1-9cf762f6-b931-4035-8bf3-67c710887c5a)
+
+    Property | Value
+    ---------|-------
+    id | 1-9cf762f6-b931-4035-8bf3-67c710887c5a
+    self | https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a
+    createdDateTime | 2018-11-17T13:06:42Z
+    displayName | TeamsNotebook(Shared)
+    lastModifiedDateTime | 2018-11-17T13:06:42Z
+    isDefault | false
+    userRole | Owner
+    isShared | false
+    sectionsUrl | https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a/sections
+    sectionGroupsUrl | https://graph.microsoft.com/v1.0/users/0649d0bd-53dc-4e1d-a357-76f1d92d447b/onenote/notebooks/1-9cf762f6-b931-4035-8bf3-67c710887c5a/sectionGroups
+    ```
+
 ## More information
 
 - List notebooks (MS Graph docs): [https://docs.microsoft.com/en-us/graph/api/onenote-list-notebooks?view=graph-rest-1.0&tabs=http](https://docs.microsoft.com/en-us/graph/api/onenote-list-notebooks?view=graph-rest-1.0&tabs=http)

package/docs/docs/cmd/pa/app/app-consent-set.md

@@ -0,0 +1,47 @@
+# pa app consent set
+
+Configures if users can bypass the API Consent window for the selected canvas app
+
+## Usage
+
+```sh
+m365 pa app consent set [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-n, --name <name>`
+: The name of the Power App to update
+
+`-b, --bypass <bypass>`
+: Set to `true` to allow users to bypass the API Consent window. Set to `false` to disable the bypass.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+This command only works for canvas apps.
+
+## Examples
+
+Enables the bypass for the specified canvas app
+
+```sh
+m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass true
+```
+
+Disables the bypass consent for the specified canvas app
+
+```sh
+m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass false --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/planner/plan/plan-get.md

@@ -30,7 +30,7 @@ m365 planner plan get [options]
 ## Remarks
 
 !!! attention
-When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+    When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 
 ## Examples
 

package/docs/docs/cmd/planner/plan/plan-list.md

@@ -24,7 +24,7 @@ m365 planner plan list [options]
 ## Remarks
 
 !!! attention
-When using rosterId, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+    When using rosterId, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 
 ## Examples
 

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

@@ -71,5 +71,6 @@ m365 planner roster add
     assignedSensitivityLabel | null
     ```
 
-## Additional information
+## More information
+
 Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

package/docs/docs/cmd/planner/roster/roster-get.md

@@ -68,6 +68,6 @@ m365 planner roster get --id tYqYlNd6eECmsNhN_fcq85cAGAnd
     assignedSensitivityLabel | null
     ```
 
-## Additional information
+## More information
 
 Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

package/docs/docs/cmd/planner/roster/roster-plan-list.md

@@ -0,0 +1,109 @@
+# planner roster plan list
+
+Lists all Microsoft Planner Roster plans for a specific user
+
+## Usage
+
+```sh
+m365 planner roster plan list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: User's Azure AD ID. Specify either `userId` or `userName` but not both. Specify this option only when using application permissions.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Specify either `userId` or `userName` but not both. Specify this option only when using application permissions.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+List all Planner plans contained in a Roster where the current logged in user is member of.
+
+```sh
+m365 planner roster plan list
+```
+
+List all Planner plans contained in a Roster where specific user is member of by its UPN.
+
+```sh
+m365 planner roster plan list --userName john.doe@contoso.com
+```
+
+List all Planner plans contained in a Roster where specific user is member of by its Id.
+
+```sh
+m365 planner roster plan list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "createdDateTime": "2023-04-06T14:41:49.8676617Z",
+        "owner": "59f80e08-24b1-41f8-8586-16765fd830d3",
+        "title": "My Planner Plan",
+        "creationSource": null,
+        "id": "_5GY9MJpZU2vb3DC46CP3MkACr8m",
+        "createdBy": {
+          "user": {
+            "displayName": null,
+            "id": "59f80e08-24b1-41f8-8586-16765fd830d3"
+          },
+          "application": {
+            "displayName": null,
+            "id": "31359c7f-bd7e-475c-86db-fdb8c937548e"
+          }
+        },
+        "container": {
+          "containerId": "_5GY9MJpZU2vb3DC46CP3MkACr8m",
+          "type": "unknownFutureValue",
+          "url": "https://graph.microsoft.com/beta/planner/rosters/_5GY9MJpZU2vb3DC46CP3MkACr8m"
+        },
+        "contexts": {},
+        "sharedWithContainers": []
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                            title            createdDateTime               owner
+    ----------------------------  ---------------  ----------------------------  ------------------------------------
+    _5GY9MJpZU2vb3DC46CP3MkACr8m  My Planner Plan  2023-04-06T14:41:49.8676617Z  59f80e08-24b1-41f8-8586-16765fd830d3
+    ```
+
+=== "CSV"
+
+    ```csv
+    createdDateTime,owner,title,id
+    2023-04-06T14:41:49.8676617Z,59f80e08-24b1-41f8-8586-16765fd830d3,My Planner Plan,_5GY9MJpZU2vb3DC46CP3MkACr8m
+    ```
+
+=== "Markdown"
+
+    ```md
+    # planner roster plan list --userId "59f80e08-24b1-41f8-8586-16765fd830d3"
+
+    Date: 4/8/2023
+
+    ## My Planner Plan (_5GY9MJpZU2vb3DC46CP3MkACr8m)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2023-04-06T14:41:49.8676617Z
+    owner | 59f80e08-24b1-41f8-8586-16765fd830d3
+    title | My Planner Plan
+    id | \_5GY9MJpZU2vb3DC46CP3MkACr8m
+    ```

package/docs/docs/cmd/planner/roster/roster-remove.md

@@ -44,5 +44,6 @@ m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd --confirm
 
 The command won't return a response on success.
 
-## Additional information
+## More information
+
 Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

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

@@ -8,12 +8,6 @@ Retrieve the specified planner task
 m365 planner task get [options]
 ```
 
-## Alias
-
-```sh
-m365 planner task details get [options]
-```
-
 ## Options
 
 `-i, --id  [id]`

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

@@ -335,7 +335,7 @@ m365 planner task set --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2"  --percentComplete 50
     checklist | {}
     ```
 
-## Additional information
+## More information
 
 - Using order hints in Planner: [https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0)
 - Applied categories in Planner: [https://docs.microsoft.com/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0)

package/docs/docs/cmd/purview/retentionevent/retentionevent-add.md

@@ -49,13 +49,6 @@ Create a retention event to start retention at the end of 2022 for all employee
 m365 purview retentionevent add --displayName 'Employee information expiration' --description 'Employee documents expired due to offboarding' --eventTypeName 'CustomRetentionTime' --triggerDateTime '2022-12-31' --assetIds 'ComplianceAssetId:EmployeeNr1234'
 ```
 
-## More information
-
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
-
-[Read more on event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
-
-
 ## Response
 
 === "JSON"
@@ -147,3 +140,9 @@ This command is part of a series of commands that have to do with event-based re
     createdBy | {"user":{"id":null,"displayName":"John Doe"}}
     lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
     ```
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+
+[Read more on event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)

package/docs/docs/cmd/purview/retentionevent/retentionevent-get.md

@@ -31,13 +31,6 @@ m365 purview retentionevent get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 !!! attention
     This command currently only supports delegated permissions.
 
-## More information
-
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
-
-[Read more on event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
-
-
 ## Response
 
 === "JSON"
@@ -130,3 +123,9 @@ This command is part of a series of commands that have to do with event-based re
     createdBy | {"user":{"id":null,"displayName":"John Doe"}}
     lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
     ```
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+
+[Read more on event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)

package/docs/docs/cmd/purview/retentionevent/retentionevent-list.md

@@ -28,10 +28,6 @@ m365 purview retentionevent list
 !!! attention
     This command currently only supports delegated permissions.
 
-## More information
-
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
-
 ## Response
 
 
@@ -105,3 +101,7 @@ This command is part of a series of commands that have to do with event-based re
     createdBy | {"user":{"id":null,"displayName":"John Doe"}}
     lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
     ```
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.

package/docs/docs/cmd/purview/retentionevent/retentionevent-remove.md

@@ -34,12 +34,12 @@ m365 purview retentionevent remove --id c37d695e-d581-4ae9-82a0-9364eba4291e
 !!! attention
     This command currently only supports delegated permissions.
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
 
 [Read more on event-based retention here](https://learn.microsoft.com/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-add.md

@@ -18,14 +18,6 @@ m365 purview retentioneventtype add [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Create a retention event type *Contract Expiry*.
-
-```sh
-m365 purview retentioneventtype add --displayName 'Contract Expiry' --description 'A retention event type to start a retention period based on the date that a contract expired.'
-```
-
 ## Remarks
 
 !!! attention
@@ -34,9 +26,13 @@ m365 purview retentioneventtype add --displayName 'Contract Expiry' --descriptio
 !!! attention
     This command currently only supports delegated permissions.
 
-## More information
+## Examples
 
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created. [Read more about event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
+Create a retention event type *Contract Expiry*.
+
+```sh
+m365 purview retentioneventtype add --displayName 'Contract Expiry' --description 'A retention event type to start a retention period based on the date that a contract expired.'
+```
 
 ## Response
 
@@ -104,3 +100,7 @@ This command is part of a series of commands that have to do with event-based re
     createdBy | {"user":{"id":null,"displayName":"John Doe"}}
     lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
     ```
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created. [Read more about event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-get.md

@@ -15,14 +15,6 @@ m365 purview retentioneventtype get [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Get a retention event type by id
-
-```sh
-m365 purview retentioneventtype get --id c37d695e-d581-4ae9-82a0-9364eba4291e
-```
-
 ## Remarks
 
 !!! attention
@@ -31,11 +23,13 @@ m365 purview retentioneventtype get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 !!! attention
     This command currently only supports delegated permissions.
 
-## More information
+## Examples
 
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+Get a retention event type by id
 
-[Read more on event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
+```sh
+m365 purview retentioneventtype get --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
 
 ## Response
 
@@ -101,3 +95,9 @@ This command is part of a series of commands that have to do with event-based re
     createdBy | {"user":{"id":null,"displayName":"John Doe"}}
     lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
     ```
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+
+[Read more on event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-list.md

@@ -12,14 +12,6 @@ m365 purview retentioneventtype list [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Get a list of retention event types
-
-```sh
-m365 purview retentioneventtype list
-```
-
 ## Remarks
 
 !!! attention
@@ -28,9 +20,13 @@ m365 purview retentioneventtype list
 !!! attention
     This command currently only supports delegated permissions.
 
-## More information
+## Examples
 
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+Get a list of retention event types
+
+```sh
+m365 purview retentioneventtype list
+```
 
 ## Response
 
@@ -95,3 +91,7 @@ This command is part of a series of commands that have to do with event-based re
     createdBy | {"user":{"id":"36155f4e-bdbd-4101-ba20-5e78f5fba9a9","displayName":null}}
     lastModifiedBy | {"user":{"id":"36155f4e-bdbd-4101-ba20-5e78f5fba9a9","displayName":null}}
     ```
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-remove.md

@@ -18,14 +18,6 @@ m365 purview retentioneventtype remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Delete a retention event type by id
-
-```sh
-m365 purview retentioneventtype remove --id c37d695e-d581-4ae9-82a0-9364eba4291e
-```
-
 ## Remarks
 
 !!! attention
@@ -34,10 +26,18 @@ m365 purview retentioneventtype remove --id c37d695e-d581-4ae9-82a0-9364eba4291e
 !!! attention
     This command currently only supports delegated permissions.
 
-## More information
+## Examples
 
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created. [Read more about event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
+Delete a retention event type by id
+
+```sh
+m365 purview retentioneventtype remove --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
 
 ## Response
 
 The command won't return a response on success.
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created. [Read more about event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-set.md

@@ -18,14 +18,6 @@ m365 purview retentioneventtype set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Update the description of a retention event type
-
-```sh
-m365 purview retentioneventtype set --id c37d695e-d581-4ae9-82a0-9364eba4291e --description 'some extra information'
-```
-
 ## Remarks
 
 !!! attention
@@ -34,10 +26,18 @@ m365 purview retentioneventtype set --id c37d695e-d581-4ae9-82a0-9364eba4291e --
 !!! attention
     This command currently only supports delegated permissions.
 
-## More information
+## Examples
 
-This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created. [Read more about event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
+Update the description of a retention event type
+
+```sh
+m365 purview retentioneventtype set --id c37d695e-d581-4ae9-82a0-9364eba4291e --description 'some extra information'
+```
 
 ## Response
 
 The command won't return a response on success.
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created. [Read more about event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)