Get-MigrationUserStatistics

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの 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

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。