Skip to main content

SYNOPSIS

Get the working hours configuration of Exchange Online mailboxes.

SYNTAX

DESCRIPTION

This function retrieves the working hours configuration from the calendar settings for Exchange Online mailboxes. It returns the time zone, start/end times, and enabled days for each mailbox. The function can filter mailboxes by identity or by domain.

EXAMPLES

EXAMPLE 1

Retrieves the working hours configuration for all Exchange Online mailboxes.

EXAMPLE 2

Retrieves the working hours configuration for the specified mailbox.

EXAMPLE 3

Retrieves the working hours configuration for all mailboxes in the specified domain.

EXAMPLE 4

Exports results to an Excel file.

PARAMETERS

-ByDomain

The domain to filter mailboxes by. Only mailboxes with a primary SMTP address in this domain will be processed.

-ExportPath

Optional output directory for the Excel export (defaults to the user profile).

-ExportToExcel

If specified, exports the results to an Excel file in the user’s profile directory.

-Identity

The identity of the mailbox to retrieve the working hours configuration for. If not specified, the function retrieves the configuration for all mailboxes.

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

System.String

OUTPUTS

NOTES

Requires connection to Exchange Online using Connect-ExchangeOnline. The function retrieves data from Get-MailboxCalendarConfiguration.