注意: PowerShell 連携を利用するには、ShareGate Migrate の Pro または Enterprise サブスクリプションが必要です。Essentials プランではご利用いただけません。
コマンド
New-MailboxCopyOptions
説明
このコマンドは、メールボックスのコピー操作で使用するコピーオプションを作成します。
メールボックスのコピーオプションについて詳しくは、Copy mailboxes - コピーオプションをご覧ください。
例
過去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
訴訟ホールドをコピーし、既存の移行先ホールドを置き換える
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 |
パラメーターセット名 | (すべて) |
エイリアス | None |
-CopyIntoFolderName <String>
-CopyToFolder が設定されている場合に、移行先サブフォルダーの名前を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | (すべて) |
エイリアス | None |
-CopyPastEvents <SwitchParameter>
過去のカレンダーイベントをコピーすることを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | (すべて) |
エイリアス | None |
-CopyToFolder <SwitchParameter>
メールボックスの内容を受信トレイのルートではなく、移行先サブフォルダーにコピーすることを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | (すべて) |
エイリアス | None |
-CreateNewMeetingLinks <SwitchParameter>
カレンダーイベント内の Teams リンクを置き換えることを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | (すべて) |
エイリアス | 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>
ソースのメールボックスの訴訟ホールドを移行先にコピーすることを指定します。
必須かどうか | 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によって翻訳されています。内容に不明点がある場合は、元の英語版をご参照ください。