Invoke-CalendarEventMigration
此 Cmdlet 僅適用於雲端式服務。
使用 Invoke-CalendarEventMigration Cmdlet 變更會議或約會的時區。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
TimeZoneMigration (預設值)
Invoke-CalendarEventMigration
[-Identity] <MailboxIdParameter>
-FromWindowsTimeZoneId <string>
-ToWindowsTimeZoneId <string>
-QueryWindowInDays <int>
[-QueryStartDate <DateTime>]
[-ExcludeRecurringEvents]
[-ExcludeSingleEvents]
[-Force]
[-PreviewOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
發行新時區時,受影響的 Outlook 使用者必須更新其排程的事件,以使用新的時區。 Invoke-CalendarEventMigration Cmdlet 可讓 IT 系統管理員建立迴圈受影響使用者的指令碼,以自動化行事曆活動移轉。 Invoke-CalendarEventMigration 一次在一個信箱上運作,並將會議從一個時區移轉至另一個時區,同時保持相同的當地時間。 例如,太平洋標準時間上午 9 點的會議會移轉至不列顛哥倫比亞省標準時間上午 9 點。 Cmdlet 也支援移轉週期性會議, (包括一般週期性模式) 的任何例外。
只有移轉以信箱為召集人的會議。 信箱為出席者的會議必須由召集人手動或在召集人信箱上執行 Cmdlet 來移轉。 移轉的會議會為出席者產生會議更新訊息,讓出席者的行事曆反映時區變更。
注意事項
會議更新訊息受到 Exchange Online 中的傳送和接收限制。 針對大型移轉和忙碌的行事曆,請批次執行移轉,並從較小的查詢視窗大小開始,以保持在服務限制內。
只會移轉預設行事曆資料夾中的活動。 次要行事曆中的活動不會移轉。
您可以在逾時之後安全地重新執行。
Cmdlet 不會變更信箱時區,這是用來顯示行事曆及排程新活動的時區。 若要變更信箱時區,請使用 Set-MailboxRegionalConfiguration。
Cmdlet 不會變更工作時區,這是用於在可用性查詢和排程助理員中顯示工作時間的時區。 若要變更工作時區,請使用 Set-MailboxCalendarConfiguration。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Invoke-CalendarEventMigration user1@contoso.com -FromWindowsTimeZoneId "Pacific Standard Time" -ToWindowsTimeZoneId "British Columbia Standard Time" -QueryStartDate 2026-11-01 -QueryWindowInDays 365 -Confirm:$false
此範例會將使用者 1 主要行事曆上的會議和約會從太平洋標準時間移轉至卑詩省標準時間。 僅移轉 2026 年 11 月 1 日到 2027 年 11 月 1 日之間的活動。
範例 2
$mailboxes = @(
"user1@contoso.com"
"user2@contoso.com"
"shared@contoso.com"
)
foreach ($mailbox in $mailboxes) {
Set-MailboxRegionalConfiguration -Identity $mailbox -TimeZone "British Columbia Standard Time"
Set-MailboxCalendarConfiguration -Identity $mailbox -WorkingHoursTimeZone "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
}
本範例會將受影響的信箱 User1、User2 及 Shared 信箱移轉至卑詩省標準時間。 每個信箱時區都會更新為卑詩省標準時間。 工作時間已更新為卑詩省標準時間。 會議和約會已從太平洋標準時間移轉至卑詩省標準時間。 僅移轉 2026 年 11 月 1 日到 2027 年 11 月 1 日之間的活動。
參數
-Confirm
適用對象:Exchange Online
執行 Cmdlet 之前提示您確認。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExcludeRecurringEvents
設定時,週期性事件將不會移轉至新的時區。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TimeZoneMigration
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExcludeSingleEvents
設定時,單一執行個體事件將不會移轉至新的時區。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TimeZoneMigration
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
適用對象:Exchange Online
設定當來源時區和目的地時區具有不同的目前當地時間時,是否允許移轉。 這項檢查有助於防止不小心將會議移至新的時間。 使用 -Force 略過檢查。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TimeZoneMigration
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FromWindowsTimeZoneId
適用對象:Exchange Online
目前發生需要移轉之事件的時區。 排定在其他時區的活動將不會移轉。
執行 Get-TimeZone -ListAvailable | FT -Property Id 以查看支援的時區清單。
參數屬性
| 類型: | System.String |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TimeZoneMigration
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用對象:Exchange Online
Identity 參數會指定目前會議召集人的信箱。 您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 網域\使用者名稱
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
參數屬性
| 類型: | MailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PreviewOnly
適用對象:Exchange Online
使用時,顯示將移轉而不更新的相符事件。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TimeZoneMigration
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QueryStartDate
適用對象:Exchange Online
查詢視窗的開始日期。 Cmdlet 會處理查詢視窗內的事件。 將不會移轉此日期之前的事件。 如果未提供 -QueryStartDate,則使用目前時間。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QueryWindowInDays
適用對象:Exchange Online
查詢視窗的長度(以天為單位)。 Cmdlet 會處理查詢視窗內的事件。 查詢視窗以外的事件將不會移轉。 有效值介於 1 (1 天) 到 1825 (5 年) (含)之間。
參數屬性
| 類型: | System.Int32 |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TimeZoneMigration
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ToWindowsTimeZoneId
適用對象:Exchange Online
事件將移轉到的時區。
執行 Get-TimeZone -ListAvailable | FT -Property Id 以查看支援的時區清單。
參數屬性
| 類型: | System.String |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TimeZoneMigration
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseCustomRouting
設定時,執行會略過 Proxy 伺服器,並在目標信箱的伺服器上完成。 通常不建議這樣做,但在某些錯誤情況下可用來做為因應措施。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用對象:Exchange Online
在只報告未執行動作的情況下會發生的情況的模式中執行命令。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。