Get-MailboxFolderStatistics

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

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

指定したメールボックス内のフォルダーに関する情報 (フォルダー内のアイテムの数やサイズ、フォルダー名と ID、およびその他の情報) を取得するには、Get-MailboxFolderStatistics コマンドレットを使用します。

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

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

構文

Get-MailboxFolderStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   [[-Identity] <GeneralMailboxOrMailUserIdParameter>]
   [-AuditLog]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   -Database <DatabaseIdParameter>
   -StoreMailboxIdentity <StoreMailboxIdParameter>
   [-DiagnosticInfo <String>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]

説明

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

メールボックスには、ユーザーには認識されずアプリケーションだけが使用する非表示のアイテムを格納できます。 Get-MailboxFolderStatistics コマンドレットは、FolderSize、FolderAndSubfolderSize、ItemsInFolder、ItemsInFolderAndSubfolders の各値の非表示項目を返すことができます。

Get-MailboxFolderStatistics コマンドレットと、Get-MailboxStatistics コマンドレットを混同しないでください。

例

例 1

Get-MailboxFolderStatistics -Identity contoso\chris

この例では、FolderScope パラメーターを指定せずに、Contoso ドメイン内のユーザー Chris に関するすべての情報を取得します。

例 2

Get-MailboxFolderStatistics -Identity Chris -FolderScope Calendar

この例では、FolderScope パラメーターを使用して、ユーザー Chris の予定表フォルダーに関する統計情報を表示します。

例 3

Get-MailboxFolderStatistics -Identity Ayla@contoso.com -Archive

この例では、Archive スイッチを使用して Ayla のアーカイブの統計を表示します。

例 4

Get-MailboxFolderStatistics -Identity "Tony" -FolderScope RecoverableItems -IncludeAnalysis

この例では、IncludeAnalysis スイッチを使用して Tony の回復可能なアイテム フォルダーの統計を表示します。

例 5

$All = Get-Mailbox -ResultSize Unlimited

$All | foreach {Get-MailboxFolderStatistics -Identity $_.Identity -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize}

この例では、FolderScope パラメーターを使用して、すべてのメールボックスの受信トレイ フォルダーの統計情報を表示します。

パラメーター

-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

-AuditLog

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

このパラメーターは、Microsoft の内部使用のために予約されています。

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

-Database

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

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-FolderScope

FolderScope パラメーターには、フォルダーの種類による検索のスコープを指定します。 有効なパラメーターは次のとおりです。

  • すべて
  • アーカイブ: Exchange 2016 以降。
  • 予定表
  • 連絡先
  • ConversationHistory
  • DeletedItems
  • 下書き
  • 受信トレイ
  • JunkEmail
  • ジャーナル
  • LegacyArchiveJournals: Exchange 2013 以降。
  • ManagedCustomFolder: すべてのマネージド カスタム フォルダーの出力を返します。
  • NonIpmRoot: Exchange 2013 以降。
  • メモ
  • 送信トレイ
  • Personal
  • RecoverableItems: 回復可能なアイテム フォルダーと、削除、DiscoveryHolds、Purges、Versions サブフォルダーの出力を返します。
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • タスク
Type:ElcFolderType
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

-Identity

Identity パラメーターは、メールボックスまたはメール ユーザーの ID を指定します。 メールボックス、またはメール ユーザーを一意に識別する任意の値を使用できます。 例:

  • 名前
  • 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

-IncludeAnalysis

IncludeAnalysis スイッチは、フォルダー内のすべてのアイテムをスキャンし、フォルダーとアイテム サイズに関連する統計情報を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。

コマンドの完了に時間がかかることがあるため、トラブルシューティングの目的で、このスイッチを使用する必要があります。

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

-IncludeOldestAndNewestItems

IncludeOldestAndNewestItems スイッチは、各フォルダー内の最も古いアイテムと最も新しいアイテムの日付を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。

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

-IncludeSoftDeletedRecipients

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

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

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

ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SkipCount

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

{{ Fill SkipCount Description }}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StoreMailboxIdentity

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

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:StoreMailboxIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

入力

Input types

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

出力

Output types

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