Set-MigrationEndpoint
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un 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.
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>]
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’une organisation Exchange locale 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 une organisation Exchange locale 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’une organisation Exchange locale 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’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 : 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 :
- La boîte aux lettres se déplace dans Exchange Server
- Gérer les déplacements de boîtes aux lettres locales dans Exchange Server
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 cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été 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.
{{ 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
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
{{ 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
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
{{ 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
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.
Type: | AuthenticationMethod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Confirm
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-*) ont 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.
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
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.
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
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 ».
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
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Identity
Le paramètre Identity définit le nom du point de terminaison de migration que vous souhaitez configurer.
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
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.
Type: | MigrationMailboxPermission |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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.
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
Le paramètre MaxConcurrentMigrations permet de définir le nombre maximum de boîtes aux lettres devant être migrées avec ce point de terminaison et à un moment spécifié. Ce paramètre est applicable pour tous les types de migration.
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
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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.
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-RemoteServer
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.
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
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
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Security
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.
Type: | IMAPSecurityMechanism |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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 à 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 a été 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
).
Type: | Byte[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SkipVerification
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.
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
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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.
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-WhatIf
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.
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 |
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.