Restore-Mailbox

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010

このコマンドレットは Exchange Server 2010 でのみ使用可能です。

復元されたデータベースからメールボックスの内容を抽出するには、Restore-Mailbox コマンドレットを使用します。

注: Exchange Server 2010 Service Pack 1 (SP1) 以降では、Restore-Mailbox コマンドレットの代わりに New-MailboxRestoreRequest コマンドレットを使用して、復元されたデータベースからメールボックスコンテンツを抽出します。

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

構文

Restore-Mailbox
       [-Identity] <MailboxIdParameter>
       -RecoveryDatabase <DatabaseIdParameter>
       -RecoveryMailbox <StoreMailboxIdParameter>
       -TargetFolder <String>
       [-AllowDuplicates]
       [-AllContentKeywords <String[]>]
       [-AttachmentFilenames <String[]>]
       [-BadItemLimit <Int32>]
       [-Confirm]
       [-ContentKeywords <String[]>]
       [-EndDate <DateTime>]
       [-ExcludeFolders <MapiFolderPath[]>]
       [-GlobalCatalog <Fqdn>]
       [-IncludeFolders <MapiFolderPath[]>]
       [-Locale <CultureInfo>]
       [-MaxThreads <Int32>]
       [-RecipientKeywords <String[]>]
       [-SenderKeywords <String[]>]
       [-StartDate <DateTime>]
       [-SubjectKeywords <String[]>]
       [-ValidateOnly]
       [-WhatIf]
       [<CommonParameters>]

説明

Restore-Mailbox コマンドレットは、Microsoft Exchange Server 2010 を実行している任意のサーバーから、メールボックスをサポートするための十分な領域とリソースを持つ同じ組織内の Exchange 2010 メールボックスサーバー上のメールボックスにエンドユーザーデータをコピーします。 Restore-Mailbox コマンドレットでは、サーバー上の切断されたメールボックスのみをデータソースとして使用でき、コマンドレットは接続されたメールボックスをデータのターゲットとしてのみ使用できます。

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

例

例 1

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase

次の使用例は、データベース MyRecoveryDatabase からユーザー Scott のメールボックスを復元します。

例 2

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery

次の使用例は、John のメールボックスコンテンツを Recovery フォルダーの下にある Scott のメールボックスに復元します。

例 3

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar

次の使用例は、件名が会議で、メッセージ本文にビジネスという単語が含まれており、メッセージの場所が [受信トレイ] フォルダーまたは [予定表] フォルダーにあるメールのみを復元します。この例では、メールボックスが英語であることを前提としています。

例 4

Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase

次の使用例は、MyRecoveryDatabase にも存在する MyDatabase メールボックスデータベース内のすべてのメールボックスを一括復元します。

パラメーター

-AllContentKeywords

AllContentKeywords パラメーターは、次のすべてのフィルターを指定します。

件名
メッセージ本文
添付ファイルの内容

これにより、これらすべてのフィールドの OR 検索が可能になります。検索条件が件名、メッセージ本文、または添付ファイルのコンテンツの一部である場合は、結果を取得します。

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

-AllowDuplicates

AllowDuplicates スイッチは、メールアイテムが既存のアイテムの重複かどうかを確認せず、重複するアイテムを削除せずに、メールアイテムをコピーします。このスイッチで値を指定する必要はありません。

このスイッチは、IncludeFolders パラメーターと共に使用することをお勧めします。

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

-AttachmentFilenames

AttachmentFilenames パラメーターは、添付ファイル名のフィルターを指定します。文字列にはワイルドカード文字を使用できます。たとえば、*.txtを使用して、.txt拡張機能を持つアイテムをエクスポートできます。

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

-BadItemLimit

BadItemLimit パラメーターは、エクスポート操作が失敗する前にスキップするメールボックス内の破損したアイテムの数を指定します。

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

-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

-ContentKeywords

ContentKeywords パラメーターは、メッセージ本文のキーワードフィルターと、ソースメールボックス内の添付ファイルの内容を指定します。

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

-EndDate

EndDate パラメーターは、ソースメールボックスからエクスポートされるコンテンツをフィルター処理するための終了日を指定します。終了日より前の日付のメールボックス内のアイテムのみがエクスポートされます。特定の日付を入力するときは、ローカルコンピューターで構成されている [地域オプション] 設定で定義されている短い日付形式を使用します。たとえば、コンピューターが短い日付形式 mm/dd/yyyy を使用するように構成されている場合は、「2010 年 3 月 1 日」と入力して、2010 年 3 月 1 日を指定します。

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

-ExcludeFolders

ExcludeFolders パラメーターは、エクスポート処理中に除外するフォルダーの一覧を指定します。フォルダーは、入力時に除外されます。ローカライズされていません。たとえば、他の言語の予定表は別の単語であるため、予定表を除外すると、英語の予定表のみが除外されます。

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

-GlobalCatalog

GlobalCatalog パラメーターは、ターゲットメールボックスの検索に使用するグローバルカタログを指定します。

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

-Identity

Identity パラメーターは、復元するメールボックスを指定します。メールボックスを一意に識別する任意の値を使用できます。次に例を示します。

名前
Alias
識別名 (DN)
正規 DN
Domain\Username
電子メールアドレス
GUID
LegacyExchangeDN
SamAccountName
ユーザー ID またはユーザープリンシパル名 (UPN)

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IncludeFolders

IncludeFolders パラメーターは、エクスポート処理中に含めるフォルダーの一覧を指定します。フォルダーは、入力時に含まれます。ローカライズされていません。たとえば、予定表を含めると、英語の予定表のみが含まれます。他の言語の予定表は別の単語であるためです。

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

-Locale

Locale パラメーターは、復元するメッセージのロケール設定を指定します。このフィルターを設定すると、指定したロケール設定のメッセージのみが抽出されます。

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

-MaxThreads

MaxThreads パラメーターは、使用するスレッドの最大数を指定します。

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

-RecipientKeywords

RecipientKeywords パラメーターは、ソースメールボックス内のアイテムの受信者のキーワードフィルターを指定します。このフィルターは、単語の一部であっても検索文字列を検索します。これは単語全体の検索ではありません。

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

-RecoveryDatabase

RecoveryDatabase パラメーターは、メールボックスを復元する復旧データベースを指定します。データベースを一意に識別する、任意の値を使用できます。以下に例を示します。

名前
識別名 (DN)
GUID

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

-RecoveryMailbox

RecoveryMailbox パラメーターは、ソースメールボックスとして使用するメールボックスを指定します。ソースメールボックスがターゲットメールボックスと異なる場合は、このパラメーターが必要です。

メールボックスは GUID 値で識別します。 Get-Mailbox コマンドレットまたは Get-MailboxStatistics コマンドレットを使用して、GUID 値を検索できます

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

-SenderKeywords

SenderKeywords パラメーターは、ソースメールボックス内のアイテムの送信者のキーワードフィルターを指定します。このフィルターは、単語の一部であっても検索文字列を検索します。これは単語全体の検索ではありません。

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

-StartDate

StartDate パラメーターは、開始日を指定します。開始日は終了日より前にする必要があります。

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

-SubjectKeywords

SubjectKeywords パラメーターは、ソースメールボックス内のアイテムの件名のキーワードフィルターを指定します。このフィルターは、単語の一部であっても検索文字列を検索します。これは単語全体の検索ではありません。

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

-TargetFolder

TargetFolder パラメーターは、指定されたメールボックスに作成されるメールボックスフォルダーを指定します。復元するメールボックスがターゲットメールボックスと異なる場合は、このパラメーターが必要です。 (たとえば、Identity パラメーターで指定された値は、RecoveryMailbox パラメーターで指定された値と同じではありません)。この場合、Restore-Mailbox コマンドはマージを実行します。値が同じ場合、TargetFolder パラメーターは必要ありません。

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

-ValidateOnly

ValidateOnly スイッチは、操作を実行するために必要な条件と要件を評価し、操作が成功するか失敗するかを報告するようにコマンドに指示します。このスイッチで値を指定する必要はありません。

このスイッチを使用しても変更は行われません。

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

-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

入力

Input types

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

出力

Output types

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