Set-MigrationEndpoint

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-MigrationEndpoint, um Einstellungen für Übernahme- oder mehrstufige Exchange-Migrationen, IMAP-Migrationen, Google Workspace-Migrationen (früher G Suite) und Remoteverschiebungen zu bearbeiten.

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

Syntax

Set-MigrationEndpoint
   [-Identity] <MigrationEndpointIdParameter>
   [-AcceptUntrustedCertificates <Boolean>]
   [-ApplicationId <String>]
   [-AppSecretKeyVaultUrl <String>]
   [-Authentication <AuthenticationMethod>]
   [-Confirm]
   [-Credentials <PSCredential>]
   [-DomainController <Fqdn>]
   [-ExchangeServer <String>]
   [-MailboxPermission <MigrationMailboxPermission>]
   [-MaxConcurrentIncrementalSyncs <Unlimited>]
   [-MaxConcurrentMigrations <Unlimited>]
   [-NspiServer <String>]
   [-Partition <MailboxIdParameter>]
   [-Port <Int32>]
   [-PublicFolderDatabaseServerLegacyDN <String>]
   [-RemoteServer <Fqdn>]
   [-RpcProxyServer <Fqdn>]
   [-Security <IMAPSecurityMechanism>]
   [-ServiceAccountKeyFileData <Byte[]>]
   [-SkipVerification]
   [-SourceMailboxLegacyDN <String>]
   [-TestMailbox <MailboxIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Verwenden Sie das Cmdlet Set-MigrationEndpoint, um Einstellungen für verschiedene Migrationstypen zu konfigurieren:

  • Gesamtstrukturübergreifende Verschiebung: Verschieben Sie Postfächer zwischen zwei verschiedenen lokalen Exchange-Gesamtstrukturen. Für gesamtstrukturübergreifende Verschiebungen muss ein RemoteMove-Endpunkt verwendet werden.
  • Remoteverschiebung: In einer Hybridbereitstellung umfasst eine Remoteverschiebung das Onboarding oder Offboarding von Migrationen. Für Remoteverschiebungen muss ein RemoteMove-Endpunkt verwendet werden. Das Onboarding verschiebt Postfächer aus einer lokalen Exchange-Organisation in Exchange Online und verwendet einen RemoteMove-Endpunkt als Quellendpunkt des Migrationsbatches. Das Offboarding verschiebt Postfächer von Exchange Online in eine lokale Exchange-Organisation und verwendet einen RemoteMove-Endpunkt als Zielendpunkt des Migrationsbatches.
  • Übernahmemigration von Exchange: Migrieren Sie alle Postfächer in einer lokalen Exchange-Organisation zu Exchange Online. Die Übernahmemigration von Exchange erfordert die Verwendung eines Exchange-Endpunkts.
  • Mehrstufige Exchange-Migration: Migrieren Sie eine Teilmenge von Postfächern aus einer lokalen Exchange-Organisation zu Exchange Online. Die mehrstufige Exchange-Migration erfordert die Verwendung eines Exchange-Endpunkts.
  • IMAP-Migration: Migrieren Sie Postfachdaten aus einer lokalen Exchange-Organisation oder einem anderen E-Mail-System zu Exchange Online. Für eine IMAP-Migration müssen Sie zuerst die Cloud-basierten Postfächer erstellen, bevor Sie Postfachdaten migrieren. Für IMAP-Migrationen muss ein IMAP-Endpunkt verwendet werden.
  • Gmail-Migration: Migrieren von Postfachdaten von einem Google Workspace-Mandanten zu Exchange Online. Für eine Google Workspace-Migration müssen Sie zuerst die cloudbasierten E-Mail-Benutzer oder Postfächer erstellen, bevor Sie Postfachdaten migrieren. Google Workspace-Migrationen erfordern die Verwendung eines Gmail-Endpunkts.
  • Lokal: Verschieben Sie Postfächer zwischen verschiedenen Servern oder Datenbanken innerhalb einer einzelnen lokalen Exchange-Gesamtstruktur. Für lokale Verschiebungen muss kein Endpunkt verwendet werden.

Weitere Informationen zu den verschiedenen Verschiebungs- und Migrationsszenarien finden Sie unter:

An einem Endpunkt vorgenommene Änderungen, die sich auf die einzelnen Benutzer innerhalb des Batches auswirken, werden ab der nächsten Verarbeitung des Batches angewendet. Wenn Sie dieses Cmdlet im cloudbasierten Dienst ausführen und die Anwendung dieser Einstellungen beschleunigen möchten, sollten Sie das Cmdlet Set-MigrationBatch mit dem Parameter -Update ausführen.

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-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.com

In diesem Beispiel wird die Einstellung MaxConcurrentIncrementalSyncs am Migrationsendpunkt "CutoverExchangeEndpoint01" mithilfe des NSPI-Servers "Server01" in 50 geändert.

Beispiel 2

Set-MigrationEndpoint -Identity Onboardingmigrationendpoint01 -MaxConcurrentMigrations 10 -RemoteServer Server01.contoso.com

In diesem Beispiel wird die Einstellung MaxConcurrentMigrations am Migrationsendpunkt "Onboardingmigrationendpoint01" mithilfe des Remoteservers, "Server01", in 10 geändert.

Parameter

-AcceptUntrustedCertificates

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill AcceptUntrustedCertificates Description }}

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

-ApplicationId

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill ApplicationId Description }}

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

-AppSecretKeyVaultUrl

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill AppSecretKeyVaultUrl Description }}

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

-Authentication

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter Authentication gibt die Authentifizierungsmethode an, die vom Remote-E-Mail-Server verwendet wird.

Type:AuthenticationMethod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-Credentials

Der Parameter Credentials gibt den Benutzernamen und das Kennwort für die Verbindung mit dem Remoteendpunkt an. Anmeldeinformationen sollten beim Erstellen eines Exchange-Endpunkts mit Staging oder Übernahme oder eines RemoteMove-Endpunkts verwendet werden.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Type:PSCredential
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

-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

-ExchangeServer

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter ExchangeServer gibt den lokalen Exchange-Quellserver für Übernahme- und mehrstufige Migrationen an. Dieser Parameter gilt nur für Bereitgestellte und Übernahme-Exchange-Endpunkte, die keine AutoErmittlung verwenden.

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

-Identity

Der Parameter Identity gibt den Namen des Migrationsendpunkts an, den Sie konfigurieren möchten.

Type:MigrationEndpointIdParameter
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

-MailboxPermission

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter MailboxPermission gibt an, welche Berechtigungen während des Outlook Anywhere-Onboardings (mehrstufige Exchange-Migration und Exchange-Übernahmemigration) für den Zugriff auf das Quellpostfach verwendet werden sollen. Dieser Parameter wird nicht für Nicht-Outlook Anywhere-Migrationen verwendet.

Das angegebene Konto muss über die folgenden Berechtigungen verfügen:

  • Vollzugriff. Das Konto verfügt über Vollzugriff auf die Postfächer, die migriert werden sollen.
  • Administratorberechtigung. Das Konto ist ein Domänenadministrator, der auf alle Postfächer zugreifen kann, die migriert werden sollen.
Type:MigrationMailboxPermission
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MaxConcurrentIncrementalSyncs

Der Parameter MaxConcurrentIncrementalSyncs gibt die maximale Gesamtanzahl inkrementeller Synchronisierungen an, die für diesen Endpunkt zu einem bestimmten Zeitpunkt zulässig sind. Dieser Wert muss kleiner als der Parameter MaxConcurrentMigrations sein oder diesem entsprechen.

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

-MaxConcurrentMigrations

Der Parameter MaxConcurrentMigrations gibt die maximale Anzahl von Postfächern an, die für diesen Endpunkt zu einem bestimmten Zeitpunkt migriert werden. Dieser Parameter gilt für alle Migrationstypen.

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

-NspiServer

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter NspiServer gibt den FQDN des Remote-NSPI-Servers (Name Service Provider Interface) an. Dieser Parameter gilt nur für Bereitgestellte und Übernahme-Exchange-Endpunkte, die keine AutoErmittlung verwenden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-Port

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Bei einer IMAP-Migration gibt der Parameter Port die TCP-Portnummer an, die bei der Migration zum Herstellen einer Verbindung mit dem Remoteserver verwendet wird.

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

-PublicFolderDatabaseServerLegacyDN

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

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

-RemoteServer

Der Parameter RemoteServer gibt den Remoteserver abhängig vom Protokolltyp für Verschiebungen an:

  • Exchange Server-Verschiebungen: Der FQDN eines Exchange-Servers, auf dem die Clientzugriffsrolle installiert ist, ein Clientzugriffsserverarray oder eine Gruppe von Clientzugriffsservern, die sich hinter einem unterstützten Netzwerklastenausgleich befinden.
  • IMAP-Verschiebungen: Der FQDN des IMAP-Servers.
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, Exchange Online

-RpcProxyServer

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Bei einer mehrstufigen Exchange-Migration gibt der Parameter RpcProxyServer den FQDN des RPC-Proxyservers für den lokalen Exchange-Server an. Dieser Parameter gilt nur für bereitgestellte und übernahmefähige Exchange-Endpunkte, die die AutoErmittlung nicht verwenden.

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

-Security

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Bei einer IMAP-Migration gibt der Security-Parameter die Verschlüsselungsmethode an, die vom Remote-E-Mail-Server verwendet wird. Mögliche Optionen sind None, Tls oder Ssl.

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

-ServiceAccountKeyFileData

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter ServiceAccountKeyFileData wird verwendet, um Informationen anzugeben, die für die Authentifizierung als Dienstkonto erforderlich sind. Die Daten sollten aus der JSON-Schlüsseldatei stammen, die beim Erstellen des Dienstkontos, dem Zugriff auf Ihren Remotemandanten gewährt wurde, heruntergeladen wird.

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.

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

-SkipVerification

Der SkipVerification-Schalter überspringt die Überprüfung, ob der Remoteserver erreichbar ist, wenn ein Migrationsendpunkt erstellt wird. Sie müssen bei dieser Option keinen Wert angeben.

Type:SwitchParameter
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

-SourceMailboxLegacyDN

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter SourceMailboxLegacyDN gibt ein Postfach auf dem Zielserver an. Verwenden Sie "LegacyExchangeDN" für das lokale Testpostfach als Wert für diesen Parameter. Das Cmdlet versucht, mithilfe der Anmeldeinformationen für das Administratorkonto auf dem Zielserver auf dieses Postfach zuzugreifen.

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

-TestMailbox

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter TestMailbox gibt ein Postfach auf dem Zielserver an. Verwenden Sie die primäre SMTP-Adresse als Wert für diesen Parameter. Das Cmdlet versucht, mithilfe der Anmeldeinformationen für das Administratorkonto auf dem Zielserver auf dieses Postfach zuzugreifen.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.