Partager via


Set-MigrationEndpoint

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et paramètres peuvent être exclusifs à un environnement ou à l’autre.

Utilisez l’applet de commande Set-MigrationEndpoint pour modifier les paramètres des migrations Exchange intermédiaires ou à basculement, des migrations IMAP, des migrations Google Workspace (anciennement G Suite) et des déplacements à distance.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

Default (Par défaut)

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

Description

La cmdlet Set-MigrationEndpoint permet de configurer les paramètres pour différents types de migration :

  • Déplacement inter-forêts : déplacez des boîtes aux lettres entre deux forêts Exchange locales différentes. Les déplacements inter-forêts nécessitent l'utilisation d'un point de terminaison RemoteMove.
  • Déplacement à distance : dans un déploiement hybride, un déplacement à distance implique l’intégration ou la désintégration des migrations. Les déplacements distants nécessitent l'utilisation d'un point de terminaison RemoteMove. L’intégration déplace les boîtes aux lettres d’un organization Exchange local vers Exchange Online et utilise un point de terminaison RemoteMove comme point de terminaison source du lot de migration. La désintégration déplace les boîtes aux lettres de Exchange Online vers un organization Exchange local et utilise un point de terminaison RemoteMove comme point de terminaison cible du lot de migration.
  • Migration Exchange à basculement : migrez toutes les boîtes aux lettres d’un organization Exchange local vers Exchange Online. La migration Exchange à basculement nécessite l’utilisation d’un point de terminaison Exchange.
  • Migration Exchange intermédiaire : migrez un sous-ensemble de boîtes aux lettres d’un organization Exchange local vers Exchange Online. La migration Exchange intermédiaire nécessite l’utilisation d’un point de terminaison Exchange.
  • Migration IMAP : migrez les données de boîte aux lettres d’un organization Exchange local ou d’un autre système de messagerie vers Exchange Online. Pour une migration IMAP, vous devez d'abord créer les boîtes aux lettres basées sur un nuage avant de migrer les données de boîte aux lettres. Les migrations IMAP nécessitent l'utilisation d'un point de terminaison IMAP.
  • Migration Gmail : migration des données de boîte aux lettres d’un locataire Google Workspace vers Exchange Online. Pour une migration Google Workspace, vous devez d’abord créer les utilisateurs ou boîtes aux lettres de messagerie basés sur le cloud avant de migrer les données de boîte aux lettres. Les migrations Google Workspace nécessitent l’utilisation d’un point de terminaison Gmail.
  • Local : déplacez des boîtes aux lettres entre différents serveurs ou bases de données au sein d’une forêt Exchange locale unique. Les déplacements locaux ne nécessitent pas l'utilisation d'un point de terminaison.

Pour plus d'informations sur les différents scénarios de déplacement et de migration, consultez les ressources suivantes :

Les modifications apportées à un point de terminaison qui affectent les utilisateurs individuels dans le lot sont appliquées à partir de la prochaine fois que le lot est traité. Si vous exécutez cette applet de commande dans le service cloud et que vous souhaitez accélérer l’application de ces paramètres, envisagez d’exécuter l’applet de commande Set-MigrationBatch avec le paramètre -Update.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Set-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.com

Cet exemple remplace le paramètre MaxConcurrentIncrementalSyncs par 50 sur le point de terminaison de migration CutoverExchangeEndpoint01 à l'aide du serveur NSPI Server01.

Exemple 2

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

Cet exemple remplace le paramètre MaxConcurrentMigrations par 10 sur le point de terminaison de migration Onboardingmigrationendpoint01 à l'aide du serveur distant Server01.

Paramètres

-AcceptUntrustedCertificates

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

{{ Fill AcceptUntrustedCertificates Description }}

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ApplicationId

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

{{ Fill ApplicationId Description }}

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AppSecretKeyVaultUrl

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

{{ Fill AppSecretKeyVaultUrl Description }}

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Authentication

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre Authentication spécifie la méthode d’authentification utilisée par le serveur de messagerie distant.

Propriétés du paramètre

Type:AuthenticationMethod
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Credentials

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le paramètre Credentials spécifie le nom d’utilisateur et le mot de passe pour la connexion au point de terminaison distant. Les informations d’identification doivent être utilisées lors de la création d’un point de terminaison Exchange intermédiaire ou à basculement, ou d’un point de terminaison RemoteMove.

Une valeur pour ce paramètre nécessite l’applet de commande Get-Credential. Pour interrompre la commande et recevoir une invite à entrer les informations d’identification, utilisez la valeur (Get-Credential). Sinon, avant d’exécuter cette commande, stockez les informations d’identification dans une variable (par exemple, $cred = Get-Credential), puis utilisez le nom de cette variable name ($cred) pour ce paramètre. Pour plus d’informations, voir Get-Credential.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DomainController

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Propriétés du paramètre

Type:Fqdn
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExchangeServer

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre ExchangeServer spécifie le serveur Exchange source local pour les migrations intermédiaires et à basculement. Ce paramètre s’applique uniquement aux points de terminaison Exchange intermédiaires et à basculement qui n’utilisent pas la découverte automatique.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le paramètre Identity définit le nom du point de terminaison de migration que vous souhaitez configurer.

Propriétés du paramètre

Type:MigrationEndpointIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MailboxPermission

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre MailboxPermission spécifie les autorisations à utiliser pour accéder à la boîte aux lettres source lors de la migration par embarquement d'OutlookAnywhere (migration Exchange intermédiaire et migration Exchange à basculement). Ce paramètre ne concerne pas les migrations non-Outlook.

Le compte spécifié doit disposer des autorisations suivantes :

  • Autorisation FullAccess. Le compte dispose d'une autorisation d'accès total aux boîtes aux lettres à migrer.
  • Autorisation Administrateur. Le compte est un administrateur de domaine qui peut accéder à toute boîte aux lettres qu'il souhaite migrer.

Propriétés du paramètre

Type:MigrationMailboxPermission
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaxConcurrentIncrementalSyncs

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le paramètre MaxConcurrentIncrementalSyncs indique le nombre de synchronisations incrémentielles autorisées pour un point de terminaison à un moment déterminé. Cette valeur doit être inférieure ou égale au paramètre MaxConcurrentMigrations.

Propriétés du paramètre

Type:Unlimited
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaxConcurrentMigrations

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le paramètre MaxConcurrentMigrations spécifie le nombre maximal de boîtes aux lettres migrées pour ce point de terminaison à un moment spécifié. Ce paramètre est applicable pour tous les types de migration.

Propriétés du paramètre

Type:Unlimited
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NspiServer

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre NspiServer spécifies le nom de domaine complet (FQDN)sur le serveur distant NSPI (Name Service Provider Interface). Ce paramètre s’applique uniquement aux points de terminaison Exchange intermédiaires et à basculement qui n’utilisent pas la découverte automatique.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Partition

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Ce paramètre est réservé à l’usage interne chez Microsoft.

Propriétés du paramètre

Type:MailboxIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Port

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Dans le cadre d'une migration IMAP, le paramètre Port spécifie le numéro de port TCP utilisé par le processus de migration pour se connecter au serveur distant.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PublicFolderDatabaseServerLegacyDN

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Ce paramètre est réservé à l’usage interne chez Microsoft.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoteServer

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le paramètre RemoteServer spécifie le serveur distant en fonction du type de protocole pour les déplacements :

  • Déplacement du serveur Exchange : nom de domaine complet d’un serveur Exchange sur lequel le rôle d’accès au client est installé, d’un tableau de serveurs d’accès au client ou d’un groupe de serveurs d’accès au client situés derrière un équilibreur de charge réseau pris en charge.
  • IMAP se déplace : nom de domaine complet du serveur IMAP.

Propriétés du paramètre

Type:Fqdn
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RpcProxyServer

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Pour une migration Exchange intermédiaire, le paramètre RpcProxyServer spécifie le nom de domaine complet du serveur proxy RPC pour le serveur Exchange local. Ce paramètre s’applique uniquement aux points de terminaison Exchange intermédiaires et à basculement qui n’utilisent pas la découverte automatique

Propriétés du paramètre

Type:Fqdn
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Security

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Pour une migration IMAP, le paramètre Security spécifie la méthode de chiffrement utilisée par le serveur de messagerie à distance. Les options sont None, Tls ou Ssl.

Propriétés du paramètre

Type:IMAPSecurityMechanism
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ServiceAccountKeyFileData

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre ServiceAccountKeyFileData est utilisé pour spécifier les informations nécessaires à l’authentification en tant que compte de service. Les données doivent provenir du fichier de clé JSON qui est téléchargé lors de la création du compte de service auquel l’accès à votre locataire distant est accordé.

Une valeur valide pour ce paramètre vous oblige à lire le fichier dans un objet codé en octets à l’aide de la syntaxe suivante : ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Vous pouvez utiliser cette commande comme valeur de paramètre, ou vous pouvez écrire la sortie dans une variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) et utiliser la variable comme valeur de paramètre ($data).

Propriétés du paramètre

Type:

Byte[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SkipVerification

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le commutateur SkipVerification ignore la vérification que le serveur distant est accessible lors de la création d’un point de terminaison de migration. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SourceMailboxLegacyDN

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre SourceMailboxLegacyDN désigne une boîte aux lettres sur le serveur cible. Utilisez LegacyExchangeDN pour la boîte aux lettres de test locale comme valeur pour ce paramètre. Cette cmdlet tente d'accéder à la boîte aux lettres à l'aide des informations d'identification du compte d'administrateur sur le serveur cible.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TestMailbox

Applicable : Exchange Online

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre TestMailbox désigne une boîte aux lettres sur le serveur cible. Utilisez l'adresse SMTP principale comme valeur pour ce paramètre. Cette cmdlet tente d'accéder à la boîte aux lettres à l'aide des informations d'identification du compte d'administrateur sur le serveur cible.

Propriétés du paramètre

Type:MailboxIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.