@pnp/cli-microsoft365 6.0.0-beta.e031afa → 6.0.0-beta.e7c60af

package/docs/docs/cmd/adaptivecard/adaptivecard-send.md

@@ -116,23 +116,3 @@ Send custom card with card data
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"},{"type":"TextBlock","text":"${description}","wrap":true},{"type":"FactSet","facts":[{"$data":"${properties}","title":"${key}:","value":"${value}"}]}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"${viewUrl}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --cardData '{"title":"Publish Adaptive Card Schema","description":"Now that we have defined the main rules and features of the format, we need to produce a schema and publish it to GitHub. The schema will be the starting point of our reference documentation.","creator":{"name":"Matt Hidinger","profileImage":"https://pbs.twimg.com/profile_images/3647943215/d7f12830b3c17a5a9e4afcc370e3a37e_400x400.jpeg"},"createdUtc":"2017-02-14T06:08:39Z","viewUrl":"https://adaptivecards.io","properties":[{"key":"Board","value":"Adaptive Cards"},{"key":"List","value":"Backlog"},{"key":"Assigned to","value":"Matt Hidinger"},{"key":"Due date","value":"Not set"}]}'
 ```
-
-## Examples for PowerShell
-
-Send custom card with all known options merged
-
-```powershell
-m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card "{\"type\":\"AdaptiveCard\",\"body\":[{\"type\":\"TextBlock\",\"size\":\"Medium\",\"weight\":\"Bolder\",\"text\":\"${title}\"},{\"type\":\"TextBlock\",\"text\":\"${description}\",\"wrap\":true},{\"type\":\"FactSet\",\"facts\":[{\"$data\":\"${properties}\",\"title\":\"${key}:\",\"value\":\"${value}\"}]}],\"actions\":[{\"type\":\"Action.OpenUrl\",\"title\":\"View\",\"url\":\"${actionUrl}\"}],\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"version\":\"1.2\"}" --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif" --actionUrl "https://aka.ms/cli-m365"
-```
-
-Send custom card with unknown option merged
-
-```powershell
-m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card "{\"type\":\"AdaptiveCard\",\"body\":[{\"type\":\"TextBlock\",\"size\":\"Medium\",\"weight\":\"Bolder\",\"text\":\"${Title}\"}],\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"version\":\"1.2\"}" --Title "CLI for Microsoft 365 v3.4"
-```
-
-Send custom card with card data
-
-```powershell
-m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card "{\"type\":\"AdaptiveCard\",\"body\":[{\"type\":\"TextBlock\",\"size\":\"Medium\",\"weight\":\"Bolder\",\"text\":\"${title}\"},{\"type\":\"TextBlock\",\"text\":\"${description}\",\"wrap\":true},{\"type\":\"FactSet\",\"facts\":[{\"$data\":\"${properties}\",\"title\":\"${key}:\",\"value\":\"${value}\"}]}],\"actions\":[{\"type\":\"Action.OpenUrl\",\"title\":\"View\",\"url\":\"${viewUrl}\"}],\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"version\":\"1.2\"}" --cardData "{\"title\":\"Publish Adaptive Card Schema\",\"description\":\"Now that we have defined the main rules and features of the format, we need to produce a schema and publish it to GitHub. The schema will be the starting point of our reference documentation.\",\"creator\":{\"name\":\"Matt Hidinger\",\"profileImage\":\"https://pbs.twimg.com/profile_images/3647943215/d7f12830b3c17a5a9e4afcc370e3a37e_400x400.jpeg\"},\"createdUtc\":\"2017-02-14T06:08:39Z\",\"viewUrl\":\"https://adaptivecards.io\",\"properties\":[{\"key\":\"Board\",\"value\":\"Adaptive Cards\"},{\"key\":\"List\",\"value\":\"Backlog\"},{\"key\":\"Assigned to\",\"value\":\"Matt Hidinger\"},{\"key\":\"Due date\",\"value\":\"Not set\"}]}"
-```

package/docs/docs/cmd/booking/business/business-get.md

@@ -0,0 +1,33 @@
+# booking business get
+
+Retrieve the specified Microsoft Bookings business.
+
+## Usage
+
+```sh
+m365 booking business get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: ID of the business. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: Name of the business. Specify either `id` or `name` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Retrieve the specified Microsoft Bookings business with id _business@contoso.onmicrosoft.com_.
+
+```sh
+m365 booking business get --id 'business@contoso.onmicrosoft.com'
+```
+
+Retrieve the specified Microsoft Bookings business with name _business name_.
+
+```sh
+m365 booking business get --name 'business name'
+```

package/docs/docs/cmd/booking/business/business-list.md

@@ -0,0 +1,21 @@
+# booking business list
+
+Lists all Microsoft Bookings businesses that are created for the tenant.
+
+## Usage
+
+```sh
+m365 booking business list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Returns a list of all Microsoft Bookings businesses that are created for the tenant.
+
+```sh
+m365 booking business list
+```

package/docs/docs/cmd/cli/completion/completion-clink-update.md

@@ -29,4 +29,4 @@ cli completion clink update > m365.lua
 
 ## More information
 
-- Command completion: [https://pnp.github.io/cli-microsoft365/concepts/completion/](https://pnp.github.io/cli-microsoft365/concepts/completion/)
+- 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/completion/completion-pwsh-setup.md

@@ -31,4 +31,4 @@ cli completion pwsh setup --profile $profile
 
 ## More information
 
-- Command completion: [https://pnp.github.io/cli-microsoft365/concepts/completion/](https://pnp.github.io/cli-microsoft365/concepts/completion/)
+- 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/completion/completion-pwsh-update.md

@@ -26,4 +26,4 @@ cli completion pwsh update
 
 ## More information
 
-- Command completion: [https://pnp.github.io/cli-microsoft365/concepts/completion/](https://pnp.github.io/cli-microsoft365/concepts/completion/)
+- 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/completion/completion-sh-setup.md

@@ -22,4 +22,4 @@ cli completion sh setup
 
 ## More information
 
-- Command completion: [https://pnp.github.io/cli-microsoft365/concepts/completion/](https://pnp.github.io/cli-microsoft365/concepts/completion/)
+- 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/completion/completion-sh-update.md

@@ -26,4 +26,4 @@ m365 cli completion sh update
 
 ## More information
 
-- Command completion: [https://pnp.github.io/cli-microsoft365/concepts/completion/](https://pnp.github.io/cli-microsoft365/concepts/completion/)
+- Command completion: [https://pnp.github.io/cli-microsoft365/user-guide/completion/](https://pnp.github.io/cli-microsoft365/user-guide/completion/)

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

@@ -13,7 +13,7 @@ m365 flow disable [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to disable
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to disable Power Automate flow
 
 `--asAdmin`
@@ -37,11 +37,11 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
 Disables Power Automate flow owned by the currently signed-in user
 
 ```sh
-m365 flow disable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow disable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Disables Power Automate flow owned by another user
 
 ```sh
-m365 flow disable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
+m365 flow disable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
 ```

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

@@ -13,7 +13,7 @@ m365 flow enable [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to enable
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to enable Power Automate
 
 `--asAdmin`

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

@@ -13,7 +13,7 @@ m365 flow export [options]
 `-i, --id <id>`
 : The id of the Power Automate flow to export
 
-`-e, --environment <environment>`
+`-e, --environmentNameName <environmentName>`
 : The name of the environment for which to export the flow
 
 `-n, --packageDisplayName [packageDisplayName]`
@@ -50,23 +50,23 @@ If the Power Automate flow with the id you specified doesn't exist, you will get
 Export the specified Power Automate flow as a ZIP file
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Export the specified Power Automate flow as a JSON file
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --format json
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --format json
 ```
 
 Export the specified Power Automate flow as a ZIP file, specifying a Display Name of 'My flow name' to be embedded into the package
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName 'My flow name'
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName 'My flow name'
 ```
 
 Export the specified Power Automate flow as a ZIP file with the filename 'MyFlow.zip' saved to the current directory
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --path './MyFlow.zip'
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --path './MyFlow.zip'
 ```

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

@@ -13,7 +13,7 @@ m365 flow get [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to get information about
 
-`-e, --environment <environment>`
+`-e, --environmentNameName <environmentName>`
 : The name of the environment for which to retrieve available flows
 
 `--asAdmin`
@@ -37,11 +37,11 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
 Get information about the specified Power Automate flow owned by the currently signed-in user
 
 ```sh
-m365 flow get --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Get information about the specified Power Automate flow owned by another user
 
 ```sh
-m365 flow get --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
+m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
 ```

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

@@ -10,7 +10,7 @@ m365 flow list [options]
 
 ## Options
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to retrieve available flows
 
 `--asAdmin`
@@ -32,11 +32,11 @@ By default, the `flow list` command returns only your flows. To list all flows,
 List all your flows in the given environment
 
 ```sh
-m365 flow list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```
 
 List all flows in the given environment
 
 ```sh
-m365 flow list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```

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

@@ -13,7 +13,7 @@ m365 flow remove [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to remove
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment to which the flow belongs
 
 `--asAdmin`
@@ -37,23 +37,23 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
 Removes the specified Power Automate flow owned by the currently signed-in user
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Removes the specified Power Automate flow owned by the currently signed-in user without confirmation
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --confirm
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --confirm
 ```
 
 Removes the specified Power Automate flow owned by another user
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
 ```
 
 Removes the specified Power Automate flow owned by another user without confirmation
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin --confirm
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin --confirm
 ```

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

@@ -13,10 +13,10 @@ m365 flow run cancel [options]
 `-n, --name <name>`
 : The name of the run to cancel
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the flow to cancel the run for
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
 --8<-- "docs/cmd/_global.md"
@@ -37,5 +37,5 @@ If the run with the name you specified doesn't exist, you will get the `The work
 Cancel the given run of the specified flow
 
 ```sh
-m365 flow run cancel --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+m365 flow run cancel --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```

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

@@ -13,10 +13,10 @@ m365 flow run get [options]
 `-n, --name <name>`
 : The name of the run to get information about
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the Power Automate flow for which to retrieve information
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
 --8<-- "docs/cmd/_global.md"
@@ -37,5 +37,5 @@ If the run with the name you specified doesn't exist, you will get the `The prov
 Get information about the given run of the specified Power Automate flow
 
 ```sh
-m365 flow run get --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```

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

@@ -10,10 +10,10 @@ m365 flow run list [options]
 
 ## Options
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the Microsoft Flow to retrieve the runs for
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment to which the flow belongs
 
 --8<-- "docs/cmd/_global.md"
@@ -32,5 +32,5 @@ If the Microsoft Flow with the name you specified doesn't exist, you will get th
 List runs of the specified Microsoft Flow
 
 ```sh
-m365 flow run list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a
 ```

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

@@ -13,10 +13,10 @@ m365 flow run resubmit [options]
 `-n, --name <name>`
 : The name of the run to resubmit
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the flow to resubmit the run for
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment where the Flow is located
 
 `--confirm`
@@ -40,11 +40,11 @@ If the run with the name you specified doesn't exist, you will get the `The work
 Resubmits a specific flow run for the specified Microsoft Flow
 
 ```sh
-m365 flow run resubmit --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+m365 flow run resubmit --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
 
 Resubmits a specific flow run for the specified Microsoft Flow without prompting for confirmation
 
 ```sh
-m365 flow run resubmit --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --confirm
+m365 flow run resubmit --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --confirm
 ```

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

@@ -0,0 +1,53 @@
+# graph changelog list
+
+Gets an overview of specific API-level changes in Microsoft Graph v1.0 and beta
+
+## Usage
+
+```sh
+m365 graph changelog list [options]
+```
+
+## Options
+
+`-v, --versions [versions]`
+: Comma-separated list of versions to show changes for. `Beta, v1.0`. When no version is selected all versions are returned.
+
+`-c, --changeType [changeType]`
+: Change type to show changes for. `Addition, Change, Deletion`. When no changeType is selected all change types are returned.
+
+`-s, --services [services]`
+: Comma-separated list of services to show changes for. `Applications, Calendar, Change notifications, Cloud communications, Compliance, Cross-device experiences, Customer booking, Device and app management, Education, Files, Financials, Groups, Identity and access, Mail, Notes, Notifications, People and workplace intelligence, Personal contacts, Reports, Search, Security, Sites and lists, Tasks and plans, Teamwork, To-do tasks, Users, Workbooks and charts`. When no service is selected all services are returned.
+
+`--startDate [startDate]`
+: The startdate used to query for changes. Supported date format is `YYYY-MM-DD`. When no date is specified all changes are returned.
+
+`--endDate [endDate]`
+: The enddate used to query for changes. Supported date format is `YYYY-MM-DD`. When no date is specified all changes are returned.
+
+--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
+
+Get all changes within Microsoft Graph.
+
+```sh
+m365 graph changelog list
+```
+
+Get all changes within Microsoft Graph for the services _Groups_ and _Users_.
+
+```sh
+m365 graph changelog list --services 'Groups,Users'
+```
+
+Get all changes within Microsoft Graph that happend between _2021-01-01_ and _2021-05-01_.
+
+```sh
+m365 graph changelog list --startDate '2021-01-01' --endDate '2021-05-01'
+```

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

@@ -1,4 +1,4 @@
-# onerive report activityusercounts
+# onedrive report activityusercounts
 
 Gets the trend in the number of active OneDrive users
 

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

@@ -0,0 +1,70 @@
+# onenote notebook list
+
+Retrieve a list of notebooks.
+
+## Usage
+
+```sh
+m365 onenote notebook list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: Id of the user. Use either userId or userName, but not both.
+
+`--userName [userName]`
+: Name of the user. Use either userId or userName, but not both.
+
+`--groupId [groupId]`
+: Id of the SharePoint group. Use either groupName or groupId, but not both
+
+`--groupName [groupName]`
+: Name of the SharePoint group. Use either groupName or groupId, but not both.
+
+`-u, --webUrl [webUrl]`
+: URL of the SharePoint site.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List Microsoft OneNote notebooks for the currently logged in user
+
+```sh
+m365 onenote notebook list
+```
+
+List Microsoft OneNote notebooks in group 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
+
+```sh
+m365 onenote notebook list --groupId 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
+```
+
+List Microsoft OneNote notebooks in group My Group
+
+```sh
+m365 onenote notebook list --groupName "MyGroup"
+```
+
+List Microsoft OneNote notebooks for user user1@contoso.onmicrosoft.com
+
+```sh
+m365 onenote notebook list --userName user1@contoso.onmicrosoft.com
+```
+
+List Microsoft OneNote notebooks for user 2609af39-7775-4f94-a3dc-0dd67657e900
+
+```sh
+m365 onenote notebook list --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+```
+
+List Microsoft OneNote notebooks for site https://contoso.sharepoint.com/sites/testsite
+
+```sh
+m365 onenote notebook list --webUrl https://contoso.sharepoint.com/sites/testsite
+```
+
+## 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/outlook/mail/mail-send.md

@@ -1,6 +1,6 @@
-# outlook sendmail
+# outlook mail send
 
-Sends e-mail on behalf of the current user
+Sends an email
 
 ## Usage
 
@@ -8,53 +8,105 @@ Sends e-mail on behalf of the current user
 m365 outlook mail send [options]
 ```
 
-## Alias
-
-```sh
-m365 outlook sendmail [options]
-```
-
 ## Options
 
 `-s, --subject <subject>`
-: E-mail subject
+: Email subject
 
 `-t, --to <to>`
-: Comma-separated list of e-mails to send the message to
+: Comma-separated list of emails to send the message to.
+
+`--cc [cc]`
+: Comma-separated list of CC recipients for the message.
+
+`--bcc [bcc]`
+: Comma-separated list of BCC recipients for the message.
+
+`--sender [sender]`
+: Optional upn or user id to specify what account to send the message from. Also see the remarks section.
+
+`-m, --mailbox [mailbox]`
+: Specify this option to send the email on behalf of another mailbox, for example a shared mailbox, group or distribution list. The sender needs to be a delegate on the specified mailbox. Also see the remarks section.
 
 `--bodyContents <bodyContents>`
-: String containing the body of the e-mail to send
+: String containing the body of the email to send.
 
 `--bodyContentType [bodyContentType]`
-: Type of the body content. Available options: `Text,HTML`. Default `Text`
+: Type of the body content. Available options: `Text,HTML`. Default `Text`.
+
+`--importance [importance]`
+: The importance of the message. Available options: `low`, `normal` or `high`. Default is `normal`.
 
 `--saveToSentItems [saveToSentItems]`
-: Save e-mail in the sent items folder. Default `true`
+: Save email in the sent items folder. Default `true`.
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+### If you are connected using app only authentication
+
+- Always specify a user id or upn in the `--sender` option. The email will be sent as if it came from the specified user, and can optionally be saved in the sent folder of that user account.
+- You can optionally also specify the `--mailbox` option to send mail on behalf of a shared mailbox, group or distribution list. The account used in the `--sender` option, needs to have 'Send on behalf of' permissions on the mailbox in question.
+
+!!! important
+    You need `Mail.Send` application permissions on the Microsoft Graph to be able to send mails using an application identity. 
+
+### If you are connected with a regular user account
+
+- Specify the `--mailbox` option if you want to send an email on behalf of another mailbox. This can be a shared mailbox, group or distribution list. It will be visible in the email that the email was sent by you. You need to be assigned `Send on behalf of` permissions on the mailbox in question.  
+- You can specify the `--sender` option if you want to send an email as if you were the other user.
+The sent email can optionally be saved in the sent folder of that user account. You'll need `Read and manage (Full Access)` permissions on the mailbox of the other user. You can combine the `--sender` and `--mailbox` options to let the other user send a mail on behalf of the specified mailbox.
+
+!!! important
+    You need at least `Mail.Send` delegated permissions on the Microsoft Graph to be able to send emails. When specifying another user as sender, you'll need `Mail.Send.Shared` permissions.
+
 ## Examples
 
-Send a text e-mail to the specified e-mail address
+Send a text email to the specified email address
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site"
 ```
 
-Send an HTML e-mail to the specified e-mail addresses
+Send an HTML email to the specified email addresses
 
 ```sh
 m365 outlook mail send --to "chris@contoso.com,brian@contoso.com" --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the <a href='https://contoso.sharepoint.com/sites/marketing'>team site</a>" --bodyContentType HTML
 ```
 
-Send an HTML e-mail to the specified e-mail address loading e-mail contents from a file on disk
+Send an HTML email to the specified email address loading email contents from a file on disk
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents @email.html --bodyContentType HTML
 ```
 
-Send a text e-mail to the specified e-mail address. Don't store the e-mail in sent items
+Send a text email to the specified email address. Don't store the email in sent items
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --saveToSentItems false
 ```
+
+Send an email on behalf of a shared mailbox using the signed in user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --mailbox sales@contoso.com
+```
+
+Send an email as another user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com
+```
+
+Send an email as another user, on behalf of a shared mailbox
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com --mailbox sales@contoso.com
+```
+
+Send an email with cc and bcc recipients marked as important
+
+```sh
+m365 outlook mail send --to chris@contoso.com --cc claire@contoso.com --bcc randy@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --importance high
+```