Set-MigrationUser
Cette applet de commande est fonctionnelle uniquement dans le service cloud.
Utilisez la cmdlet Set-MigrationUser pour modifier les paramètres de migration d’un utilisateur dans un lot de migration existant.
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-MigrationUser
[-Identity] <MigrationUserIdParameter>
[-ApproveSkippedItems]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Partition <MailboxIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-WhatIf]
[<CommonParameters>]
Description
Certains paramètres peuvent être appliqués à la fois au lot et à des utilisateurs individuels au sein du lot. Un paramètre appliqué à un utilisateur remplace tout paramètre correspondant dans le lot.
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-MigrationUser -Identity laura@contoso.com -LargeItemLimit 15 -BadItemLimit 15
Cet exemple modifie la limite d’éléments importants et les éléments défectueux pour l’utilisateur laura@contoso.com dans un lot de migration existant.
Exemple 2
Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItems
Cet exemple approuve tous les éléments ignorés rencontrés pour l’utilisateur laura@contoso.com dans un lot de migration existant.
Paramètres
-ApproveSkippedItems
Applicable : Exchange Online
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le commutateur ApproveSkippedItems marque comme approuvés tous les éléments ignorés qui ont été détectés avant l’heure actuelle. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Si la perte de données détectée au cours de cette migration est importante, celle-ci ne peut pas se terminer sans approuver les éléments ignorés. Il se peut que des éléments aient été ignorés parce qu’ils sont endommagés dans la boîte aux lettres source et impossibles à copier dans la boîte aux lettres cible, qu’ils sont supérieurs à la taille de message maximale autorisée configurée pour le client ou qu’ils ont été détectés 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, voir Limites d’Exchange Online.
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 |
-BadItemLimit
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange sur site.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Remarque : Ce paramètre est déconseillé dans le service cloud. Les administrateurs doivent examiner le score de cohérence des données et tous les éléments ignorés avant la fin de la 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 |
-CompleteAfter
Applicable : Exchange Online
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre CompleteAfter spécifie un délai avant que l’utilisateur n’ait terminé. La migration des données pour l’utilisateur commence mais ne se termine 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 MM/jj/aaaa, entrez 09/01/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 date/heure sans fuseau horaire, la valeur est en temps universel coordonné (UTC).
Pour spécifier une valeur date/heure pour ce paramètre, utilisez l’une des options suivantes :
- Spécifiez la valeur date/heure dans UTC : Par exemple, « 2021-05-06 14:30:00z ».
- Spécifiez la valeur date/heure sous la forme d’une formule qui convertit la date/heure de votre fuseau horaire local en UTC : Par exemple,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Pour plus d’informations, consultez Get-Date.
Propriétés du paramètre
| Type: | DateTime |
| 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
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 |
-DomainController
Applicable : 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 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 |
-Identity
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre Identity spécifie l’adresse de messagerie de l’utilisateur en cours de migration.
Vous pouvez également identifier l’utilisateur par la valeur GUID présente dans la propriété MigrationUser à partir de la sortie de la cmdlet Get-MigrationUser. Cette méthode d’identification est utile si vous avez accidentellement envoyé le même utilisateur dans plusieurs lots.
Propriétés du paramètre
| Type: | MigrationUserIdParameter |
| 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 |
-LargeItemLimit
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange sur site.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Remarque : Ce paramètre est déconseillé dans le service cloud. Les administrateurs doivent examiner le score de cohérence des données et tous les éléments ignorés avant la fin de la 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 |
-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 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 |
-StartAfter
Applicable : Exchange Online
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre StartAfter spécifie un délai avant le début de la migration des données pour l’utilisateur. La migration est préparée, mais la migration de données réelle pour l’utilisateur ne commence pas avant 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 MM/jj/aaaa, entrez 09/01/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 date/heure sans fuseau horaire, la valeur est en temps universel coordonné (UTC).
Pour spécifier une valeur date/heure pour ce paramètre, utilisez l’une des options suivantes :
- Spécifiez la valeur date/heure dans UTC : Par exemple, « 2021-05-06 14:30:00z ».
- Spécifiez la valeur date/heure sous la forme d’une formule qui convertit la date/heure de votre fuseau horaire local en UTC : Par exemple,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Pour plus d’informations, consultez Get-Date.
Propriétés du paramètre
| Type: | DateTime |
| 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 |
-SyncNow
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le commutateur SyncNow spécifie si une synchronisation incrémentielle doit être déclenchée pour l’utilisateur migré. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Une synchronisation incrémentielle copie les modifications récentes de la boîte aux lettres source dans la boîte aux lettres cible. Vous pouvez effectuer une synchronisation incrémentielle avant d’exécuter le lot de migration pour réduire le temps d’exécution.
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 |
-WhatIf
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.