Get-EXOMailboxFolderStatistics
Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Используйте командлет Get-EXOMailboxFolderStatistics для получения сведений о папках в указанном почтовом ящике, включая количество и размер элементов в папке, имя и идентификатор папки, а также другие сведения.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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
Применимо: Exchange Online
Параметр Архив указывает, следует ли возвращать статистику использования архивного почтового ящика, связанного с почтовым ящиком или пользователем почты. С этим параметром не нужно указывать значение.
Если вы используете этот параметр для почтового ящика, в который не включена архивация, возвращается ошибка.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DiagnosticInfo
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalDirectoryObjectId
Применимо: Exchange Online
Параметр ExternalDirectoryObjectId определяет почтовый ящик, который требуется просмотреть с помощью ObjectId в Microsoft Entra ID.
Этот параметр нельзя использовать с параметрами Identity, PrimarySmtpAddress или UserPrincipalName.
Свойства параметров
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Folderscope
Применимо: Exchange Online
Параметр FolderScope определяет область поиска по типу папки. Допустимыми являются следующие значения:
- Все
- Архив
- Календарь
- Папка "Несрочные"
- Контакты
- ConversationHistory
- DeletedItems
- Черновики
- Inbox;
- Журнал
- Нежелательная почта
- LegacyArchiveJournals
- ManagedCustomFolder
- NonIpmRoot
- Примечания.
- Исходящие
- Персональный
- RecoverableItems
- RssSubscriptions
- SentItems
- SyncIssues
- Задачи
Свойства параметров
| Тип: | ElcFolderType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online
Параметр Identity указывает идентификатор почтового ящика или пользователя почты. Для максимальной производительности рекомендуется использовать идентификатор пользователя или имя участника-пользователя (UPN) для идентификации почтового ящика.
В противном случае можно использовать любое значение, однозначно определяющее пользователя почтового ящика или почты. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- LegacyExchangeDN
- SamAccountName
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, PrimarySmtpAddress или UserPrincipalName.
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeAnalysis
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeOldestAndNewestItems
Применимо: Exchange Online
Параметр IncludeOldestAndNewestItems указывает, следует ли возвращать даты самых старых и новых элементов в каждой папке. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeSoftDeletedRecipients
Применимо: Exchange Online
Параметр IncludeSoftDeletedRecipients указывает, следует ли включать обратимо удаленные почтовые ящики в результаты. С этим параметром не нужно указывать значение.
Обратимо удаленные почтовые ящики — это почтовые ящики, которые были удалены, но по-прежнему могут быть восстановлены.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PrimarySmtpAddress
Применимо: Exchange Online
PrimarySmtpAddress определяет почтовый ящик, который нужно просмотреть по основному SMTP-адресу электронной почты (например, navin@contoso.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или UserPrincipalName.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-UserPrincipalName
Применимо: Exchange Online
Параметр UserPrincipalName определяет почтовый ящик, который нужно просмотреть по имени участника-пользователя (например, navin@contoso.onmicrosoft.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или PrimarySmtpAddress.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.