Remarque : L'intégration PowerShell nécessite un abonnement Pro ou Enterprise à ShareGate Migrate. Elle n'est pas disponible avec le plan Essentials.
Commande
New-MailboxCopyOptions
Description
Cette commande permet de créer des options de copie à utiliser lors d'une opération de copie de boîte aux lettres.
Pour en savoir plus sur vos options de copie de boîte aux lettres, consultez Survol de Copy mailboxes - Copy options.
Exemples
Copier uniquement les courriels des 90 derniers jours
$src = Connect-MicrosoftOnline
$dst = Connect-MicrosoftOnline
$copyOptions = New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart (Get-Date).AddDays(-90)
$mailboxesToCopy = Get-Mailbox -Connection $src -Id 272980f8-cba2-4b7f-b020-12ea922d92c5
$mappings = Import-MailboxMappings -SourceConnection $src -DestinationConnection $dst -Path "C:\mappings\SharegateMailboxesMapping.csv"
Copy-Mailbox -SourceConnection $src -DestinationConnection $dst -CopyOptions $copyOptions -MappingSettings $mappings -Mailboxes $mailboxesToCopy
Copier en utilisant la concurrence maximale de boîtes aux lettres
$src = Connect-MicrosoftOnline
$dst = Connect-MicrosoftOnline
$copyOptions = New-MailboxCopyOptions -IncludeEmails -MaxConcurrentMailboxes 128
$mailboxesToCopy = Get-Mailbox -Connection $src
$mappings = Import-MailboxMappings -SourceConnection $src -DestinationConnection $dst -Path "C:\mappings\SharegateMailboxesMapping.csv"
Copy-Mailbox -SourceConnection $src -DestinationConnection $dst -CopyOptions $copyOptions -MappingSettings $mappings -Mailboxes $mailboxesToCopy
Copier les courriels depuis le début jusqu'à aujourd'hui
$src = Connect-Google
$dst = Connect-MicrosoftOnline
$copyOptions = New-MailboxCopyOptions -IncludeEmails
$mailboxToCopy = Get-Mailbox -Connection $src -Id 123456789012345678901
$mappings = Import-MailboxMappings -SourceConnection $src -DestinationConnection $dst -Path "C:\mappings\SharegateMailboxesMapping.csv"
Copy-Mailbox -SourceConnection $src -DestinationConnection $dst -CopyOptions $copyOptions -MappingSettings $mappings -Mailboxes $mailboxToCopy
Copier les courriels d'une plage de dates et inclure les événements de calendrier avec de nouveaux liens
$startDate = [DateTime]::ParseExact("06-01-2024", "MM-dd-yyyy", $null)
$endDate = [DateTime]::ParseExact("12-01-2024", "MM-dd-yyyy", $null)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -EmailCopyRangeEnd $endDate -IncludeCalendar -CreateNewMeetingLinks
Copier les courriels depuis le début jusqu'à aujourd'hui et inclure les règles de boîte aux lettres
New-MailboxCopyOptions -IncludeEmails -IncludeMailboxRules
Copier uniquement les contacts
New-MailboxCopyOptions -IncludeContacts
Copier uniquement les calendriers avec tous les événements
New-MailboxCopyOptions -IncludeCalendar -CopyPastEvents
Copier uniquement les calendriers avec les événements à partir d'une date passée spécifiée
New-MailboxCopyOptions -IncludeCalendar -CopyPastEvents -CalendarCopyStartDate "2025-02-10"
Copier les événements de calendrier à partir d'aujourd'hui avec de nouveaux liens de réunion, les règles de boîte aux lettres, les contacts et les courriels des 180 derniers jours
$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -IncludeContacts -IncludeMailboxRules
Copier tous les événements de calendrier avec de nouveaux liens de réunion, les règles de boîte aux lettres, les contacts et les courriels des 180 derniers jours
$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -CopyPastEvents -IncludeContacts -IncludeMailboxRules
Copier les événements de calendrier à partir d'une date passée spécifiée avec de nouveaux liens de réunion, les règles de boîte aux lettres, les contacts et les courriels des 180 derniers jours
$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -CopyPastEvents -CalendarCopyStartDate "2025-01-01" -IncludeContacts -IncludeMailboxRules
Copier les courriels depuis le début jusqu'à aujourd'hui, y compris les éléments supprimés et indésirables
New-MailboxCopyOptions -IncludeEmails -IncludeMailboxRules -IncludeDeletedEmails -IncludeJunkEmails
Copier la conservation légale et remplacer les conservations existantes à la destination
New-MailboxCopyOptions -IncludeLitigationHold -ReplaceDestinationHolds
Syntaxe
New-MailboxCopyOptions
[-IncludeEmails <SwitchParameter>]
[-EmailCopyRangeStart <DateTime>]
[-EmailCopyRangeEnd <DateTime>]
[-IncludeCalendar <SwitchParameter>]
[-CreateNewMeetingLinks <SwitchParameter>]
[-CopyPastEvents <SwitchParameter>]
[-CalendarCopyStartDate <DateTime>]
[-IncludeContacts <SwitchParameter>]
[-IncludeMailboxRules <SwitchParameter>]
[-IncludeArchiveMailbox <SwitchParameter>]
[-IncludeDeletedEmails <SwitchParameter>]
[-IncludeJunkEmails <SwitchParameter>]
[-IncludeLitigationHold <SwitchParameter>]
[-ReplaceDestinationHolds <SwitchParameter>]
[-MaxConcurrentMailboxes <Int32>]
[-CopyToFolder <SwitchParameter>]
[-CopyIntoFolderName <String>]
Paramètres
-CalendarCopyStartDate <DateTime>
Spécifie la date de début à partir de laquelle les événements du calendrier seront migrés.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom du jeu de paramètres | (Tous) |
Alias | Aucun |
-CopyIntoFolderName <String>
Spécifie le nom du sous-dossier de destination lorsque -CopyToFolder est utilisé.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom du jeu de paramètres | (Tous) |
Alias | Aucun |
-CopyPastEvents <SwitchParameter>
Indique qu'il faut copier les événements passés du calendrier.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom du jeu de paramètres | (Tous) |
Alias | Aucun |
-CopyToFolder <SwitchParameter>
Indique qu'il faut copier le contenu de la boîte aux lettres dans un sous-dossier de destination au lieu de la racine de la boîte de réception.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom du jeu de paramètres | (Tous) |
Alias | Aucun |
-CreateNewMeetingLinks <SwitchParameter>
Indique qu'il faut remplacer les liens Teams dans les événements du calendrier.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-EmailCopyRangeEnd <DateTime>
Indique la date de fin à partir de laquelle les courriels seront migrés.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-EmailCopyRangeStart <DateTime>
Indique la date de début à partir de laquelle les courriels seront migrés.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeArchiveMailbox <SwitchParameter>
Indique de copier l'archive inaltérable.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeCalendar <SwitchParameter>
Indique de copier le calendrier de la boîte aux lettres.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeContacts <SwitchParameter>
Indique de copier les contacts de la boîte aux lettres.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeDeletedEmails <SwitchParameter>
Indique d’inclure les courriels supprimés.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeEmails <SwitchParameter>
Indique de migrer les courriels de la boîte aux lettres.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeJunkEmails <SwitchParameter>
Indique d’inclure les courriels indésirables.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l’entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l’ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeLitigationHold <SwitchParameter>
Indique de copier la conservation légale de la boîte aux lettres source vers la destination.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-IncludeMailboxRules <SwitchParameter>
Indique qu'il faut copier les règles de la boîte aux lettres.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-MaxConcurrentMailboxes <Int32>
Indique le nombre maximal de boîtes aux lettres copiées en parallèle, jusqu'à 128. Si ce paramètre n'est pas précisé, ShareGate Migrate copie 16 boîtes aux lettres en parallèle. Des valeurs plus élevées accélèrent la copie, mais consomment plus de CPU, de mémoire et de bande passante sur l'ordinateur qui effectue la migration.
Obligatoire ? | Faux |
Valeur par défaut | 16 |
Accepte l'entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-ReplaceDestinationHolds <SwitchParameter>
Indique qu'il faut remplacer tous les blocages existants sur la boîte aux lettres de destination par ceux du source.
Obligatoire ? | Faux |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Faux |
Accepte les caractères génériques ? | Faux |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
"Cet article a été traduit à l'aide de l'intelligence artificielle. En cas de doute, veuillez vous référer à la version originale en anglais."