Get-EXOMailboxFolderStatistics
Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в статье О модуле PowerShell Exchange Online.
Используйте командлет Get-EXOMailboxFolderStatistics для получения сведений о папках в указанном почтовом ящике, включая количество и размер элементов в папке, имя и идентификатор папки, а также другую информацию.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Get-EXOMailboxFolderStatistics
[-Archive]
[-DiagnosticInfo <String>]
[-ExternalDirectoryObjectId <Guid>]
[-Folderscope <ElcFolderType>]
[-Identity <String>]
[-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 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DiagnosticInfo
Применимо: Exchange Online
Примечание: этот параметр не рекомендуется использовать в модуле версии 3.7.0-Preview1 или более поздней.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalDirectoryObjectId
Применимо: Exchange Online
Параметр ExternalDirectoryObjectId определяет почтовый ящик, который вы хотите просмотреть по ObjectId в Microsoft Entra ID.
Этот параметр нельзя использовать с параметрами Identity, PrimarySmtpAddress или UserPrincipalName.
Свойства параметров
| Тип: | Guid |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Folderscope
Применимо: Exchange Online
Параметр FolderScope определяет область поиска по типу папки. Допустимыми являются следующие значения:
- Все
- Архив
- Календарь
- Папка "Несрочные"
- Контакты
- ConversationHistory
- Удаленные
- Черновики
- Inbox;
- Журнал
- Нежелательная почта
- LegacyArchiveJournals
- ManagedCustomFolder
- NonIpmRoot
- Примечания.
- Исходящие
- Персональный
- RecoverableItems
- RssSubscriptions
- SentItems
- Проблемы с синхронизацией
- Задачи
Свойства параметров
| Тип: | ElcFolderType |
| Значение по умолчанию: | 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 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeOldestAndNewestItems
Применимо: Exchange Online
Ключ IncludeOldestAndNewestItems определяет, должны ли возвращаться даты самых старых и новых элементов в каждой папке. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeSoftDeletedRecipients
Применимо: Exchange Online
Переключатель IncludeSoftDeletedRecipients определяет, следует ли включать в результаты программно удаленные почтовые ящики. С этим параметром не нужно указывать значение.
Обратимо удаленные почтовые ящики — это почтовые ящики, которые были удалены, но все еще могут быть восстановлены.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PrimarySmtpAddress
Применимо: Exchange Online
Параметр PrimarySmtpAddress определяет почтовый ящик, который нужно просмотреть по основному адресу электронной почты SMTP (например, navin@contoso.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или UserPrincipalName.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-UserPrincipalName
Применимо: Exchange Online
Параметр UserPrincipalName определяет почтовый ящик, который вы хотите просмотреть с помощью имени участника-пользователя (например, navin@contoso.onmicrosoft.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или PrimarySmtpAddress.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | 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.