Get-MoveRequestStatistics
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。
Get-MoveRequestStatistics コマンドレットを使用すると、移動要求についての詳細情報が表示されます。
このコマンドレットにより戻される一部のエラー メッセージは、一時的なもので、要求が実際に失敗したことを示すものではありません。 Status 値が Queued か InProgress であれば、要求は正常に進行しています。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
IdentityOnPremises
Get-MoveRequestStatistics
[-Identity] <MoveRequestIdParameter>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-ReportOnly]
[<CommonParameters>]
IdentityCloud
Get-MoveRequestStatistics
[-Identity] <MoveRequestIdParameter>
[-Analysis]
[-DiagnosticInfo <String>]
[-DiagnosticOnly]
[-IncludeReport]
[-ProxyToMailbox <MailboxIdParameter>]
[-ReportOnly]
[<CommonParameters>]
MigrationMoveRequestQueue
Get-MoveRequestStatistics
-MoveRequestQueue <DatabaseIdParameter>
[-MailboxGuid <Guid>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-ReportOnly]
[<CommonParameters>]
MigrationMRSInstance
Get-MoveRequestStatistics
-MRSInstance <Fqdn>
[-MailboxGuid <Guid>]
[-DomainController <Fqdn>]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-MoveRequestStatistics -Identity Tony@contoso.com
この例を実行すると、Tony Smith のメールボックスの既定の統計情報 (たとえば、状態、メールボックス サイズ、アーカイブ メールボックス サイズ、完了率) が返されます。
例 2
Get-MoveRequestStatistics -Identity "contoso\tony" | Format-List
この例を実行すると、パイプライン処理により Format-List コマンドに結果が渡され、Tony Smith のメールボックスについての詳細な統計情報が返されます。
例 3
Get-MoveRequestStatistics -Identity Tony@contoso.com -IncludeReport | Export-CSV C:\MRStats.csv
この例では、Tony Smith のメールボックスの移動についての追加情報が返され、レポートが .csv ファイルにエクスポートされます。
例 4
Get-MoveRequestStatistics -MoveRequestQueue "MBXDB02"
この例を実行すると、移動要求が進行中か、データベース MBXDB02 に対して移動要求が消去されていないすべてのメールボックスの既定の統計情報が返されます。
例 5
Get-MoveRequestStatistics -MRSInstance CAS01.contoso.com -MailboxGuid b6a6795c-a010-4f67-aaaa-da372d56fcb9
Exchange Server 2010 では、この例では、サーバー CAS01 で実行されている Microsoft Exchange メールボックス レプリケーション サービスのインスタンスによって移動されるメールボックスの既定の統計情報を返します。
例 6
Get-MoveRequestStatistics tony@contoso.com -IncludeReport -DiagnosticInfo Verbose | Export-Clixml "C:\Data\MoveReport.xml"
次の使用例は、移動要求情報をエクスポートして、後で分析のために MRS_Explorer.ps1 スクリプトにインポートできるようにします。 詳細については、「MRS-エクスプローラー」を参照してください。
パラメーター
-Analysis
適用対象: Exchange Online
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill Analysis Description }}
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityCloud
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Diagnostic
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
Diagnostic スイッチは、非常に詳細な情報を結果に入れて戻すかどうかを指定します。 このスイッチで値を指定する必要はありません。
通常、このスイッチは、問題をトラブルシューティングするために Microsoft カスタマー サービスおよびサポートからの要請があった場合に限り使用してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityOnPremises
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationMoveRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DiagnosticArgument
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DiagnosticArgument パラメーターは、Diagnostic スイッチを使用して返される結果を変更します。 通常、Diagnostic スイッチと DiagnosticArgument パラメーターは、問題をトラブルシューティングするために Microsoft カスタマー サービスおよびサポートからの要請があった場合に限り使用してください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityOnPremises
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationMoveRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DiagnosticInfo
適用対象: Exchange Online
このパラメーターは、クラウドベースのサービスでのみ使用できます。
通常、DiagnosticInfo パラメーターは、Microsoft カスタマー サービスとサポートの要求でのみ使用して、問題のトラブルシューティングを行います。 有効な値は次のとおりです。
- ShowTimeline
- ShowTimeslot
- 詳細
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityCloud
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DiagnosticOnly
適用対象: Exchange Online
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill DiagnosticOnly Description }}
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityCloud
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityOnPremises
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationMoveRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationMRSInstance
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity パラメーターは、メールボックスまたはメール ユーザーの ID を指定します。 次のいずれかの値を使用できます。
- GUID
- 識別名 (DN)
- Domain\Account
- ユーザー プリンシパル名 (UPN)
- 従来の Exchange DN
- SMTP アドレス
- エイリアス
このパラメーターは、MoveRequestQueue パラメーターまたは MailboxGuid パラメーターと共に使用できます。
注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | MoveRequestIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityOnPremises
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
IdentityCloud
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IncludeReport
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
IncludeReport スイッチは、トラブルシューティングに使用できるように、追加情報が返されるようにするかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityOnPremises
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
IdentityCloud
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationMoveRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MailboxGuid
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
MailboxGuid パラメーターには、移動要求の統計情報を表示する対象のメールボックスの GUID を指定します。
データベース名
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MigrationMoveRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationMRSInstance
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MoveRequestQueue
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
このパラメーターはデバッグのみを目的としています。
MoveRequestQueue パラメーターには、移動要求が格納されているメールボックス データベースを指定します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
Identity パラメーターまたは MRSInstance パラメーターでは、このパラメーターを使用できません。
パラメーターのプロパティ
| 型: | DatabaseIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MigrationMoveRequestQueue
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MRSInstance
適用対象: Exchange Server 2010
このパラメーターは Exchange Server 2010 でのみ使用できます。
MRSInstance パラメーターは、Microsoft Exchange メールボックス レプリケーション サービス (MRS) が存在するクライアント アクセス サーバーの完全修飾ドメイン名 (FQDN) を指定します。 このパラメーターを使用すると、MRS のこのインスタンスのすべてのレコードが返されます。
このパラメーターは、Identity パラメーターまたは MoveRequestQueue パラメーターでは使用できません。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MigrationMRSInstance
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProxyToMailbox
適用対象: Exchange Online
このパラメーターは、クラウドベースのサービスでのみ使用できます。
ProxyToMailbox パラメーターは、指定されたメールボックスの場所によって結果をフィルター処理します (プロキシとも呼ばれます)。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- Name
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
パラメーターのプロパティ
| 型: | MailboxIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityCloud
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ReportOnly
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
IdentityOnPremises
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
IdentityCloud
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MigrationMoveRequestQueue
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。