From 274cb714f4c0f6ab5214a47a5e7cf739fe4009c8 Mon Sep 17 00:00:00 2001 From: McKenna Hollinger Date: Thu, 6 Nov 2025 22:53:04 -0800 Subject: [PATCH 1/3] Learn Editor: Update Set-MigrationBatch.md --- .../exchange-ps/ExchangePowerShell/Set-MigrationBatch.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md b/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md index da256915b7..d63eea8e58 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md +++ b/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md @@ -102,7 +102,13 @@ Accept wildcard characters: False This parameter is available only in the cloud-based service. -{{ Fill AddUsers Description }} +This command supports incrementally adding users to an existing migration batch without recreating or resubmitting the entire batch. It should be used as follows: + +> Set-MigrationBatch -AddUsers -CSVData + +The CSV file provided in the -CSVData parameter must have the same format as the one originally used when creating the migration batch with New-Migration-Batch. + +Running this command appends the new CSV data provided to the existing CSV data that already belongs to the migration batch. It will then only process the new entries, rather than reprocessing the existing ones. ```yaml Type: SwitchParameter From d5f66923fb839192a810e0449d2421d3c5d181ad Mon Sep 17 00:00:00 2001 From: Heidi Payne Date: Fri, 7 Nov 2025 08:36:01 -0800 Subject: [PATCH 2/3] Fix grammar issues in Set-MigrationBatch documentation Corrected grammatical errors for clarity and consistency in the documentation. --- .../exchange-ps/ExchangePowerShell/Set-MigrationBatch.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md b/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md index d63eea8e58..26006d7611 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md +++ b/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md @@ -108,7 +108,7 @@ This command supports incrementally adding users to an existing migration batch The CSV file provided in the -CSVData parameter must have the same format as the one originally used when creating the migration batch with New-Migration-Batch. -Running this command appends the new CSV data provided to the existing CSV data that already belongs to the migration batch. It will then only process the new entries, rather than reprocessing the existing ones. +Running this command appends the new CSV data provided to the existing CSV data that already belongs to the migration batch. It then only processes the new entries, rather than reprocessing the existing ones. ```yaml Type: SwitchParameter @@ -218,7 +218,7 @@ This parameter is available only in on-premises Exchange. The BadItemLimit parameter specifies the maximum number of bad items that are allowed before the migration request fails. A bad item is a corrupt item in the source mailbox that can't be copied to the target mailbox. Also included in the bad item limit are missing items. Missing items are items in the source mailbox that can't be found in the target mailbox when the migration request is ready to complete. -Valid input for this parameter is an integer or the value unlimited. The default value is 0, which means the migration request fails if any bad items are detected. If you are OK with leaving a few bad items behind, you can set this parameter to a reasonable value (we recommend 10 or lower) so the migration request can proceed. If too many bad items are detected, consider using the New-MailboxRepairRequest cmdlet to attempt to fix corrupted items in the source mailbox, and try the migration request again. +Valid input for this parameter is an integer or the value unlimited. The default value is 0, which means the migration request fails if any bad items are detected. If you're OK with leaving a few bad items behind, you can set this parameter to a reasonable value (we recommend 10 or lower) so the migration request can proceed. If too many bad items are detected, consider using the New-MailboxRepairRequest cmdlet to attempt to fix corrupted items in the source mailbox, and try the migration request again. **Note**: This parameter is deprecated from the cloud-based service. Admins must review the [Data Consistency Score](https://learn.microsoft.com/exchange/mailbox-migration/track-prevent-data-loss-dcs) and any skipped items before the migration completes. @@ -334,7 +334,7 @@ The LargeItemLimit parameter specifies the maximum number of large items that ar For more information about maximum message size values, see [Message size limits in Exchange Server](https://learn.microsoft.com/Exchange/mail-flow/message-size-limits). -Valid input for this parameter is an integer or the value unlimited. The default value is 0, which means the migration request will fail if any large items are detected. If you are OK with leaving a few large items behind, you can set this parameter to a reasonable value (we recommend 10 or lower) so the migration request can proceed. +Valid input for this parameter is an integer or the value unlimited. The default value is 0, which means the migration request fails if any large items are detected. If you're OK with leaving a few large items behind, you can set this parameter to a reasonable value (we recommend 10 or lower) so the migration request can proceed. **Note**: This parameter is deprecated from the cloud-based service. Admins must review the [Data Consistency Score](https://learn.microsoft.com/exchange/mailbox-migration/track-prevent-data-loss-dcs) and any skipped items before the migration completes. From 4e39fae7b67c84d54716bdc5d151a5d5e75b483c Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Fri, 7 Nov 2025 09:30:49 -0800 Subject: [PATCH 3/3] Update Set-MigrationBatch.md with new example Added example for incrementally adding users to a migration batch. --- .../ExchangePowerShell/Set-MigrationBatch.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md b/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md index 26006d7611..9a2234306c 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md +++ b/exchange/exchange-ps/ExchangePowerShell/Set-MigrationBatch.md @@ -73,6 +73,13 @@ Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems This example updates MigrationBatch01 by approving all of the skipped items for all of the users in the batch that were detected previously. +### Example 2 +```powershell +`Set-MigrationBatch -Identity MigrationBatch01 -AddUsers -CSVData ([System.IO.File]::ReadAllBytes('C:\Data\MigrationBatch01.csv'))` +``` + +In the cloud-based service, this example adds new users to the existing migration batch named MigrationBatch01. The new users are identified in the file C:\Data\MigrationBatch01.csv that was used to create the original migration batch. Only the new users in the file are processed. + ## PARAMETERS ### -Identity @@ -102,13 +109,9 @@ Accept wildcard characters: False This parameter is available only in the cloud-based service. -This command supports incrementally adding users to an existing migration batch without recreating or resubmitting the entire batch. It should be used as follows: - -> Set-MigrationBatch -AddUsers -CSVData - -The CSV file provided in the -CSVData parameter must have the same format as the one originally used when creating the migration batch with New-Migration-Batch. +The AddUsers switch specifies whether to incrementally add users to an existing migration batch without recreating or resubmitting the entire batch. You don't need to specify a value with this switch. -Running this command appends the new CSV data provided to the existing CSV data that already belongs to the migration batch. It then only processes the new entries, rather than reprocessing the existing ones. +You use this switch with the CSVData parameter. The specified CSV file must have the same format as the CSV file used to create the migration batch. Only new entries in the CSV file are processed. For more information, see Example 2 in the Examples section. ```yaml Type: SwitchParameter