@pnp/cli-microsoft365 11.7.0-beta.b67a258 → 11.7.0-beta.ba78c1f

package/docs/docs/cmd/outlook/calendar/calendar-add.mdx

@@ -0,0 +1,165 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendar add
+
+Creates a new calendar for a user
+
+## Usage
+
+```sh
+m365 outlook calendar add [options]
+```
+
+## Options
+
+```md definition-list
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--name <name>`
+: Name of the calendar.
+
+`--calendarGroupId [calendarGroupId]`
+: Id of the group where the calendar will belong. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--calendarGroupName [calendarGroupName]`
+: Name of the group where the calendar will belong. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--color [color]`
+: The color of the calendar in UI. Allowed values are `auto`, `lightBlue`, `lightGreen`, `lightOrange`, `lightGray`, `lightYellow`, `lightTeal`, `lightPink`, `lightBrown`, `lightRed`, `maxColor`. Defaults to `auto`.
+
+`--defaultOnlineMeetingProvider [defaultOnlineMeetingProvider]`
+: The default online meeting provider for meetings sent from the calendar. Allowed values are `none`, `teamsForBusiness`. Defaults to `teamsForBusiness`.
+
+`--default`
+: Specify whether the calendar will be the default calendar for new events.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Create a new calendar for a user in a default calendar's group
+
+```sh
+m365 outlook calendar add --userId '@meId' --name 'Holidays'
+```
+
+Create a new calendar for a user specified by email in a specific calendar group and defined color
+
+```sh
+m365 outlook calendar add --userName 'john.doe@contoso.com' --name 'Interviews' --calendarGroupId 'AAMkADY1YmE3N2FhLWEwMz' --color 'lightBlue'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AQMkAGRlMCQAAAA==",
+    "name": "My Calendars",
+    "color": "auto",
+    "hexColor": "",
+    "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
+    "isDefaultCalendar": false,
+    "changeKey": "fJKVL07sbkmIfHqjbDnRgQACxSYYpw==",
+    "canShare": true,
+    "canViewPrivateItems": true,
+    "canEdit": true,
+    "allowedOnlineMeetingProviders": [
+      "teamsForBusiness"
+    ],
+    "defaultOnlineMeetingProvider": "teamsForBusiness",
+    "isTallyingResponses": false,
+    "isRemovable": true,
+    "owner": {
+      "name": "John Doe",
+      "address": "john.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  allowedOnlineMeetingProviders: ["teamsForBusiness"]
+  canEdit                      : true
+  canShare                     : true
+  canViewPrivateItems          : true
+  changeKey                    : fJKVL07sbkmIfHqjbDnRgQACxSYYug==
+  color                        : auto
+  defaultOnlineMeetingProvider : teamsForBusiness
+  groupClassId                 : 0006f0b7-0000-0000-c000-000000000046
+  hexColor                     :
+  id                           : AQMkAGRlMCQAAAA==
+  isDefaultCalendar            : false
+  isRemovable                  : true
+  isTallyingResponses          : false
+  name                         : My Calendars
+  owner                        : {"name":"John Doe","address":"john.doe@contoso.com"}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name,color,hexColor,groupClassId,isDefaultCalendar,changeKey,canShare,canViewPrivateItems,canEdit,defaultOnlineMeetingProvider,isTallyingResponses,isRemovable
+  AQMkAGRlMCQAAAA==,My Calendars,auto,,0006f0b7-0000-0000-c000-000000000046,0,fJKVL07sbkmIfHqjbDnRgQACxSYYzQ==,1,1,1,teamsForBusiness,0,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook calendar add --userId "893f9116-e024-4bc6-8e98-54c245129485" --name "My Calendars"
+
+  Date: 2/5/2026
+
+  ## My Calendars (AQMkAGRlMCQAAAA==)
+
+  Property | Value
+  ---------|-------
+  id | AQMkAGRlMCQAAAA==
+  name | My Calendars
+  color | auto
+  hexColor |
+  groupClassId | 0006f0b7-0000-0000-c000-000000000046
+  isDefaultCalendar | false
+  changeKey | fJKVL07sbkmIfHqjbDnRgQACxSYY4A==
+  canShare | true
+  canViewPrivateItems | true
+  canEdit | true
+  defaultOnlineMeetingProvider | teamsForBusiness
+  isTallyingResponses | false
+  isRemovable | true
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/outlook/calendar/calendar-get.mdx

@@ -0,0 +1,165 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendar get
+
+Retrieves the calendar of a user or a group.
+
+## Usage
+
+```sh
+m365 outlook calendar get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the calendar. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: Name of the calendar. Specify either `id` or `name`, but not both.
+
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--calendarGroupId [calendarGroupId]`
+: ID of the calendar group. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--calendarGroupName [calendarGroupName]`
+: Name of the calendar group. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Calendar.ReadBasic |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Calendar.ReadBasic |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Get the calendar for the current signed-in user by id.
+
+```sh
+m365 outlook calendar get --userId "@meId" --id "AAMkAGI2TGuLAAA=" 
+```
+
+Get the calendar from a specific calendar group for the current signed-in user by name.
+
+```sh
+m365 outlook calendar get --userId "@meId" --calendarGroupName "Colleague calendars" --name "Calendar" 
+```
+
+Get the calendar from a specific calendar group for a specific user by name.
+
+```sh
+m365 outlook calendar get --userId b743445a-112c-4fda-9afd-05943f9c7b36 --calendarGroupId "AAMkADIxYjJiYmIzLTFmNjYtNGNhMy0YOkcEEh3vhfAAAGgdFjAAA="  --name "Calendar" 
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AQMkAGRAAAA==",
+    "name": "Calendar",
+    "color": "lightOrange",
+    "hexColor": "#f7630c",
+    "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
+    "isDefaultCalendar": true,
+    "changeKey": "fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==",
+    "canShare": true,
+    "canViewPrivateItems": true,
+    "canEdit": true,
+    "allowedOnlineMeetingProviders": [
+      "teamsForBusiness"
+    ],
+    "defaultOnlineMeetingProvider": "teamsForBusiness",
+    "isTallyingResponses": true,
+    "isRemovable": false,
+    "owner": {
+      "name": "John Doe",
+      "address": "john.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  allowedOnlineMeetingProviders: ["teamsForBusiness"]
+  canEdit                      : true
+  canShare                     : true
+  canViewPrivateItems          : true
+  changeKey                    : fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==
+  color                        : lightOrange
+  defaultOnlineMeetingProvider : teamsForBusiness
+  groupClassId                 : 0006f0b7-0000-0000-c000-000000000046
+  hexColor                     : #f7630c
+  id                           : AQMkAGRAAAA==
+  isDefaultCalendar            : true
+  isRemovable                  : false
+  isTallyingResponses          : true
+  name                         : Calendar
+  owner                        : {"name":"John Doe","address":"john.doe@contoso.com"}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name,color,hexColor,groupClassId,isDefaultCalendar,changeKey,canShare,canViewPrivateItems,canEdit,defaultOnlineMeetingProvider,isTallyingResponses,isRemovable
+  AQMkAGRAAAA==,Calendar,lightOrange,#f7630c,0006f0b7-0000-0000-c000-000000000046,1,fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==,1,1,1,teamsForBusiness,1,0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook calendar get --name "Calendar" --userName "john.doe@contoso.com"
+
+  Date: 2/9/2026
+
+  ## Calendar (AQMkAGRAAAA==)
+
+  Property | Value
+  ---------|-------
+  id | AQMkAGRAAAA==
+  name | Calendar
+  color | lightOrange
+  hexColor | #f7630c
+  groupClassId | 0006f0b7-0000-0000-c000-000000000046
+  isDefaultCalendar | true
+  changeKey | fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==
+  canShare | true
+  canViewPrivateItems | true
+  canEdit | true
+  defaultOnlineMeetingProvider | teamsForBusiness
+  isTallyingResponses | true
+  isRemovable | false
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/outlook/calendar/calendar-remove.mdx

@@ -0,0 +1,86 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendar remove
+
+Removes the calendar of a user.
+
+## Usage
+
+```sh
+m365 outlook calendar remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the calendar. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: Name of the calendar. Specify either `id` or `name`, but not both.
+
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--calendarGroupId [calendarGroupId]`
+: ID of the calendar group. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--calendarGroupName [calendarGroupName]`
+: Name of the calendar group. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--permanent`
+: Permanently remove the calendar, don't send it to the recycle bin.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Remove the calendar for the current signed-in user by id.
+
+```sh
+m365 outlook calendar remove --userId "@meId" --id "AAMkAGI2TGuLAAA=" 
+```
+
+Permanently remove the calendar from a specific calendar group for the current signed-in user by name.
+
+```sh
+m365 outlook calendar remove --userId "@meId" --calendarGroupName "Colleague calendars" --name "Calendar"  --permanent
+```
+
+Remove the calendar from a specific calendar group for a specific user by name.
+
+```sh
+m365 outlook calendar remove --userId b743445a-112c-4fda-9afd-05943f9c7b36 --calendarGroupId "AAMkADIxYjJiYmIzLTFmNjYtNGNhMy0YOkcEEh3vhfAAAGgdFjAAA="  --name "Calendar" 
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/outlook/calendar/calendar-set.mdx

@@ -0,0 +1,178 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendar set
+
+Updates a calendar for a user.
+
+## Usage
+
+```sh
+m365 outlook calendar set [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the calendar.
+
+`-n, --name [name]`
+: New name of the calendar.
+
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--calendarGroupId [calendarGroupId]`
+: ID of the calendar group where the calendar belongs. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--calendarGroupName [calendarGroupName]`
+: Name of the calendar group where the calendar belongs. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--color [color]`
+: The color of the calendar in the UI. Allowed values: `auto`, `lightBlue`, `lightGreen`, `lightOrange`, `lightGray`, `lightYellow`, `lightTeal`, `lightPink`, `lightBrown`, `lightRed`, `maxColor`.
+
+`--isDefault [isDefault]`
+: Mark whether the calendar is the user's default calendar. Allowed values: `true`, `false`.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                     |
+  |-----------------|-------------------------------------------------|
+  | Microsoft Graph | Calendars.ReadWrite, Calendars.ReadWrite.Shared |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
+:::note
+
+When using delegated permissions, specifying `userId` or `userName` for a different user requires the `Calendars.ReadWrite.Shared` scope. When the specified user matches the signed-in user, no shared scope is needed.
+
+:::
+
+## Examples
+
+Update the name of a calendar for the signed-in user.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --name 'Team planning'
+```
+
+Change the color of a specific calendar for a user by UPN.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --userName 'john.doe@contoso.com' --color 'lightGreen'
+```
+
+Mark a calendar as the default calendar for a user.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --userId 'b743445a-112c-4fda-9afd-05943f9c7b36' --isDefault true
+```
+
+Update a calendar within a specific calendar group by name.
+
+```sh
+m365 outlook calendar set --id 'AAMkAGI2TQpZAAA=' --name 'Team planning' --calendarGroupName 'My Calendars'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AAMkAGI2TQpZAAA=",
+    "name": "Team planning",
+    "color": "auto",
+    "hexColor": "",
+    "isDefaultCalendar": false,
+    "changeKey": "DxYSthXJXEWwAQSYQnXvIgAAIxGttg==",
+    "canShare": true,
+    "canViewPrivateItems": true,
+    "canEdit": true,
+    "allowedOnlineMeetingProviders": [
+      "teamsForBusiness"
+    ],
+    "defaultOnlineMeetingProvider": "teamsForBusiness",
+    "isTallyingResponses": true,
+    "isRemovable": false,
+    "owner": {
+      "name": "John Doe",
+      "address": "john.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  allowedOnlineMeetingProviders: ["teamsForBusiness"]
+  canEdit                      : true
+  canShare                     : true
+  canViewPrivateItems          : true
+  changeKey                    : DxYSthXJXEWwAQSYQnXvIgAAIxGttg==
+  color                        : auto
+  defaultOnlineMeetingProvider : teamsForBusiness
+  hexColor                     :
+  id                           : AAMkAGI2TQpZAAA=
+  isDefaultCalendar            : false
+  isRemovable                  : false
+  isTallyingResponses          : true
+  name                         : Team planning
+  owner                        : {"name":"John Doe","address":"john.doe@contoso.com"}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name,color,hexColor,isDefaultCalendar,changeKey,canShare,canViewPrivateItems,canEdit,defaultOnlineMeetingProvider,isTallyingResponses,isRemovable
+  AAMkAGI2TQpZAAA=,Team planning,auto,,false,DxYSthXJXEWwAQSYQnXvIgAAIxGttg==,true,true,true,teamsForBusiness,true,false
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook calendar set
+
+  Date: 4/2/2026
+
+  Property | Value
+  ---------|-------
+  id | AAMkAGI2TQpZAAA=
+  name | Team planning
+  color | auto
+  hexColor |
+  isDefaultCalendar | false
+  changeKey | DxYSthXJXEWwAQSYQnXvIgAAIxGttg==
+  canShare | true
+  canViewPrivateItems | true
+  canEdit | true
+  defaultOnlineMeetingProvider | teamsForBusiness
+  isTallyingResponses | true
+  isRemovable | false
+  ```
+
+  </TabItem>
+</Tabs>