Invoke-CalendarEventMigration
Questo cmdlet è disponibile solo nel servizio basato su cloud.
Usare il cmdlet Invoke-CalendarEventMigration per modificare il fuso orario di una riunione o di un appuntamento.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
TimeZoneMigration (Impostazione predefinita)
Invoke-CalendarEventMigration
[-Identity] <MailboxIdParameter>
-FromWindowsTimeZoneId <string>
-ToWindowsTimeZoneId <string>
-QueryWindowInDays <int>
[-QueryStartDate <DateTime>]
[-Force]
[-PreviewOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Quando viene rilasciato un nuovo fuso orario, gli utenti di Outlook interessati devono aggiornare gli eventi pianificati per usare il nuovo fuso orario. Il cmdlet Invoke-CalendarEventMigration consente agli amministratori IT di automatizzare la migrazione degli eventi del calendario creando uno script che scorre tra gli utenti interessati. Invoke-CalendarEventMigration opera su una cassetta postale alla volta ed esegue la migrazione delle riunioni da un fuso orario a un altro mantenendo la stessa ora locale. Ad esempio, una riunione alle 9:00 (ora standard del Pacifico) viene migrata alle 9:00 (ora standard) della Columbia Britannica.
La versione iniziale supporta solo riunioni e appuntamenti a istanza singola. Il supporto per riunioni e appuntamenti ricorrenti verrà fornito nella prossima versione. È possibile rieseguire il cmdlet in sicurezza quando viene aggiunto il supporto per gli eventi ricorrenti.
Vengono migrate solo le riunioni in cui la cassetta postale è l'organizzatore. Le riunioni in cui la cassetta postale è un partecipante devono essere migrate dall'organizzatore, manualmente o eseguendo il cmdlet nella cassetta postale dell'organizzatore. Le riunioni migrate generano un messaggio di aggiornamento della riunione per i partecipanti, in modo che i rispettivi calendari riflettano la modifica del fuso orario.
Vengono migrati solo gli eventi nella cartella Calendar predefinita. Gli eventi nei calendari secondari non vengono migrati.
È possibile eseguire nuovamente l'esecuzione in modo sicuro dopo un timeout o quando vengono aggiunte altre funzionalità.
Il cmdlet non modifica il fuso orario della cassetta postale, ovvero il fuso orario utilizzato per visualizzare il calendario e pianificare nuovi eventi. Per modificare il fuso orario della cassetta postale, usare Set-MailboxRegionalConfiguration.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se in questo argomento sono elencati tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Invoke-CalendarEventMigration user1@contoso.com -FromWindowsTimeZoneId "Pacific Standard Time" -ToWindowsTimeZoneId "British Columbia Standard Time" -QueryStartDate 2026-11-01 -QueryWindowInDays 365 -Confirm:$false
In questo esempio viene eseguita la migrazione di riunioni e appuntamenti a istanza singola nel calendario principale dell'utente 1 dall'ora standard del Pacifico all'ora standard Columbia Britannica. Vengono migrati solo gli eventi tra il 1° novembre 2026 e il 1° novembre 2027.
Esempio 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 questo esempio viene eseguita la migrazione delle cassette postali interessate User1, User2 e Shared all'ora standard Columbia Britannica. Ogni fuso orario della cassetta postale viene aggiornato all'ora standard Columbia Britannica e le riunioni e gli appuntamenti a istanza singola vengono migrati dall'ora standard dell'area Pacifico all'ora standard Columbia Britannica. Vengono migrati solo gli eventi tra il 1° novembre 2026 e il 1° novembre 2027.
Parametri
-Confirm
Applicabile: Exchange Online
Richiede la conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Applicabile: Exchange Online
Imposta se la migrazione è consentita quando i fusi orari di origine e di destinazione hanno orari locali correnti diversi. Questo controllo consente di evitare di spostare accidentalmente le riunioni a un nuovo orario. Usa -Force per bypassare il controllo.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TimeZoneMigration
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-FromWindowsTimeZoneId
Applicabile: Exchange Online
Il fuso orario che si trova attualmente negli eventi di cui eseguire la migrazione. Gli eventi pianificati in altri fusi orari non verranno migrati.
Eseguire Get-TimeZone -ListAvailable | FT -Property Id per visualizzare l'elenco dei fusi orari supportati.
Proprietà dei parametri
| Tipo: | System.String |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TimeZoneMigration
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Online
Il parametro Identity consente di specificare la cassetta postale dell'organizzatore della riunione corrente. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\Nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
Proprietà dei parametri
| Tipo: | MailboxIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-PreviewOnly
Applicabile: Exchange Online
Se usato, mostra gli eventi corrispondenti di cui verrebbe eseguita la migrazione senza aggiornarli.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TimeZoneMigration
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-QueryStartDate
Applicabile: Exchange Online
La data di inizio della finestra della query. Il cmdlet opera sugli eventi all'interno della finestra di query. Gli eventi precedenti a questa data non verranno migrati. Se non viene specificata -QueryStartDate, viene utilizzata l'ora corrente.
Proprietà dei parametri
| Tipo: | DateTime |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-QueryWindowInDays
Applicabile: Exchange Online
Lunghezza in giorni per la finestra di query. Il cmdlet opera sugli eventi all'interno della finestra di query. Gli eventi oltre la finestra di query non verranno migrati. I valori validi sono compresi tra 1 (1 giorno) e 1825 (5 anni) inclusi.
Proprietà dei parametri
| Tipo: | System.Int32 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TimeZoneMigration
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ToWindowsTimeZoneId
Applicabile: Exchange Online
Fuso orario in cui verrà eseguita la migrazione degli eventi.
Eseguire Get-TimeZone -ListAvailable | FT -Property Id per visualizzare l'elenco dei fusi orari supportati.
Proprietà dei parametri
| Tipo: | System.String |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TimeZoneMigration
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Online
Esegue il comando in una modalità che segnala solo cosa accadrebbe senza eseguire le azioni.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.