@pnp/cli-microsoft365 10.3.0-beta.46a9606 → 10.3.0-beta.737bf17

package/docs/docs/cmd/outlook/mailbox/mailbox-settings-set.mdx

@@ -0,0 +1,166 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook mailbox settings set
+
+Updates user mailbox settings
+
+## Usage
+
+```sh
+m365 outlook mailbox settings set [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --userId [userId]`
+: The ID of the Microsoft Entra user to update mailbox settings for. Either `userId` or `userName` is required when using application permissions.
+
+`-n, --userName [userName]`
+: The UPN of the Microsoft Entra user to update mailbox settings for. Either `userId` or `userName` is required when using application permissions.
+
+`--dateFormat [dateFormat]`
+: The date format for the user's mailbox. Example: `dd.MM.yyyy`.
+
+`--timeFormat [timeFormat]`
+: The time format for the user's mailbox. Example: `H:mm`.
+
+`--timeZone [timeZone]`
+: The default time zone for the user's mailbox. Should follow [Windows time zone name](https://learn.microsoft.com/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11#time-zones) or [IANA time zone identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). Example: `Central Europe Standard Time`.
+
+`--language [language]`
+: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
+
+`--delegateMeetingMessageDeliveryOptions [delegateMeetingMessageDeliveryOptions]`
+: Specifies who can receive meeting messages and meeting responses. Allowed values are `sendToDelegateOnly`, `sendToDelegateAndPrincipal`, or `sendToDelegateAndInformationToPrincipal`.
+
+`--workingDays [workingDays]`
+: The days of the week on which the user works, separated by a comma. Allowed values are `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`, or `sunday`.
+
+`--workingHoursStartTime [workingHoursStartTime]`
+: The time of the day that the user starts working. Example: `09:00`.
+
+`--workingHoursEndTime [workingHoursEndTime]`
+: The time of the day that the user stops working. Example: `17:00`.
+
+`--workingHoursTimeZone [workingHoursTimeZone]`
+: The name of a time zone to which the working hours apply. Should follow [Windows time zone name](https://learn.microsoft.com/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11#time-zones) or [IANA time zone identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). Example: `Central Europe Standard Time`.
+
+`--autoReplyExternalAudience [autoReplyExternalAudience]`
+: Specifies external audience who will receive reply message. Allowed values are `none`, `contactsOnly`, or `all`.
+
+`--autoReplyExternalMessage [autoReplyExternalMessage]`
+: The reply message for the external audience.
+
+`--autoReplyInternalMessage [autoReplyInternalMessage]`
+: The reply message for the audience from the signed-in user's organization.
+
+`--autoReplyStartDateTime [autoReplyStartDateTime]`
+: The date and time that automatic replies are set to begin. Example: `2025-01-06T11:00:00.0000000`.
+
+`--autoReplyStartTimeZone [autoReplyStartTimeZone]`
+: The time zone that automatic replies are set to begin. 
+
+`--autoReplyEndDateTime [autoReplyEndDateTime]`
+: The date and time that automatic replies are set to end. Example: `2025-01-07T11:00:00.0000000`.
+
+`--autoReplyEndTimeZone [autoReplyEndTimeZone]`
+: The time zone that automatic replies are set to end.
+
+`--autoReplyStatus [autoReplyStatus]`
+: The status for automatic replies. Allowed values are `disabled`, `alwaysEnabled`, or `scheduled`.
+```
+
+<Global />
+
+## Examples
+
+Update date, time format and time zone of the signed-in user.
+
+```sh
+m365 outlook mailbox settings set --dateFormat 'dd.MM.yyyy' --timeFormat 'H:mm' --timeZone 'Central Europe Standard Time' --language 'en-US'
+```
+
+Update working hours of a user specified by id
+
+```sh
+m365 outlook mailbox settings set --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --workingDays 'monday,tuesday,thursday,friday' --workingHoursStartTime '08:00' --workingHoursEndTime '16:30' --workingHoursTimeZone 'Central Europe Standard Time'
+```
+
+Set scheduled automatic replies for the internal audience of a user specified by UPN
+
+```sh
+m365 outlook mailbox settings set --userName john.doe@contoso.com --autoReplyExternalAudience none --autoReplyInternalMessage 'On vacation' --autoReplyStartDateTime '2024-08-05T08:00:00.0000000' --autoReplyStartTimeZone 'Central Europe Standard Time' --autoReplyEndDateTime  '2024-08-09T16:00:00.0000000' --autoReplyEndTimeZone 'Central Europe Standard Time' --autoReplyStatus scheduled
+```
+
+## Response
+
+The command returns the updated properties of the user mailbox settings.
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "timeZone": "Central Europe Standard Time",
+    "timeFormat": "H:mm",
+    "dateFormat": "dd.MM.yyyy",
+    "language": {
+      "locale": "en-US",
+      "displayName": "English (United States)"
+    },
+    "workingHours": {
+      "daysOfWeek": [
+        "monday",
+        "tuesday",
+        "wednesday",
+        "thursday",
+        "friday"
+      ],
+      "startTime": "08:00:00.0000000",
+      "endTime": "16:30:00.0000000",
+      "timeZone": {
+        "name": "Central Europe Standard Time"
+      }
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  dateFormat  : dd.MM.yyyy
+  language    : {"locale":"en-US","displayName":"English (United States)"}
+  timeFormat  : H:mm
+  timeZone    : Central Europe Standard Time
+  workingHours: {"daysOfWeek":["monday","tuesday","wednesday","thursday","friday"],"startTime":"08:00:00.0000000","endTime":"16:30:00.0000000","timeZone":{"name":"Central Europe Standard Time"}}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  dateFormat,timeZone,timeFormat
+  dd.MM.yyy,Central Europe Standard Time,H:mm
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook mailbox settings set --dateFormat "dd.MM.yyyy" --timeFormat "H:mm" --timeZone "Central Europe Standard Time" --language "en-US" --workingDays "monday,tuesday,wednesday,thursday,friday" --workingHoursStartTime "08:00:00.0000000" --workingHoursEndTime "16:30:00.0000000" --workingHoursTimeZone "Central Europe Standard Time"
+
+  Date: 1/6/2025
+
+  Property | Value
+  ---------|-------
+  dateFormat | dd.MM.yyyy
+  timeZone | Central Europe Standard Time
+  timeFormat | H:mm
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/list/list-defaultvalue-clear.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo list defaultvalue clear
+
+Clears default column values for a specific document library
+
+## Usage
+
+```sh
+m365 spo list defaultvalue clear [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--fieldName [fieldName]`
+: Internal name of the field to clear over the entire list. Specify either `fieldName` or `folderUrl`, but not both.
+
+`--folderUrl [folderUrl]`
+: Clear all fields of a specific folder by specifying a server- or site-relative URL. Specify either `fieldName` or `folderUrl`, but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove all default column values from a library
+
+```sh
+m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos
+```
+
+Clear a field from all folders of a library
+
+```sh
+m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --field Company
+```
+
+Clear all fields from a specific folder in a library
+
+```sh
+m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --folderUrl "/sites/Marketing/Logos/Contoso"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/list/list-defaultvalue-remove.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo list defaultvalue remove
+
+Removes a specific default column value for a specific document library
+
+## Usage
+
+```sh
+m365 spo list defaultvalue remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--fieldName <fieldName>`
+: Internal name of the field.
+
+`--folderUrl [folderUrl]`
+: Server- or site-relative URL of a specific folder to remove the field from. By default, the root folder of the list is used.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove a default column value from the root folder of the list
+
+```sh
+m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company
+```
+
+Remove a column default value from a specific folder using web-relative URL
+
+```sh
+m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl '/Logos' --fieldName Company --folderUrl '/Logos/Branding'
+```
+
+Remove a column default value from a specific folder by server relative URL
+
+```sh
+m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listId fc6d514f-e7da-47d4-b48b-f72e2fb9c82a --field Company --folderUrl '/sites/Marketing/Logos/Branding'
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/list/list-defaultvalue-set.mdx

@@ -0,0 +1,112 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo list defaultvalue set
+
+Sets default column values for a specific document library
+
+## Usage
+
+```sh
+m365 spo list defaultvalue set [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--fieldName <fieldName>`
+: Internal name of the field.
+
+`--fieldValue <fieldValue>`
+: Default value of the field.
+
+`--folderUrl [folderUrl]`
+: Set the value for a specific folder by specifying a server- or site-relative URL. By default, the root folder of the list is used.
+```
+
+<Global />
+
+# Remarks
+
+:::note
+
+Due to limitations in SharePoint Online, setting default column values for folders with a `#` or `%` character in their path is not supported.
+
+:::
+
+## Examples
+
+Set a default folder value on the root folder of a list for a text field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company --fieldValue Contoso
+```
+
+Set a default folder value for a taxonomy field on a specific folder
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --folderUrl "/sites/Marketing/Logos/Contoso" --fieldName Country --fieldValue "-1;#Belgium|442affc2-7fab-4f33-9590-330403a579c2"
+```
+
+Set a default folder value for a multi-taxonomy field on a specific folder
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/marketing/Logos --folderUrl "/sites/Marketing/Logos/Contoso" --fieldName Countries --fieldValue "-1;#Belgium|442affc2-7fab-4f33-9590-330403a579c2;#-1;#France|14888324-5c48-46db-b748-215cbe24eb4c"
+```
+
+Set a default folder value for a date field to today
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Published --fieldValue "[today]"
+```
+
+Set a default folder value for a date field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Published --fieldValue "2020-05-03T11:00:00Z"
+```
+
+Set a default folder value for a choice field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/marketing/Logos --fieldName FileType --fieldValue Logo
+```
+
+Set a default folder value for a multi-choice field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName FileTypes --fieldValue "Logo;#Brand"
+```
+
+Set a default folder value for a yes/no field using site-relative list URL
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /Logos --fieldName Active --fieldValue 1
+```
+
+Set a default folder value for a user field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Responsible --fieldValue "1;#john.doe@contoso.com"
+```
+
+Set a default folder value for a multi-user field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Responsible --fieldValue "1;#john.doe@contoso.com;#2;#adele.vance@contoso.com"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/tenant/people/people-pronouns-set.mdx

@@ -0,0 +1,82 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people pronouns set
+
+Manage pronouns settings for an organization
+
+## Usage
+
+```sh
+m365 tenant people pronouns set [options]
+```
+
+## Options
+
+```md definition-list
+`-e, --enabled <enabled>`
+: Specifies whether the pronouns are enabled in the organization or not.
+```
+
+<Global />
+
+## Examples
+
+Enable pronouns in the organization
+
+```sh
+m365 tenant people pronouns set --enabled true
+```
+
+Disable pronouns in the organization
+
+```sh
+m365 tenant people pronouns set --enabled false
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "isEnabledInOrganization": true
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  isEnabledInOrganization: true
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  isEnabledInOrganization
+  1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant people pronouns get
+
+  Date: 12/14/2024
+
+  Property | Value
+  ---------|-------
+  isEnabledInOrganization | true
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/api/pronounssettings-update

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "10.3.0-beta.46a9606",
+  "version": "10.3.0-beta.737bf17",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",