Invoke-CalendarEventMigration
Cette applet de commande est uniquement disponible dans le service cloud.
Utilisez l’applet de commande Invoke-CalendarEventMigration pour modifier le fuseau horaire d’une réunion ou d’un rendez-vous.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
TimeZoneMigration (Par défaut)
Invoke-CalendarEventMigration
[-Identity] <MailboxIdParameter>
-FromWindowsTimeZoneId <string>
-ToWindowsTimeZoneId <string>
-QueryWindowInDays <int>
[-QueryStartDate <DateTime>]
[-Force]
[-PreviewOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Lorsqu’un nouveau fuseau horaire est publié, les utilisateurs d’Outlook concernés doivent mettre à jour leurs événements planifiés pour utiliser le nouveau fuseau horaire. L’applet de commande Invoke-CalendarEventMigration permet aux administrateurs informatiques d’automatiser la migration des événements de calendrier en créant un script qui passe en boucle par les utilisateurs affectés. Invoke-CalendarEventMigration fonctionne sur une boîte aux lettres à la fois et migre les réunions d’un fuseau horaire à un autre tout en conservant la même heure locale. Par exemple, une réunion à 9 h, heure standard du Pacifique est migrée vers 9 h, heure standard de la Colombie-Britannique.
La version initiale prend uniquement en charge les réunions et les rendez-vous à instance unique. La prise en charge des réunions et des rendez-vous périodiques sera fournie dans la prochaine version. Vous pouvez réexécuter l’applet de commande en toute sécurité lorsque la prise en charge des événements périodiques est ajoutée.
Seules les réunions où la boîte aux lettres est l’organisateur sont migrées. Les réunions où la boîte aux lettres est un participant doivent être migrées par l’organisateur, soit manuellement, soit en exécutant l’applet de commande sur la boîte aux lettres de l’organisateur. Les réunions migrées génèrent un message de mise à jour de la réunion pour les participants, de sorte que leurs calendriers reflètent le changement de fuseau horaire.
Seuls les événements du dossier Calendar par défaut sont migrés. Les événements des calendriers secondaires ne sont pas migrés.
Vous pouvez réexécuter en toute sécurité après un délai d’expiration ou lorsque des fonctionnalités supplémentaires sont ajoutées.
L’applet de commande ne modifie pas le fuseau horaire de la boîte aux lettres, qui est le fuseau horaire utilisé pour afficher le calendrier et planifier de nouveaux événements. Pour modifier le fuseau horaire de la boîte aux lettres, utilisez Set-MailboxRegionalConfiguration.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Invoke-CalendarEventMigration user1@contoso.com -FromWindowsTimeZoneId "Pacific Standard Time" -ToWindowsTimeZoneId "British Columbia Standard Time" -QueryStartDate 2026-11-01 -QueryWindowInDays 365 -Confirm:$false
Cet exemple migre des réunions et des rendez-vous en instance unique sur le calendrier principal de User1 de l’heure standard du Pacifique vers l’heure standard de la Colombie-Britannique. Seuls les événements survenus entre le 1er novembre 2026 et le 1er novembre 2027 sont migrés.
Exemple 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
}
Cet exemple migre les boîtes aux lettres affectées User1, User2 et Shared to British Columbia Standard Time. Le fuseau horaire de chaque boîte aux lettres est mis à jour sur Colombie-Britannique Standard Les réunions et rendez-vous à instance unique et à heure unique sont migrés de l’heure du Pacifique Standard vers l’heure Standard de la Colombie-Britannique. Seuls les événements survenus entre le 1er novembre 2026 et le 1er novembre 2027 sont migrés.
Paramètres
-Confirm
Applicable : Exchange Online
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Applicable : Exchange Online
Définit si la migration est autorisée lorsque les fuseaux horaires source et de destination ont des heures locales différentes actuellement. Cette case activée permet d’éviter de déplacer accidentellement des réunions à une nouvelle heure. Utilisez -Force pour contourner la case activée.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TimeZoneMigration
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FromWindowsTimeZoneId
Applicable : Exchange Online
Fuseau horaire actuellement sur les événements qui doivent être migrés. Les événements planifiés dans d’autres fuseaux horaires ne seront pas migrés.
Exécutez Get-TimeZone -ListAvailable | FT -Property Id pour afficher la liste des fuseaux horaires pris en charge.
Propriétés du paramètre
| Type: | System.String |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TimeZoneMigration
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Online
Le paramètre Identity spécifie la boîte aux lettres de l’organisateur actuel de la réunion. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Propriétés du paramètre
| Type: | MailboxIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-PreviewOnly
Applicable : Exchange Online
Lorsqu’il est utilisé, affiche les événements correspondants qui seraient migrés sans les mettre à jour.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TimeZoneMigration
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-QueryStartDate
Applicable : Exchange Online
Date de début de la fenêtre de requête. L’applet de commande agit sur les événements dans la fenêtre de requête. Les événements antérieurs à cette date ne seront pas migrés. Si -QueryStartDate n’est pas fourni, l’heure actuelle est utilisée.
Propriétés du paramètre
| Type: | DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-QueryWindowInDays
Applicable : Exchange Online
Durée en jours de la fenêtre de requête. L’applet de commande agit sur les événements dans la fenêtre de requête. Les événements au-delà de la fenêtre de requête ne seront pas migrés. Les valeurs valides sont comprises entre 1 (1 jour) et 1825 (5 ans), inclus.
Propriétés du paramètre
| Type: | System.Int32 |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TimeZoneMigration
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ToWindowsTimeZoneId
Applicable : Exchange Online
Fuseau horaire vers lequel les événements seront migrés.
Exécutez Get-TimeZone -ListAvailable | FT -Property Id pour afficher la liste des fuseaux horaires pris en charge.
Propriétés du paramètre
| Type: | System.String |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TimeZoneMigration
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online
Exécute la commande dans un mode qui signale uniquement ce qui se passerait sans effectuer les actions.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.