Passer au contenu principal

Nouvelles options de copie de boîte aux lettres

Définissez vos options de copie pour copier les boîtes aux lettres Microsoft 365 Exchange Online et Google Workspace Gmail avec PowerShell.

Remarque : L'intégration PowerShell nécessite un abonnement Pro ou Enterprise à ShareGate Migrate. Elle n'est pas disponible avec le forfait Essentials.

Commande

New-MailboxCopyOptions

Description

Cette commande crée 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 courriels 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 activé.

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 de 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 de 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 de remplacer les liens Teams dans les événements 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

-EmailCopyRangeEnd <DateTime>

Spécifie la date de fin à partir de laquelle les courriels 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

-EmailCopyRangeStart <DateTime>

Spécifie la date de début à partir de laquelle les courriels 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

-IncludeArchiveMailbox <SwitchParameter>

Indique de copier l'archive inaltérable.

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

-IncludeCalendar <SwitchParameter>

Indique de copier le calendrier de la boîte aux lettres.

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

-IncludeContacts <SwitchParameter>

Indique de copier les contacts de la boîte aux lettres.

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

-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 de 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 non spécifié, ShareGate Migrate copie 16 boîtes aux lettres en parallèle. Des valeurs plus élevées accélèrent la migration mais utilisent plus de CPU, de mémoire et de bande passante sur l'ordinateur effectuant 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 d'écraser toute conservation existante sur la boîte aux lettres de destination avec celles de la 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."

Avez-vous trouvé la réponse à votre question ?