@pnp/cli-microsoft365 6.7.0-beta.f5f5666 → 6.8.0-beta.00c3a00

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-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-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

@@ -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_
@@ -333,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)

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

@@ -45,6 +45,14 @@ m365 purview retentionlabel add [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    This command currently only supports delegated permissions.
+
 ## Examples
 
 Create a retention label that retains documents and deletes them after one year.
@@ -65,18 +73,6 @@ Create an event-based retention label that retains documents as records and dele
 m365 purview retentionlabel add --displayName 'some label' --behaviorDuringRetentionPeriod retain --actionAfterRetentionPeriod delete --retentionDuration 365 --retentionTrigger dateOfEvent --eventTypeName "Contract Expiry"
 ```
 
-## Remarks
-
-!!! attention
-    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
-
-!!! attention
-    This command currently only supports delegated permissions.
-
-## More information
-
-- Create retentionLabel: [https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http](https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http)
-
 ## Response
 
 === "JSON"
@@ -141,3 +137,7 @@ m365 purview retentionlabel add --displayName 'some label' --behaviorDuringReten
     displayName,descriptionForAdmins,descriptionForUsers,isInUse,retentionTrigger,behaviorDuringRetentionPeriod,actionAfterRetentionPeriod,createdDateTime,lastModifiedDateTime,labelToBeApplied,defaultRecordBehavior,id,retentionDuration,createdBy,lastModifiedBy,dispositionReviewStages
     some label,Description for admins,Description for users,,dateLabeled,retain,delete,2022-12-21T09:33:32Z,2022-12-21T09:33:32Z,another label,startLocked,cfc8b132-7aef-45f4-9fcf-3c199090ba2a,"{""days"":365}","{""user"":{""id"":null,""displayName"":""John Doe""}}","{""user"":{""id"":null,""displayName"":""John Doe""}}",[]
     ```
+
+## More information
+
+- Create retentionLabel: [https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http](https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http)

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

@@ -15,14 +15,6 @@ m365 purview retentionlabel get [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Get a retention label
-
-```sh
-m365 purview retentionlabel get --id c37d695e-d581-4ae9-82a0-9364eba4291e
-```
-
 ## Remarks
 
 !!! attention
@@ -31,8 +23,15 @@ m365 purview retentionlabel get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 !!! attention
     This command currently only supports delegated permissions.
 
-## Response
+## Examples
+
+Get a retention label
+
+```sh
+m365 purview retentionlabel get --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
 
+## Response
 
 === "JSON"
 

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

@@ -12,14 +12,6 @@ m365 purview retentionlabel list [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Get a list of retention labels
-
-```sh
-m365 purview retentionlabel list
-```
-
 ## Remarks
 
 !!! attention
@@ -28,8 +20,15 @@ m365 purview retentionlabel list
 !!! attention
     This command currently only supports delegated permissions.
 
-## Response
+## Examples
+
+Get a list of retention labels
+
+```sh
+m365 purview retentionlabel list
+```
 
+## Response
 
 === "JSON"
 

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

@@ -18,14 +18,6 @@ m365 purview retentionlabel remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Examples
-
-Delete a retention label
-
-```sh
-m365 purview retentionlabel remove --id 'e554d69c-0992-4f9b-8a66-fca3c4d9c531'
-```
-
 ## Remarks
 
 !!! attention
@@ -34,6 +26,14 @@ m365 purview retentionlabel remove --id 'e554d69c-0992-4f9b-8a66-fca3c4d9c531'
 !!! attention
     This command currently only supports delegated permissions.
 
+## Examples
+
+Delete a retention label
+
+```sh
+m365 purview retentionlabel remove --id 'e554d69c-0992-4f9b-8a66-fca3c4d9c531'
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -39,6 +39,14 @@ m365 purview retentionlabel set [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    This command currently only supports delegated permissions.
+
 ## Examples
 
 Update a retention label so that it retains documents as records and deletes them after one year.
@@ -53,14 +61,6 @@ Update a retention label so that it retains documents as regulatory records and
 m365 purview retentionlabel set --id c37d695e-d581-4ae9-82a0-9364eba4291e --behaviorDuringRetentionPeriod retainAsRegulatoryRecord --actionAfterRetentionPeriod startDispositionReview --retentionDuration 365 --retentionTrigger dateModified
 ```
 
-## Remarks
-
-!!! attention
-    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
-
-!!! attention
-    This command currently only supports delegated permissions.
-
 ## Response
 
 The command won't return a response on success.