Export-Message
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2007-06-28
ハブ トランスポート サーバーの役割またはエッジ トランスポート サーバーの役割がインストールされているコンピュータ上のキューから Microsoft Exchange Server 2007 組織内の指定したファイル パスにメッセージをコピーするには、Export-Message コマンドレットを使用します。
構文
Export-Message -Identity <MessageIdentity> -Path <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
解説
Export-Message コマンドレットは、ハブ トランスポート サーバーまたはエッジ トランスポート サーバー上の配信キュー、到達不能キュー、または有害なメッセージ キューから、指定されたファイル パスにメッセージをコピーします。メッセージをエクスポートする前に、まずメッセージを中断する必要があります。有害なメッセージ キュー内のメッセージは、既に中断されています。Export-Message コマンドを使用すると、配信用の別のトランスポート サーバーの再生ディレクトリにメッセージをコピーできます。リモート サーバーにあるメッセージをコピーするには、メッセージ ID の一部としてサーバー名を含めます。この ID は必須であり、ID によってキュー内のメッセージを一意に識別する必要があります。
Export-Message コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange サーバー管理者の役割および対象サーバーのローカルの Administrators グループ
エッジ トランスポート サーバーの役割がインストールされているコンピュータで Export-Message コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。
Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 |
|---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
MessageIdentity 整数を指定するには、Identity パラメータを使用します。これは、特定のメッセージと省略可能なサーバーおよびキュー ID を表す整数です。このパラメータの構文は以下のとおりです。
|
Path |
必須 |
System.String |
メッセージのエクスポート先となるファイルのパスを指定するには、Path パラメータを使用します。Path パラメータの値には、ファイル名、ディレクトリとファイル名、またはディレクトリのみを指定します。メッセージをエクスポートする前に、エクスポート先のディレクトリが存在している必要があります。このディレクトリは、自動的には作成されません。絶対パスが指定されていない場合は、現在の Exchange 管理シェルの作業ディレクトリが使用されます。Path パラメータで使用するディレクトリには、Exchange 2007 コンピュータのローカル ディレクトリか、またはリモート サーバー上の共有ディレクトリへの汎用名前付け規則 (UNC) パスを指定できます。Path パラメータの値として、ファイル名を含まない既存のディレクトリを指定すると、メッセージ ファイルの名前は自動的に InternalMessageID.eml に設定されます。InternalMessageID は、現在このメッセージを処理している Exchange 2007 サーバーによって割り当てられたメッセージ ID です。アカウントには、エクスポート先ディレクトリへの書き込みのアクセス許可が必要です。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するためには、コマンドの処理内容を確認する必要があります。Confirm パラメータに値を指定する必要はありません。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータに値を指定する必要はありません。 |
入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
|
例外
| 例外 | 説明 |
|---|---|
|
|
例
次の例は、キューからファイルにメッセージをエクスポートする方法を示しています。最初の例は、指定したファイル パスに 1 つのメッセージをエクスポートする方法を示しています。
2 番目の例は、Get-Message コマンドを使用して、指定したキューからすべてのメッセージを取得する方法を示しています。次に、クエリの結果が Export-Message コマンドにパイプ処理され、InternalMessageID に基づく名前を持つ .eml ファイルにすべてのメッセージがコピーされます。
Exchange 管理シェルを使用してキュー ビューアのタスクを実行する方法の詳細については、「Exchange 管理シェルを使用したキューの管理」を参照してください。
Export-Message -Identity ExchSrv1\contoso.com\1234 -Path "c:\exportfolder\filename.eml"
Get-Message -Queue "Server1\contoso.com" | Export-Message -Path "c:\exportfolder"
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。