Commands › Exchange Online
Invoke-CalendarEventMigration
This cmdlet is only available in the cloud-based service. Use the Invoke-CalendarEventMigration cmdlet to change the time zone of a meeting or appointment.
Quick start script
# Invoke-CalendarEventMigration — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org
# 2. Run and inspect
Invoke-CalendarEventMigration | Format-List
# 3. Export for evidence / drift tracking
Invoke-CalendarEventMigration | Export-Clixml .\CalendarEventMigration-$(Get-Date -Format yyyyMMdd).xmlParameters (9)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Identity | — | The Identity parameter specifies the mailbox of the current meeting organizer. You can use any value that uniquely identifies the mailbox. For example: | |
| -FromWindowsTimeZoneId | — | The time zone currently on events that need to be migrated. Events scheduled in other time zones will not be migrated. | |
| -ToWindowsTimeZoneId | — | The time zone that events will be migrated to. | |
| -QueryStartDate | — | The start date for the query window. The cmdlet operates on events within the query window. Events before this date will not be migrated. If -QueryStartDate is not provided, the current time is used. | |
| -QueryWindowInDays | — | The length in days for the query window. The cmdlet operates on events within the query window. Events beyond the query window will not be migrated. Valid values are between 1 (1 day) and 1825 (5 years), inclusive. | |
| -Force | — | Sets whether the migration is allowed when the source and destination time zones have different current local times. This check helps prevent accidentally moving meetings to a new time. Use -Force to bypass the check. | |
| -Confirm | — | Prompts you for confirmation before running the cmdlet. | |
| -WhatIf | — | Runs the command in a mode that only reports what would happen without performing the actions. | |
| -PreviewOnly | — | When used, shows matching events that would be migrated without updating them. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.