Get-MigrationUserStatistics
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
特定のユーザーに対して要求された移行についての詳細情報を表示するには、Get-MigrationUserStatistics コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-MigrationUserStatistics
[-Identity] <MigrationUserIdParameter>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DiagnosticInfo <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-LimitSkippedItemsTo <Int32>]
[-IncludeSkippedItems]
[-Partition <MailboxIdParameter>]
[-SkipSubscription]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-MigrationUserStatistics -Identity davidp@corp.contoso.com -IncludeReport | Format-List Status,Error,Report
この例では、IncludeReport パラメータを使って、ユーザーの移行状態に関する詳細情報を表示します。
例 2
Get-MigrationUserStatistics -Identity davidp@corp.contoso.com | Format-List SkippedItemCount,SkippedItems
この例では、移行できなかったメールボックス アイテム(「スキップされたアイテム」と呼びます)の数と、スキップされたアイテムごとの情報を表示します。
例 3
Get-MigrationUserStatistics -Identity davidp@corp.contoso.com -IncludeSkippedItems | Select-Object -ExpandProperty SkippedItems | Format-List DateReceived, Subject
次の使用例は、SkippedItems プロパティに結果情報を表示します。
例 4
Get-MigrationUser -BatchId StagedBatch1 | Get-MigrationUserStatistics
この例では、StagedBatch1 という名前の移行バッチ中のユーザーに関する状態情報を表示します。
例 5
Get-MigrationUser | Get-MigrationUserStatistics
この例では、現在のすべての移行バッチから収集したユーザーに関する詳細情報を表示します。
例 6
Get-MigrationUserStatistics -Identity davidp@corp.contoso.com -Diagnostic | Format-List Status,Error,DiagnosticInfo
オンプレミスの Exchange では、この例では Diagnostic パラメーターを使用して、ユーザーの移行に関する詳細なトラブルシューティング情報を表示します。
パラメーター
-Diagnostic
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
Diagnostic スイッチは、非常に詳細な情報を結果に入れて戻すかどうかを指定します。 このスイッチで値を指定する必要はありません。
通常、このスイッチは、問題をトラブルシューティングするために Microsoft カスタマー サービスおよびサポートからの要請があった場合に限り使用してください。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DiagnosticArgument
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DiagnosticArgument パラメーターは、Diagnostic スイッチを使用して返される結果を変更します。 通常、Diagnostic スイッチと DiagnosticArgument パラメーターは、問題をトラブルシューティングするために Microsoft カスタマー サービスおよびサポートからの要請があった場合に限り使用してください。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DiagnosticInfo
このパラメーターは、クラウドベースのサービスでのみ使用できます。
通常、DiagnosticInfo パラメーターは、Microsoftカスタマー サービスとサポートの要求でのみ使用して、問題のトラブルシューティングを行います。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-DomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity パラメーターは、移行情報を取得するユーザーを指定します。 このパラメーターの値として、電子メール アドレスを使用します。
Type: | MigrationUserIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeReport
IncludeReport スイッチは、トラブルシューティングに使用できるように、追加情報が返されるようにするかどうかを指定します。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeSkippedItems
IncludeSkippedItems スイッチは、ユーザーに対してスキップされた項目を含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LimitSkippedItemsTo
LimitSkippedItemsTo パラメーターは、コマンド出力の SkippedItems プロパティ中のスキップされたアイテムのうち情報を表示するアイテムの最大数を指定します。 たとえば、このパラメータを 5 に設定すると、スキップされたアイテムが 6 つ以上あったとしても、このコマンドレットは、指定したユーザーのスキップされたアイテムに関する情報を最大 5 つしか表示しません。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Partition
このパラメーターは、クラウドベースのサービスでのみ使用できます。
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SkipSubscription
SkipSubscription スイッチは、ユーザーのサブスクリプションの読み込みをスキップするかどうかを指定します。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。