Get-MailboxStatistics
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Get-MailboxStatistics コマンドレットを使用して、メールボックスのサイズ、メールボックスに含まれるメッセージの数、最後にアクセスした時刻などのメールボックスに関する情報を返します。 また、完了した移動要求の移動履歴または移動レポートを取得できます。
注: PowerShell Exchange Onlineでは、このコマンドレットの代わりに Get-EXOMailboxStatistics コマンドレットを使用することをお勧めします。 詳細については、「Exchange Online PowerShell への接続」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-MailboxStatistics
-Database <DatabaseIdParameter>
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>]
Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[<CommonParameters>]
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」を参照してください。
見ることができるのは、完了した移動要求の移動レポートと移動履歴のみです。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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
[アーカイブ] スイッチは、メールボックスに関連付けられているアーカイブ メールボックスのメールボックス統計を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CopyOnServer
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
CopyOnServer パラメーターは、指定したサーバー上の特定のデータベース コピーから統計を取得するために使用されます。
サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- Exchange の従来の DN
このパラメーターを使用しない場合、コマンドはローカル サーバー上で実行されます。
Type: | ServerIdParameter |
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 |
-Database
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
Database パラメーターは、指定したデータベース上のすべてのメールボックスの統計情報を返します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
このパラメーターには、Get-MailboxDatabase コマンドレットからのパイプライン入力を指定できます。
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Filter
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
Filter パラメーターは、OPATH 構文を使用して、指定したプロパティと値で結果をフィルター処理します。 検索条件は構文"Property -ComparisonOperator 'Value'"
を使用します。
- OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、
$true
、$false
、または$null
) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。 - Property はフィルタリング可能なプロパティです。
- ComparisonOperator は OPATH 比較演算子です (たとえば
-eq
、等しい場合や-like
文字列比較の場合)。 比較演算子の詳細については、「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'
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 |
-Identity
Identity パラメーターは、統計を返すメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- Domain\Username
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
Type: | GeneralMailboxOrMailUserIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeMoveHistory
IncludeMoveHistory スイッチには、ステータス、フラグ、ターゲット データベース、問題のあるアイテム、開始時刻、終了時刻、移動要求のさまざまな段階の期間、およびエラー コードなどの完了した移動要求の履歴を含む、メールボックスに関する追加情報を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeMoveReport
IncludeMoveReport スイッチには、サーバー接続や移動段階など、完了した移動要求の詳細な移動レポートを返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
コマンドの出力が詳細であるため、分析を容易に行うには、出力を .CSV ファイルに送信する必要があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludePassive
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
IncludePassive スイッチは、すべてのアクティブおよびパッシブ データベース コピーから統計を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しない場合、コマンドはアクティブなデータベース のコピーからのみ統計を取得します。
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 |
-IncludeQuarantineDetails
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
IncludeQuarantineDetails スイッチは、他の方法では結果に含まれない、メールボックスに関する追加の検査情報を返すかどうかを指定します。 これらの詳細情報から、いつ、なぜメールボックスが検査されたのかを確認することができます。 このスイッチで値を指定する必要はありません。
特にこのスイッチは、当該メールボックスの QuarantineDescription、QuarantineLastCrash、および QuarantineEnd のプロパティー値を返します。 これらの値を見るには、書式設定コマンドレットを使用する必要があります。 たとえば、「 Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*
」のように入力します。
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 |
-IncludeSoftDeletedRecipients
このパラメーターは、クラウドベースのサービスでのみ使用できます。
IncludeSoftDeletedRecipients スイッチは、論理的に削除されたメールボックスを結果に含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。
回復可能な削除が行われたメールボックスとは、まだ回復できる削除済みメールボックスのことです。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-NoADLookup
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
NoADLookup スイッチは、Active Directory ではなくメールボックス データベースから情報を取得することを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、多数のメールボックスを含むメールボックス データベースに対してクエリを実行するときに、コマンドレットのパフォーマンスを向上させるのに役立ちます。
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 |
-Server
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
Server パラメーターは、メールボックス統計情報の取得元となるサーバーを指定します。 次のいずれかの値を使用できます。
- 完全修飾ドメイン名 (FQDN)
- NetBIOS 名
Server パラメーターの値を指定した場合、このコマンドは、指定したサーバー上の (回復データベースも含めた) すべてのデータベース上のすべてのメールボックスの統計情報を返します。 このパラメーターを指定しない場合、コマンドは、ローカル サーバーのログオン統計情報を返します。
Type: | ServerIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StoreMailboxIdentity
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
StoreMailboxIdentity パラメーターは、指定したデータベース上の単一のメールボックスの統計情報を返す Database パラメーターと組み合わせて使用すると、対象のメールボックスの ID を指定します。 次のいずれかの値を使用できます。
- MailboxGuid
- LegacyDN
この構文を使用して、対応する Active Directory オブジェクトを持たない、またはメールボックス データベース内の切断されたメールボックスを指さない対応する Active Directory オブジェクトを持つ、切断されたメールボックスに関する情報を取得します。
Type: | StoreMailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。