Set-MigrationBatch

構文

Default (既定)

Set-MigrationBatch
    [-Identity] <MigrationBatchIdParameter>
    [-AddUsers]
    [-AllowIncrementalSyncs <Boolean>]
    [-AllowUnknownColumnsInCsv <Boolean>]
    [-ApproveSkippedItems]
    [-AutoRetryCount <Int32>]
    [-BadItemLimit <Unlimited>]
    [-CSVData <Byte[]>]
    [-CompleteAfter <DateTime>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LargeItemLimit <Unlimited>]
    [-MoveOptions <MultiValuedProperty>]
    [-NotificationEmails <MultiValuedProperty>]
    [-Partition <MailboxIdParameter>]
    [-ReportInterval <TimeSpan>]
    [-SkipMerging <MultiValuedProperty>]
    [-SkipMoving <MultiValuedProperty>]
    [-SkipReports <Boolean>]
    [-SourcePublicFolderDatabase <DatabaseIdParameter>]
    [-StartAfter <DateTime>]
    [-SyncNow]
    [-Update]
    [-WhatIf]
    [<CommonParameters>]

説明

例

例 1

Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems

パラメーター

-AddUsers

適用対象: Exchange Online

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

{{ Fill AddUsers Description }}

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

パラメーター セット

-AllowIncrementalSyncs

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

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

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

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

パラメーター セット

-AllowUnknownColumnsInCsv

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

パラメーター セット

-ApproveSkippedItems

適用対象: Exchange Online

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

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

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

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

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

パラメーター セット

-AutoRetryCount

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

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

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

パラメーター セット

-BadItemLimit

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

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

パラメーター セット

-CompleteAfter

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、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

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

パラメーター セット

-CSVData

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

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

パラメーター セット

-DomainController

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

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

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

パラメーター セット

-Identity

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

パラメーター セット

-LargeItemLimit

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

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

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

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

パラメーター セット

-MoveOptions

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

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

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

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

パラメーター セット

-NotificationEmails

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

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

パラメーター セット

-Partition

適用対象: Exchange Online

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

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

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

パラメーター セット

-ReportInterval

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

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

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

パラメーター セット

-SkipMerging

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

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

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

パラメーター セット

-SkipMoving

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

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

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

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

パラメーター セット

-SkipReports

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

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

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

パラメーター セット

-SourcePublicFolderDatabase

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

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

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

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

パラメーター セット

-StartAfter

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、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

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

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

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

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

パラメーター セット

-Update

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

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

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

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

パラメーター セット

-WhatIf

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

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

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

パラメーター セット

CommonParameters

入力

Input types

出力

Output types