注: PowerShell との連携には、ShareGate Migrate のProまたはEnterpriseサブスクリプションが必要です。Essentialsプランでは利用できません。
コマンド
New-MailboxCopyOptions
説明
このコマンドは、メールボックスのコピー操作で使用するコピーオプションを作成します。
メールボックスのコピーオプションの詳細については、Copy mailboxes - Copy optionsを参照してください。
例
過去 90 日分のメールのみをコピーする
$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
最大のメールボックス並行数でコピーする
$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
開始日時から今日までのメールをコピーする
$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
指定した期間のメールをコピーし、新しいリンクを付けたカレンダーイベントを含める
$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
開始日時から今日までのメールをコピーし、メールボックスのルールを含める
New-MailboxCopyOptions -IncludeEmails -IncludeMailboxRules
連絡先のみをコピーする
New-MailboxCopyOptions -IncludeContacts
すべてのイベントを含むカレンダーのみをコピーする
New-MailboxCopyOptions -IncludeCalendar -CopyPastEvents
指定した過去の日付以降のイベントを含むカレンダーのみをコピーする
New-MailboxCopyOptions -IncludeCalendar -CopyPastEvents -CalendarCopyStartDate "2025-02-10"
今日以降のカレンダーイベントを新しい会議リンク付きでコピーし、メールボックスのルール、連絡先、過去 180 日分のメールを含める
$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -IncludeContacts -IncludeMailboxRules
すべてのカレンダーイベントを新しい会議リンク付きでコピーし、メールボックスのルール、連絡先、過去 180 日分のメールを含める
$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -CopyPastEvents -IncludeContacts -IncludeMailboxRules
指定した過去の日付以降のカレンダーイベントを新しい会議リンク付きでコピーし、メールボックスのルール、連絡先、過去 180 日分のメールを含める
$startDate = (Get-Date).AddDays(-180)
New-MailboxCopyOptions -IncludeEmails -EmailCopyRangeStart $startDate -IncludeCalendar -CreateNewMeetingLinks -CopyPastEvents -CalendarCopyStartDate "2025-01-01" -IncludeContacts -IncludeMailboxRules
開始日時から今日までのメールを、削除済みおよび迷惑メールを含めてコピーする
New-MailboxCopyOptions -IncludeEmails -IncludeMailboxRules -IncludeDeletedEmails -IncludeJunkEmails
Litigation Hold をコピーし、既存の移行先の保留を置き換える
New-MailboxCopyOptions -IncludeLitigationHold -ReplaceDestinationHolds
構文
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>]
パラメーター
-CalendarCopyStartDate <DateTime>
カレンダーイベントの移行を開始する日付を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-CopyIntoFolderName <String>
-CopyToFolder が設定されている場合の、移行先サブフォルダーの名前を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-CopyPastEvents <SwitchParameter>
過去のカレンダーイベントをコピーするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-CopyToFolder <SwitchParameter>
メールボックスのコンテンツを受信トレイのルートではなく、移行先サブフォルダーにコピーするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-CreateNewMeetingLinks <SwitchParameter>
カレンダーイベント内の Team リンクを置き換えるよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-EmailCopyRangeEnd <DateTime>
メールの移行を終了する日付を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-EmailCopyRangeStart <DateTime>
メールの移行を開始する日付を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeArchiveMailbox <SwitchParameter>
インプレースアーカイブメールボックスをコピーするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeCalendar <SwitchParameter>
メールボックスのカレンダーをコピーするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeContacts <SwitchParameter>
メールボックスの連絡先をコピーするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeDeletedEmails <SwitchParameter>
削除済みメールを含めるよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeEmails <SwitchParameter>
メールボックスのメールを移行するよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeJunkEmails <SwitchParameter>
迷惑メールを含めるよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeLitigationHold <SwitchParameter>
移行元メールボックスの Litigation Hold を移行先にコピーするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-IncludeMailboxRules <SwitchParameter>
メールボックスのルールをコピーするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-MaxConcurrentMailboxes <Int32>
並行してコピーするメールボックスの最大数(最大 128)を指定します。指定しない場合、ShareGate Migrate は 16 個のメールボックスを並行してコピーします。値を大きくすると処理は速くなりますが、移行を実行するコンピューターの CPU、メモリ、ネットワークのリソースをより多く使用します。
必須かどうか | False |
既定値 | 16 |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-ReplaceDestinationHolds <SwitchParameter>
移行先メールボックスの既存の保留を、移行元の保留で上書きするよう指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
この記事はAIによって翻訳されています。ご不明な点がある場合は、英語の原文をご確認ください。