New-MailboxRestoreRequest

モジュール:

ExchangePowerShell

適用対象:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

New-MailboxRestoreRequest コマンドレットを使用して、回復可能な削除によって削除されたメールボックスまたは未接続のメールボックスを復元します。 このコマンドレットは、回復可能な削除によって削除されたメールボックス、無効化されたメールボックス、または回復用データベース内の任意のメールボックスのコンテンツを、接続されているプライマリ メールボックスまたはアーカイブ メールボックスへ移動する処理を開始します。

切断されたメールボックスの検索とメールボックスの復元に使用されるプロパティは、Exchange ServerとExchange Onlineで異なります。 Exchange Onlineの詳細については、「非アクティブなメールボックスを復元する」を参照してください。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-MRSServer <Fqdn>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceEndpoint <MigrationEndpointIdParameter>
   -SourceExchangeGuid <Guid>
   -SourceTenant <SmtpDomain>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-CrossTenantRestore]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -RemoteDatabaseGuid <Guid>
   -RemoteHostName <Fqdn>
   -RemoteRestoreType <RemoteRestoreType>
   -RemoteCredential <PSCredential>
   -SourceMailbox <MailboxLocationIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceIsArchive]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

説明

メールボックスをあるデータベースから別のデータベースに移動した場合、Exchange は移動の完了直後にソース データベースからメールボックスを完全に削除しません。 代わりに、ソース メールボックス データベース内のメールボックスが論理的に削除された状態に切り替えられます。これにより、新しい MailboxRestoreRequest コマンドレット セットを使用して、メールボックスの復元操作中にメールボックス データにアクセスできます。 論理的に削除されたメールボックスは、削除されたメールボックスの保持期間が期限切れになるか、Remove-StoreMailbox コマンドレットを使用してメールボックスを消去するまで、ソース データベースに保持されます。

回復可能な削除によって削除されたメールボックスを表示するには、データベースに対して Get-MailboxStatistics コマンドレットを実行し、DisconnectReason が SoftDeleted という値になることを確認します。 詳細については、後の「例 1」を参照してください。

Disable-Mailbox コマンドまたは Remove-Mailbox コマンドが完了してしばらくすると、メールボックスは無効としてマークされます。

Microsoft Exchange Information Store サービスが無効なメールボックスの情報で Active Directory が更新されたと判断するまで、メールボックスは無効としてマークされません。 データベースに対して Update-StoreMailboxState コマンドレットを実行すると、処理効率を高めることができます。

Exchange は、そのメールボックス データベース用に構成された削除されたメールボックス保持設定に基づいて、メールボックス データベース内の無効なメールボックスを保持します。 指定した期間が経過すると、メールボックスは完全に削除されます。

無効化されたメールボックスを表示するには、データベースに対して Get-MailboxStatistics コマンドレットを実行し、DisconnectReason が Disabled という値になることを確認します。 詳細については、このトピックの「例 2 と 3」を参照してください。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

注: プライマリ メールボックスの内容をアーカイブ メールボックスに復元するには、TargetRootFolder パラメーターを使用して、コンテンツを移行するアーカイブ メールボックス フォルダーを指定します。 このコンテンツは、復元後に表示されます。 このパラメーターを使用しない場合、復元されたコンテンツは、ユーザーに表示されないアーカイブ メールボックス内の場所にマップされるため、表示されません。

例

例 1

Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox Ayla

オンプレミス Exchange では、この例では、Get-MailboxStatistics コマンドレットを使用して、SoftDeleted または Disabled の切断理由がある MBD01 という名前のメールボックス データベース内のすべてのメールボックスの DisplayName、LegacyExchangeDN、MailboxGUID (有効なソース メールボックス ID 値) を返します。

この情報を使用して、MailboxGUID 値が 1d20855f-fd54-4681-98e6-e249f7326dd のソース メールボックスが、エイリアス値 Ayla を持つターゲット メールボックスに復元されます。

例 2

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchive

オンプレミス Exchange では、この例では、メールボックス データベース MBD01 の Tony Smith の DisplayName を含むソース メールボックスのコンテンツを の Tony@contoso.comアーカイブ メールボックスに復元します。

パラメーター

-AcceptLargeDataLoss

AcceptLargeDataLoss スイッチは、ソース メールボックス内に多数のアイテムがあり、対象のメールボックスにコピーできない場合でも要求を続行するように指定します。 このスイッチに値を指定する必要はありません。

Exchange 2013 以降または Exchange Online では、LargeItemLimit パラメーターの値を 51 以上に設定する場合、このスイッチを使用する必要があります。 使用しない場合、コマンドは失敗します。

Exchange 2010 では、BadItemLimit パラメーターの値を 51 以上に設定する場合、このスイッチを使用する必要があります。 使用しない場合、コマンドは失敗します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AllowLegacyDNMismatch

AllowLegacyDNMismatch スイッチは、ソース物理メールボックスの LegacyExchangeDN とターゲット メールボックスが一致しない場合に操作を続行することを指定します。 このスイッチで値を指定する必要はありません。

既定では、このコマンドレットは、復元元の物理的なメールボックスの LegacyExchangeDN が、復元先のユーザーに LegacyExchangeDN の形式または LegacyExchangeDN に対応する X500 プロキシ アドレスの形式で存在することを確認します。 この確認によって、復元元メールボックスが誤って正しくない復元先メールボックスへ復元することを防ぎます。

注: このパラメーターは、クラウドベースのサービスでは廃止される予定です。 一致しない LegacyExchangeDN を持つメールボックスのメールボックス復元要求を完了するには、ソース メールボックスの LegacyExchangeDN 値を取得し、それを X500 プロキシ アドレスとしてターゲット メールボックスに追加する必要があります。 詳細な手順については、「 非アクティブなメールボックスを復元する」を参照してください。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AssociatedMessagesCopyOption

AssociatedMessagesCopyOption パラメーターは、要求を処理する際に関連付けられたメッセージをコピーするかどうかを指定します。 関連付けられたメッセージとは、ルール、ビュー、およびフォームに関する情報を持つ非表示のデータが含まれる、特別なメッセージです。 有効な値は次のとおりです。

• DoNotCopy: 関連付けられているメッセージはコピーされません。
• MapByMessageClass: ソース メッセージの MessageClass 属性を検索して、関連付けられているメッセージを検索します。 ソース フォルダーとターゲット フォルダーの両方にこのクラスの関連付けられたメッセージがある場合は、ターゲット内の関連付けられたメッセージが上書きされます。 ターゲットに関連付けられているメッセージがない場合は、ターゲットにコピーが作成されます。
• コピー: 関連するメッセージをソースからターゲットにコピーします。 ソースとターゲットの両方の場所に同じメッセージの種類が存在する場合、これらの関連するメッセージが重複します。 これは既定の値です。

Copy: このオプションでは、関連付けられたメッセージをソースからターゲットにコピーします。ソースとターゲットの両方の場所に同じメッセージの種類が存在する場合は、これらの関連付けられたメッセージが複製されます。これは既定のオプションです。

Type:	FAICopyOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-BadItemLimit

BadItemLimit パラメーターは、要求が失敗するまで許可される無効なアイテムの最大数を指定します。 無効なアイテムとは、移動先メールボックスにコピーできない、移動元メールボックスにある破損したアイテムのことです。 無効なアイテムの制限の対象には、見つからないアイテムも含まれます。 見つからないアイテムとは、移行元メールボックスのアイテムのうち、要求の完了間際になっても、移行先のメールボックスに見あたらないアイテムのことです。

このパラメーターの有効な入力値は、整数または値 unlimited です。 既定値は 0 です。つまり、無効なアイテムが 1 つでも検出されると要求は失敗します。 無効なアイテムが多少含まれても構わない場合は、要求を続行できるように、このパラメーターを妥当な値 (10 以下をお勧めします) に設定します。 検出された無効なアイテムが多すぎる場合は、New-MailboxRepairRequest コマンドレットを使用して移行元メールボックス内の破損したアイテムの修復を試み、要求を再試行してください。

Exchange 2010 では、この値を 51 以上に設定する場合は、AcceptLargeDataLoss スイッチも使用する必要があります。 使用しない場合、コマンドは失敗します。

注: このパラメーターは、クラウドベースのサービスでは廃止される予定です。 このパラメーターを使用しない場合、今後は代わりとして、スキップされたアイテム承認セマンティクスが使用されます。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-BatchName

BatchName パラメーターは、メールボックスのバッチ復元のわかりやすい名前を指定します。 BatchName パラメーターの名前は、Get-MailboxRestoreRequest コマンドレットを使用する際に検索文字列として使用できます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CompletedRequestAgeLimit

CompletedRequestAgeLimit パラメーターは、完了した復元要求の状態を Completed に設定する時間を指定します。 このパラメーターの値を 0 に設定した場合、状態は Completed に変更される代わりにすぐにクリアされます。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

• 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
• 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConflictResolutionOption

ConflictResolutionOption パラメーターは、ターゲットに一致するメッセージが複数ある場合の処理を指定します。 有効な値は次のとおりです。

• ForceCopy
• KeepAll
• KeepLatestItem
• KeepLatestItem
• KeepTargetItem
• UpdateFromSource

Type:	ConflictResolutionOption
Position:	Named
Default value:	KeepSourceItem
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ContentFilter

このパラメーターは、クラウドベースのサービスでのみ使用できます。

ContentFilter パラメーターは、OPATH フィルター構文を使用して、指定したプロパティと値で結果をフィルター処理します。 ContentFilter パラメーターに一致するコンテンツのみが復元されます。 検索条件は構文"Property -ComparisonOperator 'Value'"を使用します。

• OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、$true、$false、または $null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。
• Property はフィルタリング可能なプロパティです。 フィルター可能なプロパティについては、「 ContentFilter パラメーターのフィルター可能なプロパティ」を参照してください。
• ComparisonOperator は OPATH 比較演算子です (たとえば -eq 、等しい場合や -like 文字列比較の場合)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。
• Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 ('Value'または'$Variable') で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。 整数またはシステム値を引用符で囲まないでください (代わりに、 500、 $true、 $falseなど $null )。

論理演算子 -and および -or を使用すると、複数の検索条件を連結することができます。 たとえば、"Criteria1 -and Criteria2" または "(Criteria1 -and Criteria2) -or Criteria3" です。

Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ContentFilterLanguage

このパラメーターは、クラウドベースのサービスでのみ使用できます。

ContentFilterLanguage パラメーターは、ContentFilter パラメーターで文字列検索に使用する言語を指定します。

このパラメーターの正しい入力は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です。 たとえば、デンマーク語の場合には da-DK、日本語の場合には ja-JP となります。 詳細については、「CultureInfo クラス」を参照してください。

Type:	CultureInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-CrossTenantRestore

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DomainController

このパラメーターは、オンプレミスの Exchange でのみ使用可能で正常に機能します。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExcludeDumpster

ExcludeDumpster スイッチは、回復可能なアイテム フォルダーを除外するかどうかを指定します。 このスイッチで値を指定する必要はありません。

このスイッチを使用しない場合、回復可能なアイテム フォルダーは次のサブフォルダーと共にコピーされます。

• Deletions
• バージョン
• Purges

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExcludeFolders

ExcludeFolders パラメーターは、復元要求中に除外するフォルダーの一覧を指定します。

社外メールボックスへのシングル サインオンを許可するように exADNoMk フェデレーション サービス (AD FS) を展開しており、サインオンのトークン要求に ExchangeGUID 以外の別の属性を使用するように AD FS を構成している場合、ImmutableId パラメーターを設定する必要があります。 社内外にまたがる exExchangeNoVersion 展開シナリオで適切な機能を確保するには、exExchangeNoVersion と AD FS の両方で同じユーザーに対して同じトークンを要求する必要があります。

<FolderName>/*: SourceRootFolder パラメーターで指定されたフォルダーの下にある個人用フォルダーを示すには、次の構文を使用します ("MyProjects" や "MyProjects/FY2010" など)。

#<FolderName>#/*: 別の言語でフォルダーの名前に関係なく、既知のフォルダーを示すには、この構文を使用します。 たとえば、#Inbox# は、受信トレイがトルコ語 (Gelen Kutusu) にローカライズされている場合でも、受信トレイ フォルダーを表します。 既知のフォルダーには、次の種類があります。

• 受信トレイ
• SentItems
• DeletedItems
• 予定表
• 連絡先
• 下書き
• ジャーナル
• タスク
• 備考
• JunkEmail
• CommunicatorHistory
• ボイスメール
• FAX
• 競合
• SyncIssues
• LocalFailures
• ServerFailures

ユーザーが既知のフォルダーと同じ名前の個人用フォルダーを作成し、それを囲む # 記号を使用する場合は、エスケープ文字として円記号 (\) を使用してそのフォルダーを指定できます。 たとえば、ユーザーが #Notes# という名前のフォルダーを作成し、既知の Notes フォルダーではなくそのフォルダーを指定する場合は、次の構文を使用します \#Notes\#。

個人用フォルダーの作成時に既知のフォルダー名を # 記号で囲んだものがフォルダー名として設定されている場合は、円記号 (\) をエスケープ文字として使用することで作成したフォルダーを指定できます。たとえば、#メモ# という名前のフォルダーが作成されている場合に、既知のメモ フォルダーではなく作成したフォルダーを指定したい場合は、以下の構文を使用します。\#Notes\#.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeFolders

IncludeFolders パラメーターは、復元要求中に含めるフォルダーの一覧を指定します。

社外メールボックスへのシングル サインオンを許可するように exADNoMk フェデレーション サービス (AD FS) を展開しており、サインオンのトークン要求に ExchangeGUID 以外の別の属性を使用するように AD FS を構成している場合、ImmutableId パラメーターを設定する必要があります。 社内外にまたがる exExchangeNoVersion 展開シナリオで適切な機能を確保するには、exExchangeNoVersion と AD FS の両方で同じユーザーに対して同じトークンを要求する必要があります。

<FolderName>/*: SourceRootFolder パラメーターで指定されたフォルダーの下にある個人用フォルダーを示すには、次の構文を使用します ("MyProjects" や "MyProjects/FY2010" など)。

#<FolderName>#/*: 別の言語でフォルダーの名前に関係なく、既知のフォルダーを示すには、この構文を使用します。 たとえば、#Inbox# は、受信トレイがトルコ語 (Gelen Kutusu) にローカライズされている場合でも、受信トレイ フォルダーを表します。 既知のフォルダーには、次の種類があります。

• 受信トレイ
• SentItems
• DeletedItems
• 予定表
• 連絡先
• 下書き
• ジャーナル
• タスク
• 備考
• JunkEmail
• CommunicationHistory
• ボイスメール
• FAX
• 競合
• SyncIssues
• LocalFailures
• ServerFailures

ユーザーが既知のフォルダーと同じ名前の個人用フォルダーを作成し、それを囲む # 記号を使用する場合は、エスケープ文字として円記号 (\) を使用してそのフォルダーを指定できます。 たとえば、ユーザーが #Notes# という名前のフォルダーを作成し、既知の Notes フォルダーではなくそのフォルダーを指定する場合は、次の構文を使用します \#Notes\#。

個人用フォルダーの作成時に既知のフォルダー名を # 記号で囲んだものがフォルダー名として設定されている場合は、円記号 (\) をエスケープ文字として使用することで作成したフォルダーを指定できます。たとえば、#メモ# という名前のフォルダーが作成されている場合に、既知のメモ フォルダーではなく作成したフォルダーを指定したい場合は、以下の構文を使用します。\#Notes\#.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-InternalFlags

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

InternalFlags パラメーターは、省略可能な手順を要求で指定します。 このパラメーターは、主にデバッグ目的に使用されます。

Type:	InternalMrsFlag[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LargeItemLimit

LargeItemLimit パラメーターは、要求が失敗するまで許可される大きなアイテムの最大数を指定します。 大きなアイテムとは、移行先メールボックスで許可される最大メッセージ サイズを超える移行元メールボックス内のメッセージのことです。 移行先メールボックスに具体的に構成された最大メッセージ サイズ値が設定されていない場合、組織全体用の値が使用されます。

最大メッセージ サイズ値の詳細については、次のトピックを参照してください。

• Exchange 2016: Exchange Serverのメッセージ サイズの制限
• Exchange Online: Exchange Online の制限

このパラメーターの有効な入力値は、整数または値 unlimited です。 既定値は 0 です。つまり、大きなアイテムが 1 つでも検出されると要求は失敗します。 大きなアイテムが多少含まれても構わない場合は、要求を続行できるように、このパラメーターを妥当な値 (10 以下をお勧めします) に設定します。

この値を 51 以上に設定する場合は、AcceptLargeDataLoss スイッチも使用する必要があります。 使用しない場合、コマンドは失敗します。

注: このパラメーターは、クラウドベースのサービスでは廃止される予定です。 このパラメーターを使用しない場合、今後は代わりとして、スキップされたアイテム承認セマンティクスが使用されます。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MRSServer

このパラメーターは Exchange Server 2010 でのみ使用できます。

MRSServer パラメーターは、Microsoft Exchange Mailbox Replication サービス (MRS) のインスタンスを実行しているクライアント アクセス サーバーの FQDN を指定します。 このパラメーターは、デバッグ目的にのみ使用されます。 このパラメーターは、サポート担当者によって指示された場合にのみ使用します。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

Name パラメーターは、特定の要求を追跡および表示するための名前を指定します。 メールボックスごとに複数の復元要求を使用できるため、Exchange は名前の前にメールボックスのエイリアスを付けます。 たとえば、エイリアスが Kweku であるユーザー メールボックスに対するエクスポート要求を作成して、このパラメーターの値を RestoreFailedMoves に指定した場合、このエクスポート要求の ID は Kweku\RestoreFailedMoves になります。

復元要求の作成時に名前を指定しなかった場合、Exchange は既定の名前 MailboxRestore を自動的に生成します。 Exchange では、MailboxRestore から始まり、MailboxRestoreX (X = 1- 9) から最大 10 個の名前が生成されます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Priority

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

Priority パラメーターは、この要求を要求キューで処理する順序を指定します。 要求は、サーバーの正常性、状態、優先度、および最終更新時刻に基づいて順番に処理されます。 有効な Priority 値は次のとおりです。

• Lowest
• Lower
• Low
• 標準 (既定値です)。
• High
• Higher
• Highest
• Emergency

Type:	RequestPriority
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RemoteCredential

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteDatabaseGuid

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteHostName

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteRestoreType

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	RemoteRestoreType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RequestExpiryInterval

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

RequestExpiryInterval パラメーターは、完了または失敗した要求の保存期間を指定します。 このパラメーターを使用する場合、指定した期間が経過した後、完了または失敗した要求は自動的に削除されます。 このパラメーターを使用しない場合は、次のことが起こります。

• 完了した要求は CompletedRequestAgeLimit パラメーターの値に基づいて自動的に削除されます。
• 要求が失敗した場合は、対応する Remove-*Request コマンドレットを使用して手動で削除する必要があります。

値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。

値 Unlimited を使用した場合、完了した要求は自動的に削除されません。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-SkipMerging

SkipMerging パラメーターは、メールボックスの復元時にスキップするフォルダー関連のアイテムを指定します。 次のいずれかの値を使用します。

• FolderACLs
• FolderProperties
• FolderRules
• InitialConnectionValidation

このパラメーターは、フォルダー ルール、フォルダー アクセス制御リスト (ACL)、または最初の接続検証が原因で復元要求に失敗した場合にのみ使用します。

Type:	SkippableMergeComponent[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceDatabase

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

SourceDatabase パラメーターは、削除済み (回復可能) メールボックスまたは未接続のメールボックスの復元元のデータベースの ID を指定します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• GUID

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceEndpoint

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	MigrationEndpointIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourceExchangeGuid

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourceIsArchive

SourceIsArchive スイッチは、復元元メールボックスがアーカイブ メールボックスであることを指定します。 このスイッチで値を指定する必要はありません。

このスイッチは SourceMailbox パラメーターと一緒に指定する場合にのみ使用可能です。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceMailbox

SourceMailbox パラメーターは、復元する論理的に削除されたメールボックスを指定します。 論理的に削除されたメールボックスを識別する最善の方法は、その GUID 値です。 GUID 値は、Get-Mailbox -SoftDeletedMailbox コマンドを実行することで確認できます。

Type:	SourceMailbox
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceRootFolder

SourceRootFolder パラメーターは、データの復元元のメールボックスのルート フォルダーを指定します。 このパラメーターを指定しない場合、すべてのフォルダーが復元されます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceStoreMailbox

このパラメーターは、オンプレミスの Exchange でのみ使用可能で正常に機能します。

SourceStoreMailbox パラメーターは、コンテンツを復元するソース メールボックスの MailboxGUID を指定します。

MailboxGUID を見つけるには、Get-MailboxStatistics コマンドレットを実行します。

Type:	StoreMailboxIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceTenant

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	SmtpDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Suspend

Suspend スイッチは、要求を中断するかどうかを指定します。 このスイッチで値を指定する必要はありません。

このスイッチを使用すると要求がキューに入りますが、関連する再開コマンドレットを使用して要求を再開しないと InProgress の状態にはなりません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SuspendComment

SuspendComment パラメーターは、要求が中断された理由の説明を指定します。 このパラメーターは、Suspend パラメーターを指定する場合にのみ使用できます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetIsArchive

TargetIsArchive スイッチは、コンテンツが指定されたターゲット メールボックスのアーカイブに復元されることを指定します。 このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetMailbox

TargetMailbox パラメーターは、コンテンツを復元するターゲット メールボックスまたはメール ユーザーの GUID を指定します。 このコマンドを正常に実行するには、復元先のメールボックスまたはメール ユーザーがあらかじめ存在している必要があります。

メールボックスまたはメール ユーザーの GUID 値は、Get-Mailbox または Get-MailUser コマンドレットを実行することで確認できます。

Exchange 2016 以降およびExchange Onlineでは、このパラメーターは MailboxLocationIdParameter 型です。

Exchange 2013 以前では、このパラメーターは MailboxOrMailUserIdParameter 型です。

Type:	MailboxLocationIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetRootFolder

TargetRootFolder パラメーターは、データを復元する最上位のフォルダーを指定します。 このパラメーターを指定しない場合、復元先のメールボックスまたはアーカイブのフォルダー構造の最上位に、フォルダーが復元されます。 コンテンツは既存のフォルダーの下で結合され、フォルダーが復元先のフォルダー構造内に存在していない場合は新しいフォルダーが作成されます。

注: プライマリ メールボックスの内容をアーカイブ メールボックスに復元するには、このパラメーターを使用して、コンテンツを移行するアーカイブ メールボックス フォルダーを指定します。 このコンテンツは、復元後に表示されます。 このパラメーターを使用しない場合、復元されたコンテンツは、ユーザーに表示されないアーカイブ メールボックス内の場所にマップされるため、表示されません。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetType

TargetType パラメーターは、復元操作の対象となるメールボックスの種類を指定します。 有効な値は次のとおりです。

• アーカイブ
• MailboxLocation
• プライマリ (既定値です)

Type:	TargetTypeComponent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WorkloadType

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	RequestWorkloadType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。