Set-MigrationBatch

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-03-15

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. 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 SyntaxeSyntaxe de cmdlet Exchange.

Set-MigrationBatch -Identity <MigrationBatchIdParameter> [-AllowIncrementalSyncs <$true | $false>] [-AllowUnknownColumnsInCsv <$true | $false>] [-AutoRetryCount <Int32>] [-BadItemLimit <Unlimited>] [-CompleteAfter <DateTime>] [-Confirm [<SwitchParameter>]] [-CSVData <Byte[]>] [-DomainController <Fqdn>] [-LargeItemLimit <Unlimited>] [-NotificationEmails <MultiValuedProperty>] [-Partition <MailboxIdParameter>] [-ReportInterval <TimeSpan>] [-SkipMerging <MultiValuedProperty>] [-SkipMoving <MultiValuedProperty>] [-SkipReports <$true | $false>] [-SourcePublicFolderDatabase <DatabaseIdParameter>] [-StartAfter <DateTime>] [-SyncNow <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple met à jour MigrationBatch01 avec les nouveaux paramètres de configuration AutoRetryCount et AllowIncrementalSyncs.

Set-MigrationBatch -Identity MigrationBatch01 -AutoRetryCount 5 -AllowIncrementalSyncs $true

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 cutover (de conversion) Exchange

  • Migration intermédiaire Exchange

  • Migration IMAP

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir Section « Autorisations de migration et de déplacement de boîtes aux lettres » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Management.Migration.MigrationService.Batch.MigrationBatchIdParameter

Le paramètre Identity indique le nom du lot de migration pour lequel mettre à jour les paramètres de configuration.

AllowIncrementalSyncs

Facultatif

System.Boolean

Le paramètre AllowIncrementalSyncs spécifie s’il faut activer ou désactiver les synchronisations incrémentielles pour les déplacements et migrations de boîtes aux lettres.

AllowUnknownColumnsInCsv

Facultatif

System.Boolean

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. L’entrée valide pour ce paramètre est $true ou $false. La valeur par défaut est $false. Le comportement par défaut signifie que toute colonne supplémentaire dans le fichier CSV entraîne l’échec de la migration, mais ce comportement permet d’éviter des fautes d’orthographes accidentelles dans les en-têtes des colonnes facultatives. Si vous définissez la valeur de ce paramètre sur $true et que le fichier CSV contient une colonne facultative dont le nom est incorrect, la migration ignore de manière silencieuse cette colonne (cette dernière est traitée comme une colonne supplémentaire non utilisée par la migration).

AutoRetryCount

Facultatif

System.Int32

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.

BadItemLimit

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre BadItemLimit indique 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 qui ne figurent pas dans la boîte aux lettres cible lorsque la demande de migration est prête à être exécutée.

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 l’abandon de quelques éléments incorrects ne vous pose pas de problème, vous pouvez définir ce paramètre sur une valeur raisonnable (recommandation : 10 ou moins) afin que la demande de migration se poursuive. Si trop d’éléments incorrects sont détectés, envisagez d’utiliser la cmdlet New-MailboxRepairRequest pour tenter de réparer les éléments endommagés dans la boîte aux lettres source, puis réessayez la demande de migration.

CompleteAfter

Facultatif

System.DateTime

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

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

CSVData

Facultatif

System.Byte[]

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. Pour la valeur de ce paramètre, utilisez le format suivant : ([System.IO.File]::ReadAllBytes(<path of the CSV migration file>)). Ce qui suit est un exemple : CSVData:([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\MigrationBatch_1.csv"))

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

LargeItemLimit

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre LargeItemLimit indique 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écialement 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 l’abandon de quelques éléments volumineux ne vous pose pas de problème, vous pouvez définir ce paramètre sur une valeur raisonnable (recommandation : 10 ou moins) afin que la demande de migration se poursuive.

NotificationEmails

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre NotificationEmails spécifie une ou plusieurs adresses de messagerie auxquelles sont envoyés les rapports d’état de migration. Spécifiez la valeur comme un tableau de chaînes et séparez les adresses électroniques par des virgules.

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

Partition

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

ReportInterval

Facultatif

System.TimeSpan

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

SkipMerging

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

VALEUR_PARAMÈTRE : MultiValuedProperty

SkipMoving

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

VALEUR_PARAMÈTRE : MultiValuedProperty

SkipReports

Facultatif

System.Boolean

PARAMVALUE : $true | $false

SourcePublicFolderDatabase

Facultatif

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

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

Le paramètre SourcePublicFolderDatabase spécifie le nom de la base de données de dossiers publics source utilisée lors d’une migration de dossiers publics.

StartAfter

Facultatif

System.DateTime

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

SyncNow

Facultatif

System.Management.Automation.SwitchParameter

PARAMVALUE : SwitchParameter

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

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.

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.

 
Afficher: