Complete-MigrationBatch
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen können für die eine oder die andere Umgebung exklusiv sein.
Verwenden Sie das Cmdlet Complete-MigrationBatch, um einen Migrationsbatch abzuschließen, der die erste Synchronisierung erfolgreich abgeschlossen hat.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Complete-MigrationBatch
[[-Identity] <MigrationBatchIdParameter>]
[-CompletePublicFolderMigrationWithDataLoss]
[-Confirm]
[-DomainController <Fqdn>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-SyncAndComplete]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Nachdem ein Migrationsbatch erfolgreich ausgeführt wurde und über eine status Synced oder SyncedWithErrors verfügt, verwenden Sie das Cmdlet Complete-MigrationBatch, um den Migrationsbatch abzuschließen. Beim Abschluss eines Migrationsbatches führt das Cmdlet für jedes Postfach im Migrationsbatch folgende Schritte aus:
- Eine letzte inkrementelle Synchronisierung wird ausgeführt.
- Konfiguriert das Microsoft Outlook-Profil des Benutzers so, dass es auf die neue Zieldomäne verweist.
- Das Quellpostfach wird in einen E-Mail-aktivierten Benutzer in der Quelldomäne konvertiert.
Im cloudbasierten Dienst legt dieses Cmdlet den Wert CompleteAfter auf die aktuelle UTC-Zeit fest, was dem Migrationsdienst signalisiert, den Batch so schnell wie möglich abzuschließen. Dies entspricht der Ausführung Set-MigrationBatch -CompleteAfter (Get-Date)von , jedoch ohne Mehrdeutigkeit bei der Zeitzonenkonvertierung.
Beachten Sie das folgende Verhalten, wenn Sie dieses Cmdlet in Exchange Online verwenden:
- Jede CompleteAfter-Einstellung, die auf einzelne Benutzer innerhalb des Batches angewendet wird, setzt die Einstellung auf Batchebene außer Kraft, sodass der Abschluss für einige Benutzer bis zu ihrer konfigurierten Zeit verzögert werden kann.
- Wenn Sie dieses Cmdlet innerhalb von 8 Stunden mehrmals ausführen, nachdem der Batch bereits für den Abschluss signalisiert wurde, verarbeitet der Migrationsdienst die Anforderung möglicherweise nicht erneut. Dieses Verhalten ist beabsichtigt, um zu verhindern, dass wiederholte Aufrufe den Dienst verhungern. Wenn der Batch nach dem Ausführen des Cmdlets hängen bleibt, suchen Sie nach nicht genehmigten übersprungenen Elementen (verwenden Sie
Set-MigrationUser -ApproveSkippedItems).
Wenn der Abschlussvorgang beendet ist, können Sie den Batch mithilfe des Cmdlets Remove-MigrationBatch entfernen.
Wenn ein Migrationsbatch über die status Mit Fehlern abgeschlossen verfügt, können Sie erneut versuchen, die fehlerhaften Benutzer abzuschließen. Verwenden Sie in Exchange Online das Cmdlet Start-MigrationBatch, um die Migration für fehlgeschlagene Benutzer erneut zu versuchen. Verwenden Sie in Exchange 2013 oder höher die Complete-MigrationBatch, um diese fehlerhaften Benutzer zu wiederholen.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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
Complete-MigrationBatch -Identity LocalMove1 -NotificationEmails admin@contoso.com,lucio@contoso.com
In diesem Beispiel wird der Migrationsbatch "LocalMove1" abgeschlossen, und eine Benachrichtigungs-E-Mail wird an die angegebenen Benutzer gesendet.
Parameter
-CompletePublicFolderMigrationWithDataLoss
Anwendbar: Exchange Online
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise 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.
Dieses Cmdlet verfügt über eine integrierte Pause. Verwenden Sie -Confirm:$false daher , um die Bestätigung zu überspringen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Cf |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DomainController
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Parametereigenschaften
| Typ: | Fqdn |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Parameter Identity gibt den Namen des Migrationsbatches an, das Sie abschließen möchten. Der Wert für diesen Parameter wird vom Parameter Name für das Cmdlet New-MigrationBatch angegeben. Verwenden Sie das Cmdlet Get-MigrationBatch, um den Wert dieses Parameters für den Migrationsbatch zu bestimmen.
Parametereigenschaften
| Typ: | MigrationBatchIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-NotificationEmails
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter NotificationEmails legt eine oder mehrere E-Mail-Adressen fest, an welche nach Abschluss des Migrationsbatches Statusberichte gesendet werden. Mehrere E-Mail-Adressen können durch Kommas getrennt angegeben werden.
Wenn Sie diesen Parameter nicht verwenden, wird der abschließende Statusbericht an den Administrator gesendet, der das Cmdlet Complete-MigrationBatch ausführt.
Parametereigenschaften
| Typ: | MultiValuedProperty |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Partition
Anwendbar: Exchange Online
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | MailboxIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SyncAndComplete
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Schalter SyncAndComplete gibt an, ob eine endgültige inkrementelle Synchronisierung unmittelbar nach Abschluss des Migrationsbatches ausgelöst werden soll, wenn die Synchronisierung erfolgreich war. Sie müssen keinen Wert für diese Option angeben.
Wenn dieser Schalter verwendet wird, muss der Batch keine fehlerhaften, beschädigten oder beendeten Elemente aufweisen. Andernfalls gibt das Cmdlet einen Fehler zurück.
Hinweis: Für Migrationsbatches für öffentliche Ordner ist dieser Schalter standardmäßig aktiviert, es sei denn, der CompletePublicFolderMigrationWithDataLoss-Schalter ist ebenfalls angegeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet keine Eingabedaten.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.
Hinweise
In Exchange Online wird dieses Cmdlet für die folgenden Migrationstypen unterstützt:
- Lokale Exchange-Verschiebung
- Exchange Remote Move
- Gmail
- Google-Ressource
- Lokale Verlagerung
- Ordner verschieben
- PST-Import
- Öffentlicher Ordner
- Öffentlicher Ordner in einheitliche Gruppe
In Exchange Online wird dieses Cmdlet nicht für IMAP-, Exchange Outlook Anywhere-Stagingmigrationen (Übernahme) oder Massenbereitstellungsmigrationen unterstützt, die keinen Abschlussschritt aufweisen.