Hinweis: Für die PowerShell-Integration ist ein ShareGate Migrate Pro- oder Enterprise-Abonnement erforderlich. Sie ist im Essentials-Plan nicht verfügbar.

Befehl

New-MailboxCopyOptions

Beschreibung

Dieser Befehl erstellt Kopieroptionen für die Verwendung in einem Postfachkopiervorgang.

Weitere Informationen zu Ihren Postfachkopieroptionen finden Sie unter Copy mailboxes - Copy options.

Beispiele

Nur E-Mails der letzten 90 Tage kopieren

$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

Mit maximaler Postfachparallelität kopieren

$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

E-Mails vom Anbeginn der Zeit bis heute kopieren

$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

E-Mails aus einem Datumsbereich kopieren und Kalenderereignisse mit neuen Links einschließen

$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

E-Mails vom Anbeginn der Zeit bis heute kopieren und Postfachregeln einschließen

New-MailboxCopyOptions -IncludeEmails -IncludeMailboxRules

Nur Kontakte kopieren

New-MailboxCopyOptions -IncludeContacts

Nur Kalender mit allen Ereignissen kopieren

New-MailboxCopyOptions -IncludeCalendar -CopyPastEvents

Nur Kalender mit Ereignissen ab einem bestimmten vergangenen Datum kopieren

New-MailboxCopyOptions -IncludeCalendar -CopyPastEvents -CalendarCopyStartDate "2025-02-10"

Kalenderereignisse ab heute mit neuen Besprechungslinks, Postfachregeln, Kontakten und E-Mails der letzten 180 Tage kopieren

$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -IncludeContacts -IncludeMailboxRules

Alle Kalenderereignisse mit neuen Besprechungslinks, Postfachregeln, Kontakten und E-Mails der letzten 180 Tage kopieren

$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -CopyPastEvents -IncludeContacts -IncludeMailboxRules

Kalenderereignisse ab einem bestimmten vergangenen Datum mit neuen Besprechungslinks, Postfachregeln, Kontakten und E-Mails der letzten 180 Tage kopieren

$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -CopyPastEvents -CalendarCopyStartDate "2025-01-01" -IncludeContacts -IncludeMailboxRules

E-Mails vom Anbeginn der Zeit bis heute kopieren, einschließlich gelöschter und Junk-E-Mails

New-MailboxCopyOptions -IncludeEmails -IncludeMailboxRules -IncludeDeletedEmails -IncludeJunkEmails

Litigation Hold kopieren und vorhandene Ziel-Holds ersetzen

New-MailboxCopyOptions -IncludeLitigationHold -ReplaceDestinationHolds

Syntax

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>]

Parameter

-CalendarCopyStartDate <DateTime>

Gibt das Startdatum an, ab dem die Kalenderereignisse migriert werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-CopyIntoFolderName <String>

Gibt den Namen des Zielunterordners an, wenn -CopyToFolder festgelegt ist.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-CopyPastEvents <SwitchParameter>

Gibt an, dass vergangene Kalenderereignisse kopiert werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-CopyToFolder <SwitchParameter>

Gibt an, dass der Postfachinhalt in einen Zielunterordner statt in den Posteingang-Stammordner kopiert wird.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-CreateNewMeetingLinks <SwitchParameter>

Gibt an, dass die Team-Links in den Kalenderereignissen ersetzt werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-EmailCopyRangeEnd <DateTime>

Gibt das Enddatum an, bis zu dem die E-Mails migriert werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-EmailCopyRangeStart <DateTime>

Gibt das Startdatum an, ab dem die E-Mails migriert werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeArchiveMailbox <SwitchParameter>

Gibt an, dass das In-Place-Archivpostfach kopiert wird.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeCalendar <SwitchParameter>

Gibt an, dass der Postfachkalender kopiert wird.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeContacts <SwitchParameter>

Gibt an, dass die Postfachkontakte kopiert werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeDeletedEmails <SwitchParameter>

Gibt an, dass die gelöschten E-Mails eingeschlossen werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeEmails <SwitchParameter>

Gibt an, dass die Postfach-E-Mails migriert werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeJunkEmails <SwitchParameter>

Gibt an, dass die Junk-E-Mails eingeschlossen werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeLitigationHold <SwitchParameter>

Gibt an, dass der Litigation Hold des Quellpostfachs an das Ziel kopiert wird.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-IncludeMailboxRules <SwitchParameter>

Gibt an, dass die Postfachregeln kopiert werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-MaxConcurrentMailboxes <Int32>

Gibt die maximale Anzahl der parallel kopierten Postfächer an, bis zu 128. Wenn nicht angegeben, kopiert ShareGate Migrate 16 Postfächer parallel. Höhere Werte sind schneller, benötigen aber mehr CPU, Arbeitsspeicher und Netzwerkressourcen auf dem Computer, auf dem die Migration ausgeführt wird.

Erforderlich?	False
Standardwert	16
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-ReplaceDestinationHolds <SwitchParameter>

Gibt an, dass vorhandene Holds im Zielpostfach durch die Holds der Quelle überschrieben werden.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

Dieser Artikel wurde mit künstlicher Intelligenz übersetzt. Bei Unklarheiten konsultieren Sie bitte die englische Originalversion.