Invoke-CalendarEventMigration
Dieses Cmdlet steht nur im cloudbasierten Dienst zur Verfügung.
Verwenden Sie das Cmdlet Invoke-CalendarEventMigration, um die Zeitzone einer Besprechung oder eines Termins zu ändern.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
TimeZoneMigration (Standard)
Invoke-CalendarEventMigration
[-Identity] <MailboxIdParameter>
-FromWindowsTimeZoneId <string>
-ToWindowsTimeZoneId <string>
-QueryWindowInDays <int>
[-QueryStartDate <DateTime>]
[-Force]
[-PreviewOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Wenn eine neue Zeitzone freigegeben wird, müssen betroffene Outlook-Benutzer ihre geplanten Ereignisse aktualisieren, um die neue Zeitzone zu verwenden. Mit dem Cmdlet Invoke-CalendarEventMigration können IT-Administratoren die Migration von Kalenderereignissen automatisieren, indem sie ein Skript erstellen, das die betroffenen Benutzer in einer Schleife durchläuft. Invoke-CalendarEventMigration arbeitet jeweils für ein Postfach und migriert Besprechungen von einer Zeitzone in eine andere, wobei die gleiche Ortszeit beibehalten wird. Beispielsweise wird eine Besprechung um 9 Uhr Pacific Standard Time auf 9 Uhr British Columbia Standard Time migriert.
Die erste Version unterstützt nur Einzel-Instance-Besprechungen und -Termine. Unterstützung für wiederkehrende Besprechungen und Termine wird in der nächsten Version bereitgestellt. Sie können das Cmdlet sicher erneut ausführen, wenn Unterstützung für wiederkehrende Ereignisse hinzugefügt wird.
Nur Besprechungen, in denen das Postfach der Organisator ist, werden migriert. Besprechungen, in denen das Postfach ein Teilnehmer ist, müssen vom Organisator entweder manuell oder durch Ausführen des Cmdlets für das Postfach des Organisators migriert werden. Migrierte Besprechungen generieren eine Besprechungsaktualisierungsnachricht für die Teilnehmer, sodass ihre Kalender die Zeitzonenänderung widerspiegeln.
Nur Ereignisse im Standardordner "Calendar" werden migriert. Ereignisse in sekundären Kalendern werden nicht migriert.
Sie können nach einem Timeout oder beim Hinzufügen zusätzlicher Features sicher erneut ausführen.
Das Cmdlet ändert nicht die Zeitzone des Postfachs, bei der es sich um die Zeitzone handelt, die zum Anzeigen des Kalenders und zum Planen neuer Ereignisse verwendet wird. Verwenden Sie Set-MailboxRegionalConfiguration, um die Zeitzone des Postfachs zu ändern.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Thema alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
Invoke-CalendarEventMigration user1@contoso.com -FromWindowsTimeZoneId "Pacific Standard Time" -ToWindowsTimeZoneId "British Columbia Standard Time" -QueryStartDate 2026-11-01 -QueryWindowInDays 365 -Confirm:$false
In diesem Beispiel werden Einzel-instance-Besprechungen und -Termine im primären Kalender von User1 von Pacific Standard Time nach British Columbia Standard Time migriert. Nur Ereignisse zwischen dem 1. November 2026 und dem 1. November 2027 werden migriert.
Beispiel 2
$mailboxes = @(
"user1@contoso.com"
"user2@contoso.com"
"shared@contoso.com"
)
foreach ($mailbox in $mailboxes) {
Set-MailboxRegionalConfiguration -Identity $mailbox -TimeZone "British Columbia Standard Time"
Invoke-CalendarEventMigration -Identity $mailbox `
-FromWindowsTimeZoneId "Pacific Standard Time" `
-ToWindowsTimeZoneId "British Columbia Standard Time" `
-QueryStartDate 2026-11-01 -QueryWindowInDays 365 -Confirm:$false
}
In diesem Beispiel werden die betroffenen Postfächer "User1", "User2" und "Shared" nach British Columbia Standard Time migriert. Jede Postfachzeitzone wird auf British Columbia Standard Time aktualisiert, und Besprechungen und Termine in einzelnen Instanzen werden von Pacific Standard Time nach British Columbia Standard Time migriert. Nur Ereignisse zwischen dem 1. November 2026 und dem 1. November 2027 werden migriert.
Parameter
-Confirm
Anwendbar: Exchange Online
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | cf |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Anwendbar: Exchange Online
Legt fest, ob die Migration zulässig ist, wenn die Quell- und Zielzeitzonen unterschiedliche aktuelle Ortszeiten haben. Durch diese Überprüfung wird verhindert, dass Besprechungen versehentlich in eine neue Zeit verschoben werden. Verwenden Sie -Force, um die Überprüfung zu umgehen.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
TimeZoneMigration
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FromWindowsTimeZoneId
Anwendbar: Exchange Online
Die Zeitzone, in der derzeit Ereignisse gelten, die migriert werden müssen. Ereignisse, die in anderen Zeitzonen geplant sind, werden nicht migriert.
Führen Sie diese aus Get-TimeZone -ListAvailable | FT -Property Id , um die Liste der unterstützten Zeitzonen anzuzeigen.
Parametereigenschaften
| Typ: | System.String |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
TimeZoneMigration
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Online
Der Identity-Parameter gibt das Postfach des aktuellen Besprechungsorganisators an. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\Benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Parametereigenschaften
| Typ: | MailboxIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PreviewOnly
Anwendbar: Exchange Online
Bei Verwendung werden übereinstimmende Ereignisse angezeigt, die ohne Aktualisierung migriert würden.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
TimeZoneMigration
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-QueryStartDate
Anwendbar: Exchange Online
Das Startdatum für das Abfragefenster. Das Cmdlet arbeitet mit Ereignissen im Abfragefenster. Ereignisse vor diesem Datum werden nicht migriert. Wenn -QueryStartDate nicht angegeben wird, wird die aktuelle Uhrzeit verwendet.
Parametereigenschaften
| Typ: | DateTime |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-QueryWindowInDays
Anwendbar: Exchange Online
Die Länge des Abfragefensters in Tagen. Das Cmdlet arbeitet mit Ereignissen im Abfragefenster. Ereignisse außerhalb des Abfragefensters werden nicht migriert. Gültig sind Werte zwischen 1 (1 Tag) und einschließlich 1825 (5 Jahre).
Parametereigenschaften
| Typ: | System.Int32 |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
TimeZoneMigration
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ToWindowsTimeZoneId
Anwendbar: Exchange Online
Die Zeitzone, in die Ereignisse migriert werden.
Führen Sie diese aus Get-TimeZone -ListAvailable | FT -Property Id , um die Liste der unterstützten Zeitzonen anzuzeigen.
Parametereigenschaften
| Typ: | System.String |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
TimeZoneMigration
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Online
Führt den Befehl in einem Modus aus, der nur meldet, was passieren würde, ohne die Aktionen auszuführen.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.