Skip to main content

outlook mailbox settings set

Updates user mailbox settings

Usage​

m365 outlook mailbox settings set [options]

Options​

-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 or IANA time zone identifier. Example: Central Europe Standard Time.

--language [language]

The preferred language for the user. Should follow ISO 639-1 Code. 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 or IANA time zone identifier. 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.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Examples​

Update date, time format and time zone of the signed-in user.

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

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

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.

{
  "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"
    }
  }
}
CTRL + M