Get-EXOMailboxFolderStatistics

Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.

Используйте командлет Get-EXOMailboxFolderStatistics для получения сведений о папках в указанном почтовом ящике, включая количество и размер элементов в папке, имя и идентификатор папки, а также другие сведения.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета 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

Параметр Archive указывает, следует ли возвращать статистику использования архивного почтового ящика, связанного с почтовым ящиком или пользователем почты. Для этого переключателя не требуется указывать значение.

Если вы используете этот параметр для почтового ящика, в который не включена архивация, возвращается ошибка.

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

-DiagnosticInfo

Как правило, параметр DiagnosticInfo используется только по запросу Майкрософт customer Service and Support для устранения неполадок. Допустимые значения:

  • ExternalDirectoryObjectId
  • Удостоверение
  • UserPrincipalName
Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Folderscope

Параметр FolderScope определяет область поиска по типу папки. Допустимыми являются следующие значения:

  • Все
  • Архив
  • Календарь
  • Папка "Несрочные"
  • Контакты
  • ConversationHistory
  • DeletedItems
  • Черновики
  • Inbox;
  • Журнал
  • Нежелательная почта
  • LegacyArchiveJournals
  • ManagedCustomFolder
  • NonIpmRoot
  • Примечания.
  • Исходящие
  • Персональный
  • 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 указывает идентификатор почтового ящика или пользователя почты. Для максимальной производительности рекомендуется использовать идентификатор пользователя или имя участника-пользователя (UPN) для идентификации почтового ящика.

В противном случае можно использовать любое значение, однозначно определяющее пользователя почтового ящика или почты. Например:

  • Имя
  • Псевдоним
  • различающееся имя (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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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.com).

Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или PrimarySmtpAddress.

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