次の方法で共有


Get-MailboxStatistics

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。

Get-MailboxStatistics コマンドレットを使用して、メールボックスのサイズ、メールボックスに含まれるメッセージの数、最後にアクセスした時刻などのメールボックスに関する情報を返します。 また、完了した移動要求の移動履歴または移動レポートを取得できます。

: PowerShell Exchange Onlineでは、このコマンドレットの代わりに Get-EXOMailboxStatistics コマンドレットを使用することをお勧めします。 詳細については、「Exchange Online PowerShell への接続」を参照してください。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Database

Get-MailboxStatistics
    [[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
    -Database <DatabaseIdParameter>
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IncludeMoveHistory]
    [-IncludeMoveReport]
    [-IncludeQuarantineDetails]
    [-NoADLookup]
    [<CommonParameters>]

Identity

Get-MailboxStatistics
    [-Identity] <GeneralMailboxOrMailUserIdParameter>
    [-Archive]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-IncludeMoveHistory]
    [-IncludeMoveReport]
    [-IncludeQuarantineDetails]
    [-IncludeSoftDeletedRecipients]
    [-NoADLookup]
    [-UseCustomRouting]
    [<CommonParameters>]

Server

Get-MailboxStatistics
    -Server <ServerIdParameter>
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IncludeMoveHistory]
    [-IncludeMoveReport]
    [-IncludePassive]
    [-IncludeQuarantineDetails]
    [-NoADLookup]
    [<CommonParameters>]

説明

メールボックス サーバーだけを対象とする場合は、パラメーターなしの Get-MailboxStatistics コマンドレットを使用できます。 その場合、コマンドレットは、ローカル サーバーにあるすべてのデータベースのすべてのメールボックスについて、統計情報を返します。

Get-MailboxStatistics コマンドレットを正常に完了するには、少なくとも 1 つのパラメーター (サーバー、データベース、または ID) が必要です。

Get-MailboxStatistics コマンドレットを使用することで、移動要求のトラブルシューティングのために、完了した移動要求の詳細な移動履歴と移動レポートを取得することができます。 移動履歴を表示するには、このコマンドレットをオブジェクトとして渡す必要があります。 移動履歴はメールボックス データベースに保持され、増分番号が付けられます。最後に実行された移動要求には常に 0 という番号が付けられます。 詳細については、このトピックの「例 7」、「例 8」、および「例 9」を参照してください。

見ることができるのは、完了した移動要求の移動レポートと移動履歴のみです。

: Exchange Online PowerShell の LastUserActionTime プロパティは非推奨になっています。 メールボックスの最後のアクティブ時間として、そのプロパティの値を使用しないでください。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例 1

Get-MailboxStatistics -Identity AylaKol

この例では、ユーザー Ayla Kol のメールボックスのメールボックス統計情報を、関連付けられているエイリアスの AylaKol を使用して取得します。

例 2

Get-MailboxStatistics -Server MailboxServer01

この例では、サーバー MailboxServer01 のすべてのメールボックスのメールボックス統計を取得します。

例 3

Get-MailboxStatistics -Identity contoso\chris

この例では、指定したメールボックスについての統計情報を取得します。

例 4

Get-MailboxStatistics -Database "Mailbox Database"

この例では、指定したメールボックス データベース中のすべてのメールボックスについての統計情報を取得します。

例 5

Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'

この例では、組織内のすべてのメールボックス データベースについて、切断されているメールボックスに関するメールボックス統計情報を取得します。 -ne 演算子は not equal を表します。

例 6

Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742d

この例では、切断されている単一のメールボックスに関するメールボックス統計情報を取得します。 StoreMailboxIdentity パラメーターの値は、切断されているメールボックスのメールボックス GUID です。 LegacyDN を使用することもできます。

例 7

Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List

この例では、Ayla Kol のメールボックスについて、完了した移動要求のサマリー移動履歴が返されます。 出力を Format-List コマンドレットにパイプライン処理しない場合、移動履歴は表示されません。

例 8

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory

$temp.MoveHistory[0]

この例では、Ayla Kol のメールボックスについて、完了した移動要求の詳細な移動履歴が返されます。 この例では、一時変数を使用して、メールボックス統計オブジェクトを保管します。 メールボックスが複数回移動された場合、複数の移動レポートがあります。 最後の移動レポートは常に MoveReport[0] になります。

例 9

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport

$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv

この例では、Ayla Kol のメールボックスについて、詳細な移動履歴と詳細な移動レポートが返されます。 この例では、一時変数を使用して移動要求統計オブジェクトを保管し、移動レポートを CSV ファイルに出力します。

パラメーター

-Archive

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

アーカイブ スイッチは、メールボックスに関連付けられているアーカイブ メールボックスのメールボックス統計を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CopyOnServer

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

CopyOnServer パラメーターは、指定したサーバー上の特定のデータベース コピーから統計を取得するために使用されます。

サーバーを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • FQDN
  • 識別名 (DN)
  • Exchange の従来の DN

このパラメーターを使用しない場合、コマンドはローカル サーバー上で実行されます。

パラメーターのプロパティ

型:ServerIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Database
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Identity
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Database

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

Database パラメーターは、指定したデータベース上のすべてのメールボックスの統計情報を返します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。

  • 名前
  • 識別名 (DN)
  • GUID

このパラメーターには、Get-MailboxDatabase コマンドレットからのパイプライン入力を指定できます。

パラメーターのプロパティ

型:DatabaseIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Database
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値: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

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Filter

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

Filter パラメーターは、OPATH 構文を使用して、指定したプロパティと値で結果をフィルター処理します。 検索条件は構文"Property -ComparisonOperator 'Value'"を使用します。

  • OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、$true$false、または $null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。
  • Property はフィルタリング可能なプロパティです。
  • ComparisonOperator は OPATH 比較演算子です (たとえば、文字列比較の場合は等号と-like-eq)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。
  • Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 ('Value'または'$Variable') で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。 整数またはシステム値を引用符で囲まないでください (たとえば、代わりに 500$true$false、または $null を使用します)。

論理演算子 -and および -or を使用すると、複数の検索条件を連結することができます。 たとえば、"Criteria1 -and Criteria2" または "(Criteria1 -and Criteria2) -or Criteria3" です。

Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。

たとえば、特定のメールボックス データベース上のすべての切断されたメールボックスを表示するには、次の構文を使用します: 'DisconnectDate -ne $null'

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Database
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Server
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Identity パラメーターは、統計を返すメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)

パラメーターのプロパティ

型:GeneralMailboxOrMailUserIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:1
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-IncludeMoveHistory

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

IncludeMoveHistory スイッチには、ステータス、フラグ、ターゲット データベース、問題のあるアイテム、開始時刻、終了時刻、移動要求のさまざまな段階の期間、およびエラー コードなどの完了した移動要求の履歴を含む、メールボックスに関する追加情報を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IncludeMoveReport

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

IncludeMoveReport スイッチには、サーバー接続や移動段階など、完了した移動要求の詳細な移動レポートを返すかどうかを指定します。 このスイッチで値を指定する必要はありません。

コマンドの出力が詳細であるため、分析を容易に行うには、出力を .CSV ファイルに送信する必要があります。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IncludePassive

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

IncludePassive スイッチは、すべてのアクティブおよびパッシブ データベース コピーから統計を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。

このスイッチを使用しない場合、コマンドはアクティブなデータベース のコピーからのみ統計を取得します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Server
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IncludeQuarantineDetails

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

IncludeQuarantineDetails スイッチは、他の方法では結果に含まれない、メールボックスに関する追加の検査情報を返すかどうかを指定します。 これらの詳細情報から、いつ、なぜメールボックスが検査されたのかを確認することができます。 このスイッチで値を指定する必要はありません。

特にこのスイッチは、当該メールボックスの QuarantineDescription、QuarantineLastCrash、および QuarantineEnd のプロパティー値を返します。 これらの値を見るには、書式設定コマンドレットを使用する必要があります。 たとえば、「 Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine* 」のように入力します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IncludeSoftDeletedRecipients

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

IncludeSoftDeletedRecipients スイッチは、論理的に削除されたメールボックスを結果に含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。

回復可能な削除が行われたメールボックスとは、まだ回復できる削除済みメールボックスのことです。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NoADLookup

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

NoADLookup スイッチは、Active Directory ではなくメールボックス データベースから情報を取得することを指定します。 このスイッチで値を指定する必要はありません。

このスイッチは、多数のメールボックスを含むメールボックス データベースに対してクエリを実行するときに、コマンドレットのパフォーマンスを向上させるのに役立ちます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Server

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

Server パラメーターは、メールボックス統計情報の取得元となるサーバーを指定します。 次のいずれかの値を使用できます。

  • 完全修飾ドメイン名 (FQDN)
  • NetBIOS 名

Server パラメーターの値を指定した場合、このコマンドは、指定したサーバー上の (回復データベースも含めた) すべてのデータベース上のすべてのメールボックスの統計情報を返します。 このパラメーターを指定しない場合、コマンドは、ローカル サーバーのログオン統計情報を返します。

パラメーターのプロパティ

型:ServerIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Server
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-StoreMailboxIdentity

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

StoreMailboxIdentity パラメーターは、指定したデータベース上の単一のメールボックスの統計情報を返す Database パラメーターと組み合わせて使用すると、対象のメールボックスの ID を指定します。 次のいずれかの値を使用できます。

  • MailboxGuid
  • LegacyDN

この構文を使用して、対応する Active Directory オブジェクトを持たない、またはメールボックス データベース内の切断されたメールボックスを指さない対応する Active Directory オブジェクトを持つ、切断されたメールボックスに関する情報を取得します。

パラメーターのプロパティ

型:StoreMailboxIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Database
配置:1
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UseCustomRouting

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

{{ Fill UseCustomRouting Description }}

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。

入力

Input types

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

出力

Output types

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