Set-MigrationBatch

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

AllowIncrementalSyncs パラメーターは、増分同期を有効にするか無効にするかを指定します。 有効な値は次のとおりです。

• $true: 増分同期が有効になっています。 ソース メールボックスに送信された新しいメッセージは、24 時間ごとに対応するターゲット メールボックスにコピーされます。
• $false: 増分同期が無効になっています。 移行バッチは、初期同期が完了すると停止状態になります。 ローカル移動、フォレスト間移動、またはリモート移動の移行バッチを完了するには、増分同期を有効にする必要があります。

AllowUnknownColumnsInCsv パラメーターは、移行で使用されない CSV ファイル内の余分な列を許可するかどうかを指定します。 有効な値は次のとおりです。

• $true: 移行では、CSV ファイル内の不明な列が無視 (サイレント スキップ) されます (省略可能な列のスペルミスを含む)。 すべての不明な列は、移行で使用されない余分の列と同じように扱われます。
• $false: CSV ファイルに不明な列がある場合、移行は失敗します。 この設定は、列ヘッダー内のスペルの間違いを防ぎます。 これは既定の値です。

このパラメーターは、クラウドベースのサービスでのみ使用できます。

ApprovSkippedItems スイッチは、現在の時刻より前に検出されたすべてのスキップされた項目を承認済みとしてマークします。 このスイッチで値を指定する必要はありません。

この移行中に検出されたデータ損失が重要な場合、スキップされた項目を承認しないと移行を完了できません。 アイテムは、ソース メールボックスで破損しており、ターゲット メールボックスにコピーできない、テナント用に構成された最大許容メッセージ サイズを超えている、または移行が完了する準備ができたときにターゲット メールボックスから見つからないとして検出されたため、スキップされた可能性があります。

最大メッセージ サイズ値の詳細については、次のトピック「制限Exchange Online」を参照してください。

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

AutoRetryCount パラメーターは、エラーが発生した、メールボックスを移行する移行バッチの再起動を試行する回数を指定します。

BadItemLimit パラメーターは、移行要求が失敗する前に許可される無効な項目の最大数を指定します。 無効なアイテムとは、移動先メールボックスにコピーできない、移動元メールボックスにある破損したアイテムのことです。 無効なアイテムの制限の対象には、見つからないアイテムも含まれます。 不足しているアイテムは、移行要求を完了する準備ができたときにターゲット メールボックスに見つからないソース メールボックス内のアイテムです。

このパラメーターの有効な入力値は、整数または値 unlimited です。 既定値は 0 です。これは、不適切な項目が検出された場合に移行要求が失敗することを意味します。 いくつかの不適切な項目を残しても問題ない場合は、移行要求を続行できるように、このパラメーターを適切な値 (10 以下をお勧めします) に設定できます。 不適切な項目が多すぎることが検出された場合は、New-MailboxRepairRequest コマンドレットを使用して、ソース メールボックス内の破損したアイテムを修正し、移行要求を再試行することを検討してください。

注: このパラメーターは、クラウドベースのサービスでは廃止される予定です。 このパラメーターを使用しない場合、今後は代わりとして、スキップされたアイテム承認セマンティクスが使用されます。

このパラメーターは、クラウドベースのサービスでのみ機能します。

CompleteAfter パラメーターは、バッチが完了するまでの遅延を指定します。 バッチのデータ移行は開始されますが、完了は、このパラメーターで指定した日付/時刻まで開始されません。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

PowerShell Exchange Onlineで、タイム ゾーンを指定せずに日付/時刻の値を指定した場合、値は協定世界時 (UTC) になります。 値を指定するには、次のいずれかのオプションを使用します。

• UTC で日付/時刻の値を指定します(例: "7/30/2020 9:00PM Z")。
• ローカル タイム ゾーンで日付/時刻の値を指定します。 たとえば、「 "7/30/2020 9:00PM -700" 」のように入力します。 TimeZone パラメーターを使用しない場合、値は UTC に変換されます。

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

• 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
• 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

CSVData パラメーターは、移動または移行するユーザー メールボックスの情報が含まれる CSV ファイルを指定します。 CSV ファイルのヘッダー行にある必要な属性は、移行の種類に応じて異なります。

このパラメーターの有効な値を使用するには、次の構文を使用して、ファイルをバイトエンコード されたオブジェクトに読み取る必要があります。 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')) このコマンドをパラメーター値として使用することも、変数 () に出力を書き込み、変数をパラメーター値 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')$data) として使用することもできます。

注: このパラメーターは、RBAC スコープに基づいてメールボックスの可用性を検証しません。 CSV ファイルで指定されたすべてのメールボックスは、メールボックスを移行するための管理者アクセス許可を付与する RBAC スコープ (OU など) の外部にある場合でも移行されます。

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

Identity パラメーターは、変更する移行バッチを指定します。 移行バッチを一意に識別する任意の値を使用することができます。 例:

• 名前 (Identity プロパティ値)
• GUID (BatchGuid プロパティ値)

LargeItemLimit パラメーターは、移行要求が失敗する前に許可される大きな項目の最大数を指定します。 大きなアイテムとは、移行先メールボックスで許可される最大メッセージ サイズを超える移行元メールボックス内のメッセージのことです。 移行先メールボックスに具体的に構成された最大メッセージ サイズ値が設定されていない場合、組織全体用の値が使用されます。

最大メッセージ サイズ値の詳細については、次のトピックを参照してください。

• Exchange 2016: Exchange Serverのメッセージ サイズの制限
• Exchange Online: Exchange Online の制限

このパラメーターの有効な入力値は、整数または値 unlimited です。 既定値は 0 です。これは、大きな項目が検出された場合に移行要求が失敗することを意味します。 いくつかの大きな項目を残しても問題ない場合は、移行要求を続行できるように、このパラメーターを適切な値 (10 以下をお勧めします) に設定できます。

注: このパラメーターは、クラウドベースのサービスでは廃止される予定です。 このパラメーターを使用しない場合、今後は代わりとして、スキップされたアイテム承認セマンティクスが使用されます。

MoveOptions パラメーターは、デバッグのためにスキップする移行のステージを指定します。 Microsoft カスタマー サービスおよびサポートからの指示または特定のドキュメントによる指示がない場合、このパラメーターは使用しないでください。

このパラメーターは SkipMoving パラメーターと併用できません。

NotificationEmails パラメーターは、移行状態レポートの送信先とする 1 つまたは複数の電子メール アドレスを指定します。

このパラメーターを使用しない場合は、状態レポートが送信されません。

複数の値を入力し、既存のエントリを上書きするには、次の構文を使用します。 Value1,Value2,...ValueN 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

ReportInterval パラメーターは、NotificationEmails 内に一覧表示されている電子メール アドレスに電子メールで送信されるレポートの頻度を指定します。

既定では、電子メールで送信されたレポートは、バッチに対して 24 時間ごとに送信されます。 この値を 0 に設定すると、このバッチに対してレポートを送信してはならないことを示します。

このパラメーターは、クラウドベースのサービスでのみ使用する必要があります。

SkipMerging パラメーターは、デバッグの目的でスキップする移行の段階を指定します。 Microsoft カスタマー サービスおよびサポートからの指示または特定のドキュメントによる指示がない場合、このパラメーターは使用しないでください。

このパラメーターは MoveOptions パラメーターに置き換えられました。

SkipMoving パラメーターは、デバッグの目的でスキップする移行の段階を指定します。 Microsoft カスタマー サービスおよびサポートからの指示または特定のドキュメントによる指示がない場合、このパラメーターは使用しないでください。

SkipReports スイッチは、移行のための自動レポート作成をスキップすることを指定します。 このスイッチで値を指定する必要はありません。

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

SourcePublicFolderDatabase パラメーターは、パブリック フォルダーの移行で使用されるソース パブリック フォルダー データベースを指定します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• GUID

StartAfter パラメーターは、バッチ内のユーザーのデータ移行が開始されるまでの遅延を指定します。 移行は準備されますが、バッチ内のユーザーの実際のデータ移行は、このパラメーターで指定した日付/時刻まで開始されません。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

PowerShell Exchange Onlineで、タイム ゾーンを指定せずに日付/時刻の値を指定した場合、値は協定世界時 (UTC) になります。 値を指定するには、次のいずれかのオプションを使用します。

• UTC で日付/時刻の値を指定します(例: "7/30/2020 9:00PM Z")。
• ローカル タイム ゾーンで日付/時刻の値を指定します。 たとえば、「 "7/30/2020 9:00PM -700" 」のように入力します。 TimeZone パラメーターを使用しない場合、値は UTC に変換されます。

SyncNow スイッチは、既に同期状態に達しているが、失敗したユーザーは再開しないユーザーの即時同期を開始します。 このスイッチで値を指定する必要はありません。

このスイッチを使用すると、移動が完了する直前のスイッチを使用して、オンボードの移動を高速化できます。 IMAP 移行の場合は、MX レコードの切り替え後にこのスイッチを使用できます。

Update スイッチは、移行バッチの更新フラグを設定します。 このスイッチで値を指定する必要はありません。

Update フラグを使用すると、移行サービスがトリガーされ、エンドポイント、バッチ、ユーザーから移行プロセスにすべての設定が再適用されます。

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。