Get-EXOMailboxFolderStatistics

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online

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

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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DiagnosticInfo

通常、DiagnosticInfo パラメーターは、Microsoftカスタマーサービスとサポートの要求でのみ使用して、問題のトラブルシューティングを行います。有効な値は次のとおりです。

ExternalDirectoryObjectId
ID
UserPrincipalName

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

-ExternalDirectoryObjectId

ExternalDirectoryObjectId パラメーターは、Azure Active Directory の ObjectId によって表示するメールボックスを識別します。

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

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

-Folderscope

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

すべて
アーカイブ
予定表
クラッター機能
連絡先
ConversationHistory
DeletedItems
下書き
受信トレイ
ジャーナル
JunkEmail
LegacyArchiveJournals
ManagedCustomFolder
NonIpmRoot
メモ
送信トレイ
Personal
RecoverableItems
RssSubscriptions
SentItems
SyncIssues
タスク

Type:	ElcFolderType
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-IncludeAnalysis

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

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

-IncludeOldestAndNewestItems

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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

-PrimarySmtpAddress

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

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

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

-UserPrincipalName

UserPrincipalName パラメーターは、 navin@contoso.onmicrosoft.comUPN で表示するメールボックスを識別します (例: )。

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

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