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 |