Set-MigrationEndpoint

Module:: Exchange PowerShell

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

Utilisez l’applet de commande Set-MigrationEndpoint pour modifier les paramètres des migrations Exchange de basculement ou intermédiaires, 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 les 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 le retrait 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’une organisation Exchange locale vers Exchange Online et utilise un point de terminaison RemoteMove comme point de terminaison source du lot de migration. L’annulation déplace les boîtes aux lettres d’Exchange Online vers une organisation Exchange locale et utilise un point de terminaison RemoteMove comme point de terminaison cible du lot de migration.
Basculement Migration Exchange : migrez toutes les boîtes aux lettres d’une organisation Exchange locale vers Exchange Online. La migration du basculement Exchange nécessite l’utilisation d’un point de terminaison Exchange.
Migration Exchange en attente : migrez un sous-ensemble de boîtes aux lettres d’une organisation Exchange locale 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’une organisation Exchange locale 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 : migrez les données de boîte aux lettres d’un client Google Workspace vers Exchange Online. Pour une migration Google Workspace, vous devez d’abord créer les utilisateurs de messagerie ou les boîtes aux lettres dans 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 les boîtes aux lettres entre différents serveurs ou bases de données au sein d’une seule forêt Exchange locale. 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 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

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

Le paramètre AcceptUntrustedCertificates spécifie s’il faut accepter les certificats non approuvés du serveur distant. Les valeurs valides sont $true ou $false. Ce paramètre s’applique aux points de terminaison de migration ExchangeOutlookAnywhere et IMAP.

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

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

Le paramètre ApplicationId spécifie l’ID d’application de l’application inscrite dans Microsoft Entra ID utilisée pour l’authentification inter-locataires dans les points de terminaison de migration ExchangeRemoteMove. Utilisez ce paramètre avec AppSecretKeyVaultUrl.

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

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

Le paramètre AppSecretKeyVaultUrl spécifie l’URL Azure Key Vault qui contient le secret d’application utilisé pour l’authentification inter-clients dans les points de terminaison de migration ExchangeRemoteMove. Utilisez ce paramètre avec l’ApplicationId.

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

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

Le paramètre Authentification 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

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.

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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.

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

Le paramètre Informations d’identification 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 modification d’un point de terminaison Exchange intermédiaire ou de 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

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

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 de basculement et intermédiaires. Ce paramètre s’applique uniquement aux points de terminaison Exchange intermédiaire et de 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

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

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

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

Le paramètre MaxConcurrentMigrations spécifie le nombre maximal de boîtes aux lettres migrées pour ce point de terminaison à un moment donné. 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

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édiaire et de 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

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

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

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

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

Déplacements de serveur Exchange : nom de domaine complet d’un serveur Exchange sur lequel le rôle d’accès au client est installé, d’un réseau 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.
Déplacements IMAP : 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

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

Pour les migrations Exchange intermédiaire et de basculement, 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édiaire et de 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

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

Pour une migration IMAP, le paramètre Sécurité spécifie la méthode de chiffrement utilisée par le serveur de messagerie distant. 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

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 pour s’authentifier 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 nécessite que vous lisiez le fichier dans un objet codé en octet à 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

Le commutateur SkipVerification ignore la vérification de l’accessibilité du serveur distant lors de la modification 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

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

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

Le commutateur WhatIf affiche ce que la commande fait sans apporter de 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 communs : -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.

Commentaires

Est-ce que cette page vous a été utile?