Partager via


Set-MigrationBatch

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

La cmdlet Set-MigrationBatch permet de mettre à jour une demande de migration pour un lot d’utilisateurs. Pour plus d’informations, consultez la rubrique New-MigrationBatch.

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-MigrationBatch
   [-Identity] <MigrationBatchIdParameter>
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ApproveSkippedItems]
   [-AutoRetryCount <Int32>]
   [-BadItemLimit <Unlimited>]
   [-CSVData <Byte[]>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <TimeSpan>]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports <Boolean>]
   [-SourcePublicFolderDatabase <DatabaseIdParameter>]
   [-StartAfter <DateTime>]
   [-SyncNow]
   [-Update]
   [-WhatIf]
   [<CommonParameters>]

Description

La cmdlet Set-MigrationBatch configure vos lots de migration existants afin de migrer les boîtes aux lettres et les données de boîte aux lettres dans l'un des scénarios suivants :

  • Déplacement local
  • Déplacement inter-forêts
  • Déplacement distant
  • Migration Exchange à basculement
  • Migration Exchange intermédiaire
  • Migration de IMAP
  • Migration de Google Workspace (anciennement G Suite)

Certains paramètres peuvent être appliqués au lot ainsi qu’aux utilisateurs individuels du lot. Il est important de noter que lorsqu’un paramètre est appliqué à un utilisateur, il remplace tout paramètre correspondant sur le lot.

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-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems

Cet exemple met à jour MigrationBatch01 en approuvant tous les éléments ignorés pour tous les utilisateurs du lot détectés précédemment.

Paramètres

-AllowIncrementalSyncs

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

Le paramètre AllowIncrementalSyncs indique si la synchronisation incrémentielle doit être activée ou désactivée. Les valeurs valides sont les suivantes :

  • $true : la synchronisation incrémentielle est activée. Tous les nouveaux messages envoyés à la boîte aux lettres source sont copiés dans la boîte aux lettres cible correspondante une fois toutes les 24 heures.
  • $false : la synchronisation incrémentielle est désactivée. Le lot de migration passera à l’état Arrêté une fois la synchronisation initiale terminée. Pour effectuer un lot de migration pour les déplacements locaux, les déplacements entre forêts ou les migrations de déplacement à distance, vous devez activer la synchronisation incrémentielle.
Type:Boolean
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

-AllowUnknownColumnsInCsv

Le paramètre AllowUnknownColumnsInCsv spécifie si des colonnes supplémentaires qui ne sont pas utilisées par la migration sont autorisées dans le fichier CSV. Les valeurs valides sont les suivantes :

  • $true : la migration ignore (ignore silencieusement) les colonnes inconnues dans le fichier CSV (y compris les colonnes facultatives avec des en-têtes de colonne mal orthographiés). Toutes les colonnes inconnues sont traitées comme des colonnes supplémentaires qui ne sont pas utilisées par la migration.
  • $false : la migration échoue s’il existe des colonnes inconnues dans le fichier CSV. Ce paramètre protège des fautes d’orthographe dans les en-têtes de colonne. Il s’agit de la valeur par défaut.
Type:Boolean
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

-ApproveSkippedItems

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

Le commutateur ApproveSkippedItems marque tous les éléments ignorés qui ont été découverts avant l’heure actuelle comme approuvés. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si la perte de données détectée pendant cette migration est importante, la migration ne peut pas se terminer sans approuver les éléments ignorés. Les éléments ont peut-être été ignorés, car ils sont endommagés dans la boîte aux lettres source et ne peuvent pas être copiés dans la boîte aux lettres cible, ils sont supérieurs à la taille maximale autorisée des messages configuré pour le locataire ou ils ont été détectés comme manquants dans la boîte aux lettres cible lorsque la migration est prête à se terminer.

Pour plus d’informations sur les valeurs de taille maximale des messages, consultez la rubrique suivante Exchange Online Limites.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-AutoRetryCount

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

Le paramètre AutoRetryCount spécifie le nombre de tentatives de redémarrage du lot de migration pour migrer les boîtes aux lettres qui rencontrent des erreurs.

Type:Int32
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

-BadItemLimit

Le paramètre BadItemLimit spécifie le nombre maximal d’éléments incorrects autorisés avant l’échec de la demande de migration. Un élément incorrect est un élément endommagé dans la boîte aux lettres source ne pouvant pas être copié vers la boîte aux lettres cible. Les éléments manquants sont également inclus dans la limite d’éléments incorrects. Les éléments manquants sont des éléments de la boîte aux lettres source introuvables dans la boîte aux lettres cible lorsque la demande de migration est prête à se terminer.

L’entrée valide pour ce paramètre est un nombre entier ou la valeur unlimited. La valeur par défaut est 0, ce qui signifie que la demande de migration échoue si des éléments incorrects sont détectés. Si vous êtes d’accord pour laisser quelques éléments incorrects derrière, vous pouvez définir ce paramètre sur une valeur raisonnable (nous recommandons 10 ou moins) afin que la demande de migration puisse continuer. Si trop d’éléments incorrects sont détectés, envisagez d’utiliser l’applet de commande New-MailboxRepairRequest pour tenter de corriger les éléments endommagés dans la boîte aux lettres source, puis réessayez la demande de migration.

Remarque : ce paramètre est disponible uniquement dans le service basé sur le cloud. À l’avenir, si vous n’utilisez pas ce paramètre, les sémantiques d’approbation des éléments ignorés seront utilisées à la place.

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

-CompleteAfter

Ce paramètre est fonctionnel uniquement dans le service cloud.

Le paramètre CompleteAfter spécifie un délai avant la fin du lot. La migration des données pour le lot démarre, mais la fin ne démarre pas avant la date/l’heure que vous spécifiez avec ce paramètre.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Dans Exchange Online PowerShell, si vous spécifiez une valeur de date/heure sans fuseau horaire, la valeur est en temps universel coordonné (UTC). Pour spécifier une valeur, utilisez l’une des options suivantes :

  • Spécifiez la valeur de date/heure au format UTC : Par exemple, "7/30/2020 9:00PM Z".
  • Spécifiez la valeur de date/heure dans votre fuseau horaire local. Par exemple : "7/30/2020 9:00PM -700". La valeur sera convertie en UTC si vous n’utilisez pas le paramètre TimeZone.
Type:DateTime
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

-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

-CSVData

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

Le paramètre CSVData spécifie le fichier CSV qui contient des informations sur les boîtes aux lettres d’utilisateur à déplacer ou à migrer. Les attributs requis dans la ligne d'en-tête du fichier CSV varient en fonction du type de migration.

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).

Remarque : ce paramètre ne valide pas la disponibilité des boîtes aux lettres en fonction de l’étendue RBAC. Toutes les boîtes aux lettres spécifiées dans le fichier CSV seront migrées, même si elles sont en dehors de l’étendue RBAC (par exemple, une unité d’organisation) qui donne à l’administrateur des autorisations pour migrer des boîtes aux lettres.

Type:Byte[]
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

-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

-Identity

Le paramètre Identity spécifie le lot de migration que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le lot de migration. Par exemple :

  • Nom (valeur de propriété Identity)
  • GUID (valeur de la propriété BatchGuid)
Type:MigrationBatchIdParameter
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

-LargeItemLimit

Le paramètre LargeItemLimit spécifie le nombre maximal d’éléments volumineux autorisés avant l’échec de la demande de migration. Un élément volumineux est un message dans la boîte aux lettres source qui dépasse la taille de message maximale autorisée dans la boîte aux lettres cible. Si aucune valeur de taille de message maximale n’est spécifiquement configurée pour la boîte aux lettres cible, la valeur à l’échelle de l’organisation est utilisée.

Pour plus d’informations sur les valeurs de taille de message maximale, consultez les rubriques suivantes :

L’entrée valide pour ce paramètre est un nombre entier ou la valeur unlimited. La valeur par défaut est 0, ce qui signifie que la demande de migration échoue si des éléments volumineux sont détectés. Si vous êtes d’accord pour laisser quelques éléments volumineux derrière, vous pouvez définir ce paramètre sur une valeur raisonnable (nous recommandons 10 ou moins) afin que la demande de migration puisse continuer.

Remarque : ce paramètre est disponible uniquement dans le service basé sur le cloud. À l’avenir, si vous n’utilisez pas ce paramètre, les sémantiques d’approbation des éléments ignorés seront utilisées à la place.

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

-MoveOptions

Le paramètre MoveOptions spécifie les étapes de la migration que vous souhaitez ignorer à des fins de débogage. N'utilisez ce paramètre qu'en cas d'instructions de la part d'un professionnel du support technique Microsoft ou d’une documentation spécifique.

N’utilisez pas ce paramètre avec le paramètre SkipMoving.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-NotificationEmails

Le paramètre NotificationEmails spécifie une ou plusieurs adresses de messagerie auxquelles sont envoyés les rapports d’état de migration.

Si vous n'utilisez pas ce paramètre, le rapport d'état n'est pas envoyé.

Pour entrer plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Type:MultiValuedProperty
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

-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

-ReportInterval

Le paramètre ReportInterval spécifie la fréquence à laquelle les rapports envoyés par e-mail doivent être envoyés aux adresses e-mail répertoriées dans NotificationEmails.

Par défaut, les rapports envoyés par e-mail sont envoyés toutes les 24 heures pour un lot. La définition de cette valeur sur 0 indique que les rapports ne doivent jamais être envoyés pour ce lot.

Ce paramètre doit être utilisé uniquement dans le service cloud.

Type:TimeSpan
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

-SkipMerging

Le paramètre SkipMerging spécifie les étapes de la migration que vous souhaitez ignorer à des fins de débogage. N'utilisez ce paramètre qu'en cas d'instructions de la part d'un professionnel du support technique Microsoft ou d’une documentation spécifique.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SkipMoving

Ce paramètre a été remplacé par le paramètre MoveOptions.

Le paramètre SkipMoving spécifie les étapes de la migration que vous souhaitez ignorer à des fins de débogage. N'utilisez ce paramètre qu'en cas d'instructions de la part d'un professionnel du support technique Microsoft ou d’une documentation spécifique.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SkipReports

Le commutateur SkipReports spécifie que vous souhaitez ignorer la déclaration automatique pour la migration. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourcePublicFolderDatabase

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

Le paramètre SourcePublicFolderDatabase spécifie la base de données de dossiers publics source utilisée dans une migration de dossiers publics. Vous pouvez utiliser n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID
Type:DatabaseIdParameter
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

-StartAfter

Le paramètre StartAfter spécifie un délai avant le démarrage de la migration des données pour les utilisateurs du lot. La migration sera préparée, mais la migration de données réelle pour les utilisateurs du lot ne commencera qu’à la date/heure que vous spécifiez avec ce paramètre.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Dans Exchange Online PowerShell, si vous spécifiez une valeur de date/heure sans fuseau horaire, la valeur est en temps universel coordonné (UTC). Pour spécifier une valeur, utilisez l’une des options suivantes :

  • Spécifiez la valeur de date/heure au format UTC : Par exemple, "7/30/2020 9:00PM Z".
  • Spécifiez la valeur de date/heure dans votre fuseau horaire local. Par exemple : "7/30/2020 9:00PM -700". La valeur sera convertie en UTC si vous n’utilisez pas le paramètre TimeZone.
Type:DateTime
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

-SyncNow

Le commutateur SyncNow démarre une synchronisation immédiate pour les utilisateurs qui ont déjà atteint l’état Synchronisé, mais ne reprend aucun utilisateur Ayant échoué. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur pour accélérer les déplacements d’intégration en utilisant le commutateur juste avant la fin du déplacement. Pour les migrations IMAP, vous pouvez utiliser ce commutateur après le basculement d’enregistrement MX.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Update

Le commutateur Mettre à jour définit l’indicateur De mise à jour sur le lot de migration. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

L’indicateur De mise à jour déclenche le service de migration pour réappliquer tous les paramètres du point de terminaison, du lot et de l’utilisateur au processus de migration.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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.