Set-MigrationBatch
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Set-MigrationBatch コマンドレットを使用して、複数のユーザーの移行要求を更新します。 詳細については、「New-MigrationBatch」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-MigrationBatch
[-Identity] <MigrationBatchIdParameter>
[-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>] 説明
Set-MigrationBatch コマンドレットは、次のいずれかのシナリオでメールボックスおよびメールボックス データを移行するように既存の移行バッチを構成します。
- ローカル移動
- フォレスト間移動
- リモート移動
- Exchange の一括移行
- Exchange の段階的移行
- IMAP 移行
- Google ワークスペース (旧称 G Suite) の移行
一部の設定は、バッチとバッチ内の個々のユーザーの両方に適用できます。 設定がユーザーに適用されると、バッチの対応する設定がオーバーライドされることに注意してください。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems次の使用例は、以前に検出されたすべてのユーザーに対してスキップされたすべての項目を承認することで、MigrationBatch01 を更新します。
パラメーター
-AllowIncrementalSyncs
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
AllowIncrementalSyncs パラメーターは、増分同期を有効にするか無効にするかを指定します。 有効な値は次のとおりです。
- $true: 増分同期が有効になっています。 ソース メールボックスに送信された新しいメッセージは、24 時間ごとに対応するターゲット メールボックスにコピーされます。
- $false: 増分同期が無効になっています。 移行バッチは、初期同期が完了すると停止状態になります。 ローカル移動、フォレスト間移動、またはリモート移動の移行バッチを完了するには、増分同期を有効にする必要があります。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AllowUnknownColumnsInCsv
AllowUnknownColumnsInCsv パラメーターは、移行で使用されない CSV ファイル内の余分な列を許可するかどうかを指定します。 有効な値は次のとおりです。
- $true: 移行では、CSV ファイル内の不明な列が無視 (サイレント スキップ) されます (省略可能な列のスペルミスを含む)。 すべての不明な列は、移行で使用されない余分の列と同じように扱われます。
- $false: CSV ファイルに不明な列がある場合、移行は失敗します。 この設定は、列ヘッダー内のスペルの間違いを防ぎます。 これは既定の値です。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ApproveSkippedItems
このパラメーターは、クラウドベースのサービスでのみ使用できます。
ApprovSkippedItems スイッチは、現在の時刻より前に検出されたすべてのスキップされた項目を承認済みとしてマークします。 このスイッチで値を指定する必要はありません。
この移行中に検出されたデータ損失が重要な場合、スキップされた項目を承認しないと移行を完了できません。 アイテムは、ソース メールボックスで破損しており、ターゲット メールボックスにコピーできない、テナント用に構成された最大許容メッセージ サイズを超えている、または移行が完了する準備ができたときにターゲット メールボックスから見つからないとして検出されたため、スキップされた可能性があります。
最大メッセージ サイズ値の詳細については、次のトピック「制限Exchange Online」を参照してください。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AutoRetryCount
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
AutoRetryCount パラメーターは、エラーが発生した、メールボックスを移行する移行バッチの再起動を試行する回数を指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BadItemLimit
BadItemLimit パラメーターは、移行要求が失敗する前に許可される無効な項目の最大数を指定します。 無効なアイテムとは、移動先メールボックスにコピーできない、移動元メールボックスにある破損したアイテムのことです。 無効なアイテムの制限の対象には、見つからないアイテムも含まれます。 不足しているアイテムは、移行要求を完了する準備ができたときにターゲット メールボックスに見つからないソース メールボックス内のアイテムです。
このパラメーターの有効な入力値は、整数または値 unlimited です。 既定値は 0 です。これは、不適切な項目が検出された場合に移行要求が失敗することを意味します。 いくつかの不適切な項目を残しても問題ない場合は、移行要求を続行できるように、このパラメーターを適切な値 (10 以下をお勧めします) に設定できます。 不適切な項目が多すぎることが検出された場合は、New-MailboxRepairRequest コマンドレットを使用して、ソース メールボックス内の破損したアイテムを修正し、移行要求を再試行することを検討してください。
注: このパラメーターは、クラウドベースのサービスでは廃止される予定です。 このパラメーターを使用しない場合、今後は代わりとして、スキップされたアイテム承認セマンティクスが使用されます。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompleteAfter
このパラメーターは、クラウドベースのサービスでのみ機能します。
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 に変換されます。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CSVData
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
CSVData パラメーターは、移動または移行するユーザー メールボックスの情報が含まれる CSV ファイルを指定します。 CSV ファイルのヘッダー行にある必要な属性は、移行の種類に応じて異なります。
このパラメーターの有効な値を使用するには、次の構文を使用して、ファイルをバイトエンコード されたオブジェクトに読み取る必要があります。 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')) このコマンドをパラメーター値として使用することも、変数 () に出力を書き込み、変数をパラメーター値 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')$data) として使用することもできます。
注: このパラメーターは、RBAC スコープに基づいてメールボックスの可用性を検証しません。 CSV ファイルで指定されたすべてのメールボックスは、メールボックスを移行するための管理者アクセス許可を付与する RBAC スコープ (OU など) の外部にある場合でも移行されます。
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity パラメーターは、変更する移行バッチを指定します。 移行バッチを一意に識別する任意の値を使用することができます。 例:
- 名前 (Identity プロパティ値)
- GUID (BatchGuid プロパティ値)
| Type: | MigrationBatchIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LargeItemLimit
LargeItemLimit パラメーターは、移行要求が失敗する前に許可される大きな項目の最大数を指定します。 大きなアイテムとは、移行先メールボックスで許可される最大メッセージ サイズを超える移行元メールボックス内のメッセージのことです。 移行先メールボックスに具体的に構成された最大メッセージ サイズ値が設定されていない場合、組織全体用の値が使用されます。
最大メッセージ サイズ値の詳細については、次のトピックを参照してください。
- Exchange 2016: Exchange Serverのメッセージ サイズの制限
- Exchange Online: Exchange Online の制限
このパラメーターの有効な入力値は、整数または値 unlimited です。 既定値は 0 です。これは、大きな項目が検出された場合に移行要求が失敗することを意味します。 いくつかの大きな項目を残しても問題ない場合は、移行要求を続行できるように、このパラメーターを適切な値 (10 以下をお勧めします) に設定できます。
注: このパラメーターは、クラウドベースのサービスでは廃止される予定です。 このパラメーターを使用しない場合、今後は代わりとして、スキップされたアイテム承認セマンティクスが使用されます。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MoveOptions
MoveOptions パラメーターは、デバッグのためにスキップする移行のステージを指定します。 Microsoft カスタマー サービスおよびサポートからの指示または特定のドキュメントによる指示がない場合、このパラメーターは使用しないでください。
このパラメーターは SkipMoving パラメーターと併用できません。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-NotificationEmails
NotificationEmails パラメーターは、移行状態レポートの送信先とする 1 つまたは複数の電子メール アドレスを指定します。
このパラメーターを使用しない場合は、状態レポートが送信されません。
複数の値を入力し、既存のエントリを上書きするには、次の構文を使用します。 Value1,Value2,...ValueN 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Partition
このパラメーターは、クラウドベースのサービスでのみ使用できます。
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ReportInterval
ReportInterval パラメーターは、NotificationEmails 内に一覧表示されている電子メール アドレスに電子メールで送信されるレポートの頻度を指定します。
既定では、電子メールで送信されたレポートは、バッチに対して 24 時間ごとに送信されます。 この値を 0 に設定すると、このバッチに対してレポートを送信してはならないことを示します。
このパラメーターは、クラウドベースのサービスでのみ使用する必要があります。
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipMerging
SkipMerging パラメーターは、デバッグの目的でスキップする移行の段階を指定します。 Microsoft カスタマー サービスおよびサポートからの指示または特定のドキュメントによる指示がない場合、このパラメーターは使用しないでください。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipMoving
このパラメーターは MoveOptions パラメーターに置き換えられました。
SkipMoving パラメーターは、デバッグの目的でスキップする移行の段階を指定します。 Microsoft カスタマー サービスおよびサポートからの指示または特定のドキュメントによる指示がない場合、このパラメーターは使用しないでください。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipReports
SkipReports スイッチは、移行のための自動レポート作成をスキップすることを指定します。 このスイッチで値を指定する必要はありません。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourcePublicFolderDatabase
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
SourcePublicFolderDatabase パラメーターは、パブリック フォルダーの移行で使用されるソース パブリック フォルダー データベースを指定します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StartAfter
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 に変換されます。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SyncNow
SyncNow スイッチは、既に同期状態に達しているが、失敗したユーザーは再開しないユーザーの即時同期を開始します。 このスイッチで値を指定する必要はありません。
このスイッチを使用すると、移動が完了する直前のスイッチを使用して、オンボードの移動を高速化できます。 IMAP 移行の場合は、MX レコードの切り替え後にこのスイッチを使用できます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Update
Update スイッチは、移行バッチの更新フラグを設定します。 このスイッチで値を指定する必要はありません。
Update フラグを使用すると、移行サービスがトリガーされ、エンドポイント、バッチ、ユーザーから移行プロセスにすべての設定が再適用されます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示