Get-MailboxExportRequestStatistics
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Get-MailboxExportRequestStatistics コマンドレットを使用して、エクスポート要求に関する詳細な情報を表示します。
このコマンドレットはメールボックスインポートエクスポートロールでのみ使用でき、既定ではロールはどの役割グループにも割り当てられません。 このコマンドレットを使用するには、役割グループ (組織の管理役割グループなど) にメールボックスインポートエクスポートロールを追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Identity
Get-MailboxExportRequestStatistics
[-Identity] <MailboxExportRequestIdParameter>
[-DomainController <Fqdn>]
[-IncludeReport]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DiagnosticInfo <String>]
[-ReportOnly]
[<CommonParameters>]
MRSInstance
Get-MailboxExportRequestStatistics
-MRSInstance <Fqdn>
[-DomainController <Fqdn>]
[-RequestGuid <Guid>]
[<CommonParameters>]
MigrationRequestQueue
Get-MailboxExportRequestStatistics
-RequestQueue <DatabaseIdParameter>
[-DomainController <Fqdn>]
[-IncludeReport]
[-RequestGuid <Guid>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-ReportOnly]
[<CommonParameters>]
説明
Get-MailboxExportRequest コマンドレットから Get-MailboxExportRequestStatistics コマンドレットをパイプライン処理することができます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-MailboxExportRequestStatistics -Identity Tony\MailboxExport1
この例では、Tony Smith に対する 2 番目のエクスポート要求の既定の統計情報を返します。 既定で返される情報の種類には、名、メールボックス、および状態が含まれています。
例 2
Get-MailboxExportRequestStatistics -Identity Tony\MailboxExport | Export-CSV \\SERVER01\ExportRequest_Reports\Tony_Exportstats.csv
この例では、Tony Smith のメールボックスの統計情報を返し、そのレポートを CSV ファイルにエクスポートします。
例 3
Get-MailboxExportRequestStatistics -Identity Tony\LegalHold -IncludeReport | Format-List
次の使用例は、IncludeReport パラメーターを使用し、結果を Format-List コマンドにパイプライン処理することで、Tony Smith のメールボックスのエクスポート要求に関する追加情報を返します。 (エクスポート要求は New-MailboxExportRequest を使用して作成されました)。
例 4
Get-MailboxExportRequestStatistics -MRSInstance CAS01.contoso.com
Exchange Server 2010 では、この例では、サーバー CAS01 で実行されている MRS のインスタンスによって処理されるエクスポート要求の既定の統計情報を返します。 このコマンドは、MRS のインスタンスによって現在処理されているエクスポート要求に関する情報のみを返します。 要求が既に完了している場合、情報は返されません。
例 5
Get-MailboxExportRequestStatistics -RequestQueue MailboxDatabase01
この例では、サーバー CAS01 で実行中の MRS のインスタンスにより処理中のエクスポート要求の既定の統計情報を返します。 このコマンドは MRS のインスタンスにより現在処理されているエクスポート要求の情報のみを返します。 要求が既に完了している場合、情報は返されません。
例 6
Get-MailboxExportRequest -Status Failed | Get-MailboxExportRequestStatistics -IncludeReport | Format-List > AllExportReports.txt
この例では、IncludeReport パラメーターを使用して状態が Failed であるすべてのエクスポート要求に関する追加情報を返してから、その情報をテキスト ファイル AllExportReports.txt に保存します。
パラメーター
-Diagnostic
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Diagnostic スイッチは、非常に詳細な情報を結果に入れて戻すかどうかを指定します。 このスイッチで値を指定する必要はありません。
通常、このスイッチは、問題をトラブルシューティングするために Microsoft カスタマー サービスおよびサポートからの要請があった場合に限り使用してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DiagnosticArgument
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DiagnosticArgument パラメーターは、Diagnostic スイッチを使用して返される結果を変更します。 通常、Diagnostic スイッチと DiagnosticArgument パラメーターは、問題をトラブルシューティングするために Microsoft カスタマー サービスおよびサポートからの要請があった場合に限り使用してください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DiagnosticInfo
適用対象: Exchange Online
このパラメーターは、クラウドベースのサービスでのみ使用できます。
通常、DiagnosticInfo パラメーターは、Microsoft カスタマー サービスとサポートの要求でのみ使用して、問題のトラブルシューティングを行います。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Identity パラメーターは、エクスポート要求の ID を指定します。 既定では、エクスポート要求には <alias>\MailboxExportX という名前が付けられます (X = 0 から 9)。 New-MailboxExportRequest コマンドレットを使用してエクスポート要求の名前を指定した場合は、次の構文を使用します: Alias\Name。
このパラメーターは、RequestGuid パラメーターまたは RequestQueue パラメーターでは使用できません。
注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | MailboxExportRequestIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IncludeReport
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
IncludeReport スイッチは、トラブルシューティングに使用できるように、追加情報が返されるようにするかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MRSInstance
適用対象: Exchange Server 2010
このパラメーターは Exchange Server 2010 でのみ使用できます。
MRSInstance パラメーターは、Microsoft Exchange メールボックス レプリケーション サービス (MRS) が存在するクライアント アクセス サーバーの完全修飾ドメイン名 (FQDN) を指定します。 このパラメーターを使用すると、MRS のこのインスタンスのすべてのレコードが返されます。
このパラメーターは、Identity パラメーターまたは RequestQueue パラメーターでは使用できません。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MRSInstance
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ReportOnly
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ReportOnly スイッチは、結果をレポート エントリ (エンコードされた文字列) の配列として返します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RequestGuid
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
RequestGuid パラメーターは、エクスポート要求の一意の識別子を指定します。 エクスポート要求の GUID を検索するには、Get-MailboxExportRequest コマンドレットを使用します。 RequestGuid パラメーターを指定した場合は、RequestQueue パラメーターも指定する必要があります。 データベース名
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MRSInstance
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RequestQueue
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターはデバッグのみを目的としています。
RequestQueue パラメーターは、要求が実行されているメールボックス データベースに基づいて要求を識別します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
データベース名
パラメーターのプロパティ
| 型: | DatabaseIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MigrationRequestQueue
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。