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]
   [-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.

Пример 2

Get-MailboxFolderStatistics -Identity Chris -FolderScope Calendar

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

Пример 3

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

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

Пример 4

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

В этом примере используется переключатель IncludeAnalysis для просмотра статистики папки Tony's Recoverable Items.

Пример 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
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.

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

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

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

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

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

-DiagnosticInfo

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

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

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. Вы определяете контроллер домена по его полному доменному имени (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
  • Черновики
  • Inbox;
  • Нежелательная почта
  • Журнал
  • LegacyArchiveJournals: Exchange 2013 или более поздней версии.
  • ManagedCustomFolder: возвращает выходные данные для всех управляемых пользовательских папок.
  • NonIpmRoot: Exchange 2013 или более поздней версии.
  • Примечания.
  • Исходящие
  • Персональный
  • RecoverableItems. Возвращает выходные данные для папки "Элементы с возможностью восстановления" и вложенных папок "Удаления", "DiscoveryHolds", "Очистки" и "Версии".
  • 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 указывает идентификатор почтового ящика или пользователя почты. Можно использовать любое уникальное значение, идентифицирующее почтовый ящик или пользователя почты. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя
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. Значение по умолчанию — 1000.

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

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

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

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

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