Restore-Mailbox (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-05
回復用ストレージ グループに復元されたデータベースからメールボックスの内容を抽出するには、Restore-Mailbox コマンドレットを使用します。
構文
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
解説
Restore-Mailbox コマンドレットは、Microsoft Exchange Server 2007 を実行しているサーバー上の回復用ストレージ グループから、メールボックスをサポートするのに十分な容量およびリソースがある、同じ組織内に存在する Exchange 2007 メールボックス サーバー上のメールボックスに、エンド ユーザーのデータをコピーします。
回復用ストレージ グループを使用すると、現在のデータへのユーザー アクセスを妨げずに、データベースのバックアップ コピーからデータを回復できます。また、回復用ストレージ グループは、データが消失した場合にデータを取り出すために使用しても便利です。サーバーには、1 つの回復用ストレージ グループのみ含めることができます。
Restore-Mailbox コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- 移動元サーバーと移動先サーバーの両方の Exchange Server 管理者の役割およびローカルの Administrators グループ
アクセス許可、役割の委任、および Exchange Server 2007 の管理に必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
サーバーは、単一フォレストまたはリソース フォレストの一部です。メールボックス データは、同じフォレスト内のメールボックスにのみエクスポートできます。メールボックスに関連する Active Directory ディレクトリ サービス アカウントは外部のフォレストに存在できますが、メールボックス データを異なるフォレストのサーバーにエクスポートすることはできません。
回復先および回復元のデータベースは、Exchange 2007 サーバーのものである必要があります。
Restore-Mailbox コマンドレットは、サーバー上の回復用ストレージ グループの接続が解除されたメールボックスをデータのソースとして、接続されたメールボックスをデータの宛先として使用するだけです。
パラメータ
パラメータ | 必須 | 種類 | 説明 |
---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Identity パラメータには、回復先メールボックスの ID を指定します。このパラメータは名前または GUID です。回復元メールボックスが RSGMailbox パラメータで指定されていない場合は、回復元メールボックスは回復先メールボックスと同じ Mailbox GUID を持つものと見なされます。 |
RSGDatabase |
必須 |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
RSGDatabase パラメータには、メールボックスの復元元となる回復用ストレージ データベースを指定します。次の値を使用できます。
|
RSGMailbox |
必須 |
Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter |
RSGMailbox パラメータには、回復元メールボックスとして使用する回復用ストレージ グループ内のメールボックスを指定します。回復元メールボックスが回復先メールボックスとは異なる場合、このパラメータは必須です。 |
TargetFolder |
必須 |
System.String |
TargetFolder パラメータには、指定したメールボックスで作成されるメールボックス フォルダを指定します。 |
AllContentKeywords |
省略可能 |
System.String[] |
AllContentKeywords パラメータには、以下のすべてに適用するフィルタを指定します。
これにより、これらすべてのフィールドで Or 検索が可能になります。検索条件が件名、メッセージの本文、または添付ファイルの内容の一部である場合は、結果が返されます。 |
AttachmentFilenames |
省略可能 |
System.String[] |
AttachmentFilenames パラメータには、添付ファイルの名前に適用するフィルタを指定します。この文字列にはワイルドカード文字を使用できます。たとえば、"*.txt" と指定すると, .txt という拡張子が付いているアイテムをエクスポートできます。 |
BadItemLimit |
省略可能 |
System.Int32 |
BadItemLimit パラメータには、エクスポート操作が失敗するまでにスキップする、メールボックス内の破損アイテム数を指定します。 |
ContentKeywords |
省略可能 |
System.String[] |
ContentKeywords パラメータには、回復元メールボックス内のメッセージ本文および添付ファイルの内容に適用するキーワード フィルタを指定します。 |
EndDate |
省略可能 |
System.DateTime |
EndDate パラメータには、エクスポート元メールボックスからエクスポートされる内容に適用するフィルタの終了日を指定します。メールボックスのアイテムのうち、日付がこの終了日までのアイテムのみがエクスポートされます。特定の日付を入力する場合は、ローカル コンピュータで構成されている [地域のオプション] の設定で定義されている短い形式を使用します。たとえば、コンピュータで短い日付形式の mm/dd/yyyy を使用するように構成されている場合、2006 年 3 月 1 日を指定するには「03/01/2006」と入力します。 |
ExcludeFolders |
省略可能 |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
ExcludeFolders パラメータには、エクスポート処理中に除外するフォルダの一覧を指定します。フォルダは入力されたとおりに除外されます。それらはローカライズされません。たとえば、calendar を除外すると、他の言語では calendar は別の言葉で表現されるため、英語の calendar のみが除外されます。 |
GlobalCatalog |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
GlobalCatalog パラメータには、対象のメールボックスの検索に使用するグローバル カタログを指定します。 |
IncludeFolders |
省略可能 |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
IncludeFolders パラメータには、エクスポート処理中に含めるフォルダの一覧を指定します。フォルダは入力されたとおりに含められます。それらはローカライズされません。たとえば、calendar を含めると、他の言語では calendar は別の言葉で表現されるため、英語の calendar のみが含められます。 |
Locale |
省略可能 |
System.Globalization.CultureInfo |
Locale パラメータには、復元するメッセージのロケール設定を指定します。このフィルタを設定すると、そのロケール設定のメッセージのみが抽出されます。 |
MaxThreads |
省略可能 |
System.Int32 |
MaxThreads パラメータには、使用するスレッドの最大数を指定します。 |
ReportFile |
省略可能 |
Microsoft.Exchange.Data.LocalLongFullPath |
ReportFile パラメータには、XML レポート ログのパスとファイル名を指定します。 |
StartDate |
省略可能 |
System.DateTime |
StartDate パラメータには、開始日を指定します。開始日は終了日よりも前である必要があります。 |
SubjectKeywords |
省略可能 |
System.String[] |
SubjectKeywords パラメータには、移動元のメールボックス内のアイテムの件名をフィルタリングするためのキーワードを指定します。このフィルタでは、単語の一部が一致する場合にも、検索文字列が検出されます。これは、完全に一致する単語の検索ではありません。 |
ValidateOnly |
省略可能 |
System.Management.Automation.SwitchParameter |
ValidateOnly パラメータには、オブジェクトに対して発生するアクションをシミュレートするためのコマンドを指定します。既定値は $true です。 |
入力の種類
戻り値の種類
エラー
エラー |
説明 |
|
|
例外
例外 |
説明 |
|
|
例
次のコード例の 1 つ目の例では、ユーザー Chris のメールボックスを、回復用ストレージ グループ データベース MyRSGDatabase から復元します。2 つ目の例では、Ricardo のメールボックスの内容を、Recovery フォルダの下位にある Chris のメールボックスに復元します。3 つ目の例では、件名が "Meeting" で、本文に "business" という単語を含み、Inbox または Calendar フォルダに存在するメールのみを復元します。この例では、メールボックスが英語であることを前提としています。最後の例では、MyRSGDatabase 内にも存在する MyDatabase メールボックス データベース内のすべてのメールボックスを一括で復元します。
Restore-Mailbox -Identity chris -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -RSGMailbox Ricardo -TargetFolder Recovery
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。