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 au lot ainsi qu’aux utilisateurs individuels du lot. Un paramètre appliqué à un utilisateur remplace tout paramètre correspondant sur 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 montre comment modifier la limite d’éléments volumineux et la limite d’é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 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.
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 Online
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 déprécié. À l’avenir, si vous n’utilisez pas ce paramètre, la sémantique d’approbation des éléments ignorés est utilisée à la place.
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 la fin de l’exécution de l’utilisateur. 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 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 date/heure pour ce paramètre, utilisez l’une des options suivantes :
- Spécifiez la valeur de date/heure utc : par exemple, « 2021-05-06 14:30:00z ».
- Spécifiez la valeur de date/heure en tant que formule qui convertit la date/heure de votre fuseau horaire local au format 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 Online
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-*) 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 cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
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
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 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 Online
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 :
- Exchange 2016 : Limites de taille des messages dans Exchange Server
- Exchange Online : Limites d’Exchange Online
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 déprécié. À l’avenir, si vous n’utilisez pas ce paramètre, la sémantique d’approbation des éléments ignorés est utilisée à la place.
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émarrage de la migration des données pour l’utilisateur. La migration est préparée, mais la migration réelle des données pour l’utilisateur ne commence 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 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 date/heure pour ce paramètre, utilisez l’une des options suivantes :
- Spécifiez la valeur de date/heure utc : par exemple, « 2021-05-06 14:30:00z ».
- Spécifiez la valeur de date/heure en tant que formule qui convertit la date/heure de votre fuseau horaire local au format 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 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 Online
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.
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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.