Set-MigrationBatch

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Set-MigrationBatch, um eine Migrationsanforderung für Benutzer im Batch zu aktualisieren. Weitere Informationen finden Sie unter New-MigrationBatch.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

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>]

Beschreibung

Mit dem Cmdlet Set-MigrationBatch können Sie Ihre vorhandenen Migrationsbatches zur Migration von Postfächern und Postfachdaten in einem der folgenden Szenarien konfigurieren:

  • Lokale Verschiebung
  • Gesamtstrukturübergreifende Verschiebung
  • Remoteverschiebung
  • Exchange-Übernahmemigration
  • Phasenweise Exchange-Migration
  • IMAP-Migration
  • Migration von Google Workspace (vormals G Suite)

Einige Einstellungen können sowohl auf den Batch als auch auf einzelne Benutzer innerhalb des Batches angewendet werden. Es ist wichtig zu beachten, dass beim Anwenden einer Einstellung auf einen Benutzer jede entsprechende Einstellung für den Batch außer Kraft gesetzt wird.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems

In diesem Beispiel wird MigrationBatch01 aktualisiert, indem alle übersprungenen Elemente für alle Benutzer im Batch genehmigt werden, die zuvor erkannt wurden.

Parameter

-AllowIncrementalSyncs

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter AllowIncrementalSyncs gibt an, ob die inkrementelle Synchronisierung aktiviert oder deaktiviert ist. Gültige Werte sind:

  • $true: Die inkrementelle Synchronisierung ist aktiviert. Alle neuen an das Quellpostfach gesendeten Nachrichten werden alle 24 Stunden in das entsprechende Zielpostfach kopiert.
  • $false: Die inkrementelle Synchronisierung ist deaktiviert. Der Migrationsbatch wird in den Status Beendet versetzt, nachdem die Synchronisierung abgeschlossen ist. Sie müssen die inkrementelle Synchronisierung aktivieren, um Migrationsbatches für lokale oder gesamtstrukturübergreifende Verschiebungen oder Migrationen per Remoteverschiebung abschließen zu können.
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

Der Parameter AllowUnknownColumnsInCsv gibt an, ob Extraspalten in der CSV-Datei zulässig sind, die von der Migration nicht verwendet werden. Gültige Werte sind:

  • $true: Die Migration ignoriert (überspringt) unbekannte Spalten in der CSV-Datei (einschließlich optionaler Spalten mit falsch geschriebenen Spaltenüberschriften). Alle unbekannten Spalten werden wie zusätzliche Spalten behandelt, die von der Migration nicht verwendet werden.
  • $false: Die Migration schlägt fehl, wenn in der CSV-Datei unbekannte Spalten vorhanden sind. Diese Einstellung schützt vor Rechtschreibfehlern in Spaltenüberschriften. Dies ist der Standardwert.
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

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Die Option ApproveSkippedItems markiert alle übersprungenen Elemente, die vor dem aktuellen Zeitpunkt erkannt wurden, als genehmigt. Sie müssen keinen Wert für diese Option angeben.

Wenn der datenverlust, der während dieser Migration erkannt wurde, erheblich ist, kann die Migration nicht abgeschlossen werden, ohne übersprungene Elemente zu genehmigen. Elemente wurden möglicherweise übersprungen, weil sie im Quellpostfach beschädigt sind und nicht in das Zielpostfach kopiert werden können, sie sind größer als die maximal zulässige Nachrichtengröße, die für den Mandanten konfiguriert wurde, oder sie wurden als nicht im Zielpostfach erkannt, wenn die Migration abgeschlossen werden kann.

Weitere Informationen zu den Werten für die maximale Nachrichtengröße finden Sie im folgenden Thema Exchange Online Grenzwerte.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-AutoRetryCount

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter AutoRetryCount gibt an, wie oft ein Migrationsbatch neu gestartet wird, um zu versuchen, Postfächer zu migrieren, bei denen Fehler aufgetreten sind.

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

Der Parameter BadItemLimit gibt die maximale Anzahl fehlerhafter Elemente an, die zulässig sind, bevor die Migrationsanforderung fehlschlägt. Ein "ungültiges Element" ist ein fehlerhaftes Element im Quellpostfach, das nicht in das Zielpostfach kopiert werden kann. Der Grenzwert für ungültige Elemente enthält auch fehlende Elemente. Fehlende Elemente sind Elemente im Quellpostfach, die im Zielpostfach nicht gefunden werden können, wenn die Migrationsanforderung abgeschlossen werden kann.

Eine gültige Eingabe für diesen Parameter ist eine Ganzzahl oder der Wert "Unlimited". Der Standardwert ist 0. Dies bedeutet, dass die Migrationsanforderung fehlschlägt, wenn fehlerhafte Elemente erkannt werden. Wenn Sie einige ungültige Elemente zurücklassen möchten, können Sie diesen Parameter auf einen vernünftigen Wert festlegen (wir empfehlen 10 oder niedriger), damit die Migrationsanforderung fortgesetzt werden kann. Wenn zu viele ungültige Elemente erkannt werden, sollten Sie das Cmdlet New-MailboxRepairRequest verwenden, um zu versuchen, beschädigte Elemente im Quellpostfach zu beheben, und versuchen Sie es erneut mit der Migrationsanforderung.

Hinweis: Dieser Parameter wird im cloudbasierten Dienst eingestellt. Wenn Sie diesen Parameter in Zukunft nicht mehr verwenden, wird stattdessen die Semantik der Genehmigung übersprungener Elemente verwendet.

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

Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.

Der Parameter CompleteAfter gibt eine Verzögerung an, bevor der Batch abgeschlossen wird. Die Datenmigration für den Batch wird gestartet, aber der Abschluss beginnt erst nach dem Datum/der Uhrzeit, das Sie mit diesem Parameter angeben.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

Wenn Sie in Exchange Online PowerShell einen Datums-/Uhrzeitwert ohne Zeitzone angeben, befindet sich der Wert in koordinierter Weltzeit (UTC). Verwenden Sie eine der folgenden Optionen, um einen Wert anzugeben:

  • Geben Sie den Datums-/Uhrzeitwert in UTC an: Beispiel: "7/30/2020 9:00PM Z".
  • Geben Sie den Datums-/Uhrzeitwert in Ihrer lokalen Zeitzone an. Beispiel: "7/30/2020 9:00PM -700". Wenn Sie den TimeZone-Parameter nicht verwenden, wird der Wert in UTC konvertiert.
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

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
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

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter CSVData gibt die CSV-Datei mit den Informationen zu den zu verschiebenden oder zu migrierenden Benutzerpostfächern an. Die erforderlichen Attribute in der Kopfzeile der CSV-Datei variieren je nach Art der Migration.

Ein gültiger Wert für diesen Parameter erfordert, dass Sie die Datei mithilfe der folgenden Syntax in ein bytecodiertes Objekt lesen: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Sie können diesen Befehl als Parameterwert verwenden, oder Sie können die Ausgabe in eine Variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) schreiben und die Variable als Parameterwert ($data) verwenden.

Hinweis: Dieser Parameter überprüft nicht die Verfügbarkeit der Postfächer basierend auf dem RBAC-Bereich. Alle Postfächer, die in der CSV-Datei angegeben sind, werden migriert, auch wenn sie sich außerhalb des RBAC-Bereichs befinden (z. B. eine Organisationseinheit), die dem Administrator Berechtigungen zum Migrieren von Postfächern erteilt.

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: 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

Der Parameter Identity gibt den Migrationsbatch an, den Sie ändern möchten. Sie können jeden beliebigen Wert verwenden, sofern er den Migrationsbatch eindeutig kennzeichnet. Zum Beispiel:

  • Name (der Identity-Eigenschaftswert)
  • GUID (der BatchGuid-Eigenschaftswert)
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

Der LargeItemLimit-Parameter gibt die maximale Anzahl großer Elemente an, die zulässig sind, bevor die Migrationsanforderung fehlschlägt. Ein großes Element ist eine Nachricht im Quellpostfach, die die maximale Nachrichtengröße überschreitet, die im Zielpostfach zulässig ist. Wenn das Zielpostfach keine speziell konfigurierte maximale Nachrichtengröße aufweist, wird der unternehmensweite Wert verwendet.

Weitere Informationen über die Werte der maximalen Nachrichtengröße finden Sie in den folgenden Themen:

Eine gültige Eingabe für diesen Parameter ist eine Ganzzahl oder der Wert "Unlimited". Der Standardwert ist 0. Dies bedeutet, dass die Migrationsanforderung fehlschlägt, wenn große Elemente erkannt werden. Wenn Sie einige große Elemente zurücklassen möchten, können Sie diesen Parameter auf einen vernünftigen Wert festlegen (wir empfehlen 10 oder niedriger), damit die Migrationsanforderung fortgesetzt werden kann.

Hinweis: Dieser Parameter wird im cloudbasierten Dienst eingestellt. Wenn Sie diesen Parameter in Zukunft nicht mehr verwenden, wird stattdessen die Semantik der Genehmigung übersprungener Elemente verwendet.

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

Der Parameter MoveOptions gibt die Phasen der Migration an, die Sie zu Debugzwecken überspringen möchten. Verwenden Sie diesen Parameter nur, wenn Sie durch den Microsoft-Kundendienst und -Support oder laut einer spezifischen Dokumentation dazu aufgefordert werden.

Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter "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

Der NotificationEmails-Parameter gibt eine oder mehrere E-Mail-Adressen an, an die Berichte zum Migrationsstatus gesendet werden.

Wenn Sie diesen Parameter nicht verwenden, wird der Statusbericht nicht gesendet.

Verwenden Sie die folgende Syntax, um mehrere Werte einzugeben und vorhandene Einträge zu überschreiben: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "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

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ReportInterval

Der Parameter ReportInterval gibt an, wie häufig Berichte per E-Mail an die in NotificationEmails aufgeführten E-Mail-Adressen gesendet werden sollen.

Standardmäßig werden E-Mail-Berichte alle 24 Stunden für einen Batch gesendet. Wenn Sie diesen Wert auf 0 festlegen, wird angegeben, dass für diesen Batch niemals Berichte gesendet werden sollen.

Dieser Parameter sollte nur im cloudbasierten Dienst verwendet werden.

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

Der Parameter SkipMerging gibt die Phasen der Migration an, die Sie aus Debugginggründen überspringen möchten. Verwenden Sie diesen Parameter nur, wenn Sie durch den Microsoft-Kundendienst und -Support oder laut einer spezifischen Dokumentation dazu aufgefordert werden.

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

Dieser Parameter wurde durch den Parameter "MoveOptions" ersetzt.

Der Parameter SkipMoving gibt die Phasen der Migration an, die Sie aus Debugginggründen überspringen möchten. Verwenden Sie diesen Parameter nur, wenn Sie durch den Microsoft-Kundendienst und -Support oder laut einer spezifischen Dokumentation dazu aufgefordert werden.

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

Der Schalter SkipReports gibt an, dass Sie die automatische Berichterstellung für die Migration überspringen möchten. Sie müssen bei dieser Option keinen Wert angeben.

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter SourcePublicFolderDatabase gibt die Quelldatenbank für öffentliche Ordner an, die bei einer Migration öffentlicher Ordner verwendet wird. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:

  • Name
  • Distinguished Name (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

Der Parameter StartAfter gibt eine Verzögerung an, bevor die Datenmigration für die Benutzer im Batch gestartet wird. Die Migration wird vorbereitet, aber die eigentliche Datenmigration für Benutzer innerhalb des Batches beginnt erst nach dem Datum/der Uhrzeit, das Sie mit diesem Parameter angeben.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

Wenn Sie in Exchange Online PowerShell einen Datums-/Uhrzeitwert ohne Zeitzone angeben, befindet sich der Wert in koordinierter Weltzeit (UTC). Verwenden Sie eine der folgenden Optionen, um einen Wert anzugeben:

  • Geben Sie den Datums-/Uhrzeitwert in UTC an: Beispiel: "7/30/2020 9:00PM Z".
  • Geben Sie den Datums-/Uhrzeitwert in Ihrer lokalen Zeitzone an. Beispiel: "7/30/2020 9:00PM -700". Wenn Sie den TimeZone-Parameter nicht verwenden, wird der Wert in UTC konvertiert.
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

Der SyncNow-Switch startet eine sofortige Synchronisierung für Benutzer, die den Status "Synchronisiert" erreicht haben, setzt jedoch keine Fehlerhaften Benutzer fort. Sie müssen bei dieser Option keinen Wert angeben.

Mit dieser Option können Sie Onboarding-Verschiebungen beschleunigen, indem Sie die Option unmittelbar vor Fertigstellung der Verschiebung verwenden. Für IMAP-Migrationen können Sie diese Option nach dem MX-Eintrag-Switchover verwenden.

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

Der Schalter Update legt das Update-Flag für den Migrationsbatch fest. Sie müssen bei dieser Option keinen Wert angeben.

Das Update-Flag löst den Migrationsdienst aus, alle Einstellungen vom Endpunkt, Batch und Benutzer auf den Migrationsprozess erneut anzuordnen.

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

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.