Invoke-CalendarEventMigration

このコマンドレットは、クラウド ベースのサービスでのみ使用できます。

Invoke-CalendarEventMigration コマンドレットを使用して、会議または予定のタイム ゾーンを変更します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

TimeZoneMigration (既定)

Invoke-CalendarEventMigration
    [-Identity] <MailboxIdParameter>
    -FromWindowsTimeZoneId <string>
    -ToWindowsTimeZoneId <string>
    -QueryWindowInDays <int>
    [-QueryStartDate <DateTime>]
    [-Force]
    [-PreviewOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

新しいタイム ゾーンがリリースされると、影響を受ける Outlook ユーザーは、新しいタイム ゾーンを使用するようにスケジュールされたイベントを更新する必要があります。 Invoke-CalendarEventMigration コマンドレットを使用すると、IT 管理者は影響を受けるユーザーをループするスクリプトを作成することで予定表イベントの移行を自動化できます。 Invoke-CalendarEventMigration は一度に 1 つのメールボックスで動作し、同じ現地時刻を維持しながら、あるタイム ゾーンから別のタイム ゾーンに会議を移行します。 たとえば、午前 9 時 (Pacific Standard Time) の会議は、午前 9 時 (British Columbia Standard Time) に移行されます。

最初のリリースでは、単一インスタンスの会議と予定のみがサポートされます。 定期的な会議と予定のサポートは、次のバージョンで提供される予定です。 定期的なイベントのサポートが追加されたら、コマンドレットを安全に再実行できます。

メールボックスが開催者である会議のみが移行されます。 メールボックスが出席者である会議は、手動で、または開催者のメールボックスでコマンドレットを実行して、開催者が移行する必要があります。 移行された会議では、出席者に対して会議の更新メッセージが生成されるため、予定表にタイム ゾーンの変更が反映されます。

既定の Calendar フォルダーのイベントのみが移行されます。 第 2 予定表のイベントは移行されません。

タイムアウト後、または追加機能が追加された場合は、安全に再実行できます。

このコマンドレットは、予定表を表示したり新しいイベントをスケジュールしたりするために使用されるタイム ゾーンであるメールボックス タイム ゾーンは変更しません。 メールボックスのタイム ゾーンを変更するには、 Set-MailboxRegionalConfiguration を使用します。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可に含まれていない場合、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 のプライマリ予定表の単一インスタンス会議と予定を Pacific Standard Time から British Columbia Standard Time に移行します。 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"
  Invoke-CalendarEventMigration -Identity $mailbox `
    -FromWindowsTimeZoneId "Pacific Standard Time" `
    -ToWindowsTimeZoneId "British Columbia Standard Time" `
    -QueryStartDate 2026-11-01 -QueryWindowInDays 365 -Confirm:$false
}

この例では、影響を受けるメールボックス User1、User2、および Shared を British Columbia Standard Time (英語情報) に移行します。 各メールボックスのタイム ゾーンは British Columbia Standard Time に更新され、シングル インスタンスの会議と予定は Pacific Standard Time から British Columbia Standard Time に移行されます。 2026 年 11 月 1 日から 2027 年 11 月 1 日までのイベントのみが移行されます。

パラメーター

-Confirm

適用対象: Exchange Online

コマンドレットを実行する前に確認メッセージを表示します。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
ワイルドカードのサポート:False
DontShow:False
エイリアス:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

適用対象: Exchange Online

移行元と移行先のタイム ゾーンで現在の現地時刻が異なる場合に、移行を許可するかどうかを設定します。 このチェックを行うことで、会議が誤って新しい日時に変更されるのを防ぐことができます。 Force キーを使用してチェックをバイパスします。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

TimeZoneMigration
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FromWindowsTimeZoneId

適用対象: Exchange Online

移行する必要があるイベントに関する現在のタイム ゾーン。 他のタイム ゾーンにスケジュールされたイベントは移行されません。

Get-TimeZone -ListAvailable | FT -Property Idを実行して、サポートされているタイム ゾーンの一覧を表示します。

パラメーターのプロパティ

型:System.String
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

TimeZoneMigration
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Online

Identity パラメーターは、現在の会議開催者のメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)

パラメーターのプロパティ

型:MailboxIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PreviewOnly

適用対象: Exchange Online

使用すると、更新なしで移行される一致するイベントを表示します。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

TimeZoneMigration
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-QueryStartDate

適用対象: Exchange Online

クエリ ウィンドウの開始日。 コマンドレットは、クエリ ウィンドウ内のイベントを処理します。 この日付より前のイベントは移行されません。 -QueryStartDate が指定されていない場合は、現在の時刻が使用されます。

パラメーターのプロパティ

型:DateTime
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-QueryWindowInDays

適用対象: Exchange Online

クエリ ウィンドウの長さ (日数)。 コマンドレットは、クエリ ウィンドウ内のイベントを処理します。 クエリ ウィンドウを超えるイベントは移行されません。 有効な値は、1 (1 日) から 1825 (5 年) までです。

パラメーターのプロパティ

型:System.Int32
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

TimeZoneMigration
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ToWindowsTimeZoneId

適用対象: Exchange Online

イベントの移行先のタイム ゾーン。

Get-TimeZone -ListAvailable | FT -Property Idを実行して、サポートされているタイム ゾーンの一覧を表示します。

パラメーターのプロパティ

型:System.String
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

TimeZoneMigration
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

適用対象: Exchange Online

アクションを実行しないで何が起こるかのみを報告するモードでコマンドを実行します。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
ワイルドカードのサポート:False
DontShow:False
エイリアス:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。