Get-MailboxFolderStatistics

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

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

Примечание. В Exchange Online PowerShell рекомендуется использовать Get-EXOMailboxFolderStatistics вместо этого комлета. Дополнительные сведения см. в статье Connect to Exchange Online PowerShell.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-MailboxFolderStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   [[-Identity] <GeneralMailboxOrMailUserIdParameter>]
   [-AuditLog]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   -Database <DatabaseIdParameter>
   -StoreMailboxIdentity <StoreMailboxIdParameter>
   [-DiagnosticInfo <String>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [<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.

Пример 2

Get-MailboxFolderStatistics -Identity Chris -FolderScope Calendar

В этом примере используется параметр FolderScope для просмотра статистики папок календаря пользователя Кирилла.

Пример 3

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

В этом примере используется переключатель Archive для просмотра статистики для архива Ayla.

Пример 4

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

В этом примере используется переключатель IncludeAnalysis для просмотра статистики папки "Элементы, которые можно восстановить".

Пример 5

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

В этом примере параметр FolderScope используется для просмотра статистики папок входящие для всех почтовых ящиков.

Параметры

-Archive

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

Type:SwitchParameter
Position:Named
Default value:None
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.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019
-Database

Этот параметр доступен только в облачной службе.

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

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

Этот параметр доступен только в облачной службе.

Как правило, для устранения неполадок используется параметр DiagnosticInfo только по запросу службы клиентов и службы поддержки Майкрософт.

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

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
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
  • Черновики
  • Inbox;
  • JunkEmail
  • Журнал
  • LegacyArchiveJournals: Exchange 2013 или более поздний.
  • ManagedCustomFolder: возвращает выход для всех управляемых пользовательских папок.
  • NonIpmRoot: Exchange 2013 или более поздний.
  • Примечания.
  • Исходящие
  • Персональный
  • RecoverableItems: возвращает выход для папки "Извлекаемые элементы" и "Удаления", "DiscoveryHolds", "Purges" и "Версии".
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • Задачи
Type:ElcFolderType
Position:Named
Default value:None
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 указывает идентификатор почтового ящика или пользователя почты. Можно использовать любое уникальное значение, идентифицирующее почтовый ящик или пользователя почты. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Имя \ пользователя домена
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя
Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-StoreMailboxIdentity

Этот параметр доступен только в облачной службе.

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

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

Входные данные

Типы входных данных, поддерживаемые этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы входных данных" для командлета пустое, этот командлет не поддерживает ввода данных.

Выходные данные

Типы возвращаемых данных, или типы выходных данных, которые поддерживаются этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы выходных данных" пустое, командлет не возвращает данные.