Get-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 Get-MigrationBatch, um Statusinformationen zum aktuellen Migrationsbatch abzurufen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Identity
Get-MigrationBatch
[[-Identity] <MigrationBatchIdParameter>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DiagnosticInfo <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-Partition <MailboxIdParameter>]
[-ResultSize <Unlimited>]
[-Status <MigrationBatchStatus>]
[<CommonParameters>]
BatchesFromEndpoint
Get-MigrationBatch
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-Endpoint <MigrationEndpointIdParameter>]
[-IncludeReport]
[-Status <MigrationBatchStatus>]
[<CommonParameters>]
BatchesByEndpoint
Get-MigrationBatch
[-DiagnosticInfo <String>]
[-Endpoint <MigrationEndpointIdParameter>]
[-IncludeReport]
[-Partition <MailboxIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
BatchesByStatus
Get-MigrationBatch
[-DiagnosticInfo <String>]
[-IncludeReport]
[-Partition <MailboxIdParameter>]
[-ResultSize <Unlimited>]
[-Status <MigrationBatchStatus>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-MigrationBatch zeigt Statusinformationen über den aktuellen Migrationsbatch an. Diese umfassen Folgendes:
- Status des Migrationsbatch
- Gesamtanzahl von Postfächern, die migriert werden
- Anzahl der erfolgreich abgeschlossenen Migrationen
- Migrationsfehler
- Datum und Uhrzeit, zu dem die Migration gestartet und abgeschlossen wurde.
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.
Hinweis: Wenn Sie im cloudbasierten Dienst nicht den TimeZone-Parameter im Befehl New-MigrationBatch verwenden, ist die Standardzeitzone für den Migrationsbatch UTC. Die Eigenschaften CompleteAfter und CompleteAfterUTC enthalten denselben Wert (und auch die Eigenschaften StartAfter und StartAfterUTC). Wenn Sie den Migrationsbatch im Exchange Admin Center (EAC) erstellen, basiert die verwendete Zeitzone auf Ihrer regionalen Konfiguration.
Beispiele
Beispiel 1
Get-MigrationBatch -Identity LocalMove2
In diesem Beispiel werden Statusinformationen für den Migrationsbatch "LocalMove2" angezeigt.
Beispiel 2
Get-MigrationBatch -Endpoint exsrv1.contoso.com
In diesem Beispiel werden Informationen zu allen Migrationsbatches angezeigt, die dem Migrationsendpunkt "exsrv1.contoso.com" zugeordnet sind.
Parameter
-Diagnostic
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Dieser Parameter ist im lokalen Exchange verfügbar.
Die Option Diagnostic gibt an, ob sehr ausführliche Informationen in den Ergebnissen abgerufen werden sollen. Sie müssen keinen Wert für diese Option angeben.
Sie sollten diese Option nur verwenden, wenn Sie vom Microsoft-Kundendienst und -Support dazu aufgefordert werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesFromEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DiagnosticArgument
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Dieser Parameter ist im lokalen Exchange verfügbar.
Der DiagnosticArgument-Parameter ändert die Ergebnisse, die mithilfe der Option Diagnostic zurückgegeben werden. Sie sollten die Option Diagnostic und den DiagnosticArgument-Parameter nur verwenden, wenn Sie vom Microsoft-Kundendienst und -Support dazu aufgefordert werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesFromEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DiagnosticInfo
Anwendbar: Exchange Online
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Sie sollten den DiagnosticArgument-Parameter nur verwenden, wenn Sie vom Microsoft-Kundendienst und -Support dazu aufgefordert werden. Gültige Werte sind:
- attachmentid=String
- batch=String
- bestätigen
- duration=String
- endpoints
- endtime=DateTime
- maxsize=Int32
- organization=Zeichenfolge
- partition=String
- reportid=String
- Berichte
- showtimeline
- showtimeslots=String
- starttime=DateTime
- status=String
- Lagerung
- type=String
- user=String
- wortreich
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByStatus
| 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
Identity
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesFromEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Endpoint
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Parameter Endpoint gibt eine Liste mit Migrationsbatches zurück, die dem angegebenen Migrationsendpunkt zugeordnet sind.
Bei Verwendung dieses Parameters kann der Parameter Identity nicht verwendet werden.
Parametereigenschaften
| Typ: | MigrationEndpointIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
BatchesFromEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByEndpoint
| 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 identifiziert den Namen des aktuellen Migrationsbatches. Der Wert für diesen Parameter wird vom Parameter Name für das Cmdlet New-MigrationBatch angegeben.
Bei Verwendung dieses Parameters kann der Parameter Endpoint nicht verwendet werden.
Parametereigenschaften
| Typ: | MigrationBatchIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IncludeReport
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der IncludeReport-Schalter gibt zusätzliche Informationen zum angegebenen Migrationsbatch zurück. Sie müssen keinen Wert für diese Option angeben.
Diese Informationen werden im Feld Report angezeigt.
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 |
-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
Identity
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByStatus
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ResultSize
Anwendbar: Exchange Online
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.
Parametereigenschaften
| Typ: | Unlimited |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByStatus
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Status
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Parameter Status gibt eine Liste mit Migrationsbatches zurück, die den angegebenen Status aufweisen. Verwenden Sie einen der folgenden Werte:
- Abgeschlossen
- CompletedWithErrors
- Vervollständigend
- Beschädigt
- Erstellt
- Fehlgeschlagen
- IncrementalSyncing
- Entfernend
- Wird gestartet
- Beendet
- Zeitlich übereinstimmend
- Anhaltend
- Synchronisiert
- SyncedwithErrors
- Warten
Parametereigenschaften
| Typ: | MMigrationBatchStatus |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesFromEndpoint
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
BatchesByStatus
| 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 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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.