Calendar helpers

Requires an EXO session. For full details and examples, run Get-Help <FunctionName> -Detailed (or -Examples). CSV export commands in this section finish with a success message that includes the generated CSV path, and they do not echo the path as a second pipeline line.

Copy-OoOMessage

Clone automatic reply (out-of-office) settings from one mailbox to another.

Syntax

Copy-OoOMessage -SourceMailbox <String> -DestinationMailbox <String> [-ForceEnable] [-PassThru]

Parameter	Type	Description	Required	Default
SourceMailbox (Identity)	String	Mailbox to read auto-reply configuration from. Pipeline accepted.	Yes	-
DestinationMailbox	String	Mailbox to apply the configuration to.	Yes	-
ForceEnable	Switch	Enable auto-replies immediately on the destination, ignoring source state/schedule.	No	False
PassThru	Switch	Emit the updated destination configuration.	No	False

Example

Copy-OoOMessage -SourceMailbox user1@contoso.com -DestinationMailbox user2@contoso.com -ForceEnable -PassThru

Export-CalendarPermission

Export calendar permissions for one or more mailboxes to CSV (and optionally to the pipeline).

Syntax

Export-CalendarPermission [-SourceMailbox <String[]>] [-SourceDomain <String[]>]
                          [-OutputFolder <String>] [-All] [-PassThru]
                          [-BatchSize <Int32>] [-Resume] [-CsvPath <String>] [-MaxConsecutiveErrors <Int32>]

Parameter	Type	Description	Required	Default
SourceMailbox (Identity)	String[]	Mailboxes to analyze. Pipeline accepted.	No	None (All mailboxes if no scope is provided)
SourceDomain	String[]	Domain filter (includes all matching mailboxes).	No	None (All mailboxes if no scope is provided)
OutputFolder	String	Destination folder for the CSV report. Defaults to current directory.	No	Current directory
All	Switch	Analyze every mailbox (CSV is written).	No	False
PassThru	Switch	Emit the collected permission objects as well as CSV path.	No	False
BatchSize	Int32	Number of processed mailboxes to buffer before flushing the CSV.	No	25
Resume	Switch	Resume from the latest matching CSV or from -CsvPath.	No	False
CsvPath	String	Explicit CSV file to resume. When omitted, the latest matching CSV is used.	No	-
MaxConsecutiveErrors	Int32	Stop after this many consecutive mailbox-level failures.	No	5

Examples

Export-CalendarPermission -SourceMailbox user@contoso.com -OutputFolder C:\Temp

Export-CalendarPermission -SourceDomain contoso.com -OutputFolder C:\Temp -PassThru

Export-CalendarPermission -All -OutputFolder C:\Temp

note

• CSV is saved as yyyyMMdd_M365-CalendarPermissions-Report.csv using module-configured delimiter/encoding.
• Resume skips rows already present in the selected CSV and defaults to the latest matching report in the output folder.
• CSV exports include MailboxIdentity so resume can match the rows more reliably.
• Permissions AvailabilityOnly and None are excluded.
• If no mailbox/domain is specified and -All is not set, the cmdlet scans the entire tenant.

Get-RoomDetails

List room list members with capacity and location details.

Syntax

Get-RoomDetails [-City <String[]>] [-Csv] [-OutputFolder <String>] [-GridView] [-PassThru]

Parameter	Type	Description	Required	Default
City	String[]	Filter room lists whose name/display name matches the provided text.	No	No filter (all room lists)
Csv	Switch	Export results to CSV.	No	False
OutputFolder	String	Destination for CSV; defaults to current directory.	No	Current directory
GridView	Switch	Show results in Out-GridView.	No	False
PassThru	Switch	Emit room detail objects (also when exporting).	No	False

Examples

Get-RoomDetails

Get-RoomDetails -City Milan -Csv -OutputFolder C:\Temp

Get-RoomDetails -GridView

Set-OoO

Enable, schedule, or disable automatic replies on a mailbox.

Syntax

Set-OoO -SourceMailbox <String> [-InternalMessage <String>] [-ExternalMessage <String>]
       [-ExternalAudience <None|Known|All>]
       [-StartTime <DateTime>] [-EndTime <DateTime>] [-ChooseDayFromCalendar]
       [-Disable] [-PassThru]

Parameter	Type	Description	Required	Default
SourceMailbox (Identity)	String	Mailbox to configure. Pipeline accepted.	Yes	-
InternalMessage	String	Message for internal recipients. Defaults to current config/template.	No	Current config/template
ExternalMessage	String	Message for external recipients. Defaults to internal message.	No	InternalMessage
ExternalAudience	String (None/Known/All)	External scope: None, Known, or All.	No	All
StartTime / EndTime	DateTime	Schedule window (both required together).	No	-
ChooseDayFromCalendar	Switch	Pick start/end dates via popups (mutually exclusive with Start/End).	No	False
Disable	Switch	Turn off automatic replies.	No	False
PassThru	Switch	Emit the updated configuration.	No	False

Examples

# Enable immediately
Set-OoO -SourceMailbox user@contoso.com -InternalMessage "<p>Back soon</p>" -ExternalAudience All

# Schedule via parameters
Set-OoO -SourceMailbox user@contoso.com -StartTime "2025-12-27 08:00" -EndTime "2025-12-30 18:00"

# Schedule via calendar popups
Set-OoO -SourceMailbox user@contoso.com -ChooseDayFromCalendar

# Disable
Set-OoO -SourceMailbox user@contoso.com -Disable

warning

• Do not combine -ChooseDayFromCalendar with -StartTime/-EndTime.
• Messages accept HTML; defaults are reused from the current configuration when omitted.