Get-EXOMailboxFolderStatistics

このコマンドレットは、PowerShell V2 モジュールExchange Onlineでのみ使用できます。 詳細については、「Exchange Online PowerShell V2 モジュールについて」を参照してください。

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

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

構文

Get-EXOMailboxFolderStatistics
   [-Archive]
   [-DiagnosticInfo <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-Folderscope <ElcFolderType>]
   [-Identity <String>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-PrimarySmtpAddress <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

説明

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

コマンドレット (フォルダー) Get-EXOMailboxFolderStatisticsコマンドレット (メールボックス) とGet-EXOMailboxStatistics混同しない。

例 1

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com

この例では、すべてのメールボックス フォルダーの統計情報を返します。 既定値は FolderScope All です。

例 2

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com -FolderScope Calendar -IncludeOldestAndNewestItems

次の使用例は、予定表フォルダーの統計情報のみを返します。

例 3

Get-EXOMailbox -ResultSize Unlimited | Get-EXOMailboxFolderStatistics -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize

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

パラメーター

-Archive

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

アーカイブが有効になっていないメールボックスでこのスイッチを使用すると、エラーが返されます。

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

通常、DiagnosticInfo パラメーターは、Microsoft カスタマー サービスとサポートの要求に応じてのみ使用して、問題のトラブルシューティングを行います。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ExternalDirectoryObjectId

ExternalDirectoryObjectId パラメーターは、オブジェクト内の ObjectId で表示するメールボックスAzure Active Directory。

Identity、PrimarySmtpAddress、または UserPrincipalName パラメーターでは、このパラメーターを使用することはできません。

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-Folderscope

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

  • すべて
  • アーカイブ
  • カレンダー
  • クラッター機能
  • 連絡先
  • ConversationHistory
  • DeletedItems
  • 下書き
  • 受信トレイ
  • ジャーナル
  • JunkEmail
  • LegacyArchiveJournals
  • ManagedCustomFolder
  • NonIpmRoot
  • メモ
  • 送信トレイ
  • 個人
  • RecoverableItems
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • タスク
Type:ElcFolderType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Identity

Identity パラメーターは、メールボックスまたはメール ユーザーの ID を指定します。 最適なパフォーマンスを得る場合は、ユーザー ID またはユーザー プリンシパル名 (UPN) を使用してメールボックスを識別することをお勧めします。

それ以外の場合は、メールボックスまたはメール ユーザーを一意に識別する任意の値を使用できます。 以下に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • LegacyExchangeDN
  • SamAccountName

ExternalDirectoryObjectId、PrimarySmtpAddress、または UserPrincipalName パラメーターでは、このパラメーターを使用することはできません。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-IncludeAnalysis

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

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

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

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

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

回復可能な削除済みメールボックスは、削除されたが回復可能なメールボックスです。

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

PrimarySmtpAddress は、表示するメールボックスをプライマリ SMTP 電子メール アドレス (たとえば、navin@contoso.com) で識別します。

ExternalDirectoryObjectId、Identity、または UserPrincipalName パラメーターでは、このパラメーターを使用することはできません。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-UserPrincipalName

UserPrincipalName パラメーターは、UPN で表示するメールボックスを識別します (たとえば、navin@contoso.onmicrosoft.com)。

ExternalDirectoryObjectId、Identity、PrimarySmtpAddress パラメーターでは、このパラメーターを使用することはできません。

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

入力

出力