Partager via

Get-MigrationEndpoint

Module:
Exchange PowerShell

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 Get-MigrationEndpoint pour récupérer les paramètres de point de terminaison de migration pour les serveurs source ou de destination pour les migrations Exchange intermédiaires ou à basculement, les migrations IMAP et les 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

ConnectionSettingsFilter 

Get-MigrationEndpoint
    -ConnectionSettings <ExchangeConnectionSettings>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

TypeFilter 

Get-MigrationEndpoint
    -Type <MigrationType>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Partition <MailboxIdParameter>]
    [-DiagnosticInfo <String>]
    [<CommonParameters>]

Identity 

Get-MigrationEndpoint
    [[-Identity] <MigrationEndpointIdParameter>]
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Partition <MailboxIdParameter>]
    [-DiagnosticInfo <String>]
    [<CommonParameters>]

Description

La cmdlet Get-MigrationEndpoint récupère les paramètres des 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.
  • 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 :

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

Get-MigrationEndpoint -Identity OnboardingME01

Cet exemple récupère les paramètres du point de terminaison de la migration, OnboardingME01.

Paramètres

-ConnectionSettings

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

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

Le paramètre ConnectionSettings permet de spécifier les paramètres de configuration des serveurs source ou cible pour lesquels rechercher un point de terminaison correspondant.

Propriétés des paramètres

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

Jeux de paramètres

ConnectionSettingsFilter
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Diagnostic

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

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

Le commutateur Diagnostic indique si des informations extrêmement détaillées doivent être renvoyées dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

En règle générale, vous utilisez ce commutateur uniquement à la demande du Support technique et Service clientèle Microsoft pour résoudre les problèmes.

Propriétés des paramètres

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

-DiagnosticArgument

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

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

Le paramètre DiagnosticArgument modifie les résultats qui sont renvoyés à l’aide du commutateur Diagnostic. En règle générale, vous utilisez le commutateur Diagnostic et le paramètre DiagnosticArgument uniquement à la demande du Support technique et Service clientèle Microsoft pour résoudre les problèmes.

Propriétés des paramètres

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

-DiagnosticInfo

Applicable : Exchange Online

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

En règle générale, vous utilisez le paramètre DiagnosticInfo uniquement à la demande du service clientèle et du support technique Microsoft pour résoudre les problèmes. Les valeurs valides sont les suivantes :

  • attachmentid=String
  • batch=String
  • confirmer
  • duration=String
  • Points de terminaison
  • endtime=DateTime
  • maxsize=Int32
  • organization=String
  • partition=String
  • reportid=String
  • Rapports
  • showtimeline
  • showtimeslots=String
  • starttime=DateTime
  • status=String
  • stockage
  • type=String
  • user=String
  • verbeux

Propriétés des paramètres

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

-DomainController

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

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 des paramètres

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

-Identity

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

Le paramètre Identity spécifie le nom du point de terminaison de la migration pour lequel récupérer les paramètres.

Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.

Propriétés des paramètres

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

Jeux de paramètres

Identity
Position:1
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
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 des paramètres

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

-Type

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

Le paramètre Type permet de filtrer les résultats par type de migration. Le paramètre PasswordQuality indique le niveau de qualité minimal imposé aux mots de passe des appareils. La qualité des mots de passe est une échelle numérique qui indique le niveau de sécurité et de complexité du mot de passe. Plus la valeur de qualité est élevée, plus le mot de passe est sécurisé.

  • ExchangeOutlookAnywhere : migrations Exchange intermédiaires ou à basculement
  • ExchangeRemoteMove : déplacements et migrations à distance
  • IMAP : migrations IMAP
  • PublicFolder : migrations de dossiers publics

Propriétés des paramètres

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

Jeux de paramètres

TypeFilter
Position:Named
Obligatoire:True
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.