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:
- Postfachverschiebungen in Exchange Server
- Verwalten von lokalen Postfachverschiebungen in Exchange Server
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.