Get-MailboxStatistics
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет Get-MailboxStatistics для возврата сведений о почтовом ящике, таких как размер почтового ящика, количество содержащихся в нем сообщений и время последнего доступа к нему. Кроме того, можно получить журнал перемещения или отчет о перемещении завершенного запроса на перемещение.
Примечание. В Exchange Online PowerShell вместо этого рекомендуется использовать командлет Get-EXOMailboxStatistics. Дополнительные сведения см. в статье Connect to Exchange Online PowerShell.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-MailboxStatistics
-Database <DatabaseIdParameter>
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>] Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[<CommonParameters>] Get-MailboxStatistics
-Server <ServerIdParameter>
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludePassive]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>] Описание
Только на серверах почтовых ящиков можно использовать командлет Get-MailboxStatistics без параметров. В этом случае командлет возвращает статистику по всем почтовым ящикам во всех базах данных на локальном сервере.
Для успешного выполнения командлета Get-MailboxStatistics требуется по крайней мере один из следующих параметров: Сервер, База данных или Удостоверение.
Командлет Get-MailboxStatistics можно использовать для возврата подробного журнала перемещения и отчета о перемещении для завершенных запросов на перемещение для устранения неполадок с запросом на перемещение. Чтобы просмотреть журнал перемещения, необходимо передать этот командлет в качестве объекта. Журналы перемещения хранятся в базе данных почтовых ящиков и нумеруются постепенно, а последний выполненный запрос на перемещение всегда пронумерован 0. Дополнительные сведения см. в разделах Пример 7, Пример 8 и Пример 9 этой статьи.
Вы можете просматривать только отчеты о перемещении и журнал перемещения для завершенных запросов на перемещение.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-MailboxStatistics -Identity AylaKolВ этом примере извлекается статистика почтового ящика для почтового ящика пользователя Ayla Kol с использованием связанного псевдонима AylaKol.
Пример 2
Get-MailboxStatistics -Server MailboxServer01В этом примере извлекается статистика почтовых ящиков для всех почтовых ящиков на сервере MailboxServer01.
Пример 3
Get-MailboxStatistics -Identity contoso\chrisВ этом примере извлекается статистика почтового ящика для указанного почтового ящика.
Пример 4
Get-MailboxStatistics -Database "Mailbox Database"В этом примере извлекается статистика почтовых ящиков для всех почтовых ящиков в указанной базе данных почтовых ящиков.
Пример 5
Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'В этом примере извлекается статистика почтовых ящиков для отключенных почтовых ящиков для всех баз данных почтовых ящиков в организации. Оператор -ne означает, что значение не равно.
Пример 6
Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742dВ этом примере извлекается статистика почтового ящика для одного отключенного почтового ящика. Значение параметра StoreMailboxIdentity — это GUID отключенного почтового ящика. Вы также можете использовать устаревшее имяDN.
Пример 7
Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-ListВ этом примере возвращается сводный журнал перемещения для завершенного запроса на перемещение для почтового ящика Айлы Кола. Если не отправить выходные данные в командлет Format-List, журнал перемещения не отобразится.
Пример 8
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
$temp.MoveHistory[0]В этом примере возвращается подробный журнал перемещения для завершенного запроса на перемещение для почтового ящика Айлы Кол. В этом примере используется временная переменная для хранения объекта статистики почтового ящика. Если почтовый ящик был перемещен несколько раз, существует несколько отчетов о перемещении. Последний отчет о перемещении всегда — MoveReport[0].
Пример 9
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csvВ этом примере возвращается подробный журнал перемещения и подробный подробный отчет о перемещении для почтового ящика Айлы Кол. В этом примере используется временная переменная для хранения объекта статистики запроса на перемещение и выводится отчет о перемещении в CSV-файл.
Параметры
-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 |
-CopyOnServer
Этот параметр доступен только в локальной среде Exchange.
Параметр CopyOnServer используется для получения статистики из определенной копии базы данных на указанном сервере.
Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- Имя.
- полное доменное имя;
- различающееся имя (DN);
- Устаревшее различающееся имя Exchange
Устаревшее различающееся имя Exchange
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Database
Этот параметр доступен только в локальной среде Exchange.
Параметр Database возвращает статистику для всех почтовых ящиков в указанной базе данных. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:
- имя;
- различающееся имя (DN);
- GUID
Этот параметр принимает входные данные конвейера из командлета Get-MailboxDatabase.
| Type: | DatabaseIdParameter |
| Position: | Named |
| 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 |
-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 |
-Filter
Этот параметр доступен только в локальной среде Exchange.
Параметр Filter использует синтаксис OPATH для фильтрации результатов по указанным свойствам и значениям. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'".
- Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например,
$true,$falseили$null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные. - Property — это свойство с поддержкой фильтрации.
- ComparisonOperator — это оператор сравнения OPATH (например
-eq, для равных и-likeдля сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators. - Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки (
'Value'или'$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо'$User'используйте'$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте500,$true,$false, или$nullвместо них).
Можно связать несколько условий поиска вместе с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
Например, чтобы отобразить все отключенные почтовые ящики в определенной базе данных почтовых ящиков, используйте следующий синтаксис: 'DisconnectDate -ne $null'.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 |
-IncludeMoveHistory
Параметр IncludeMoveHistory указывает, следует ли возвращать дополнительные сведения о почтовом ящике, включая журнал завершенного запроса на перемещение, такие как состояние, флаги, целевая база данных, недопустимые элементы, время начала, время окончания, длительность выполнения запроса на перемещение на различных этапах и коды сбоя. Указывать значение для этого параметра необязательно.
| 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 |
-IncludeMoveReport
Параметр IncludeMoveReport указывает, следует ли возвращать подробный подробный отчет о перемещении для завершенного запроса на перемещение, например подключения к серверу и этапы перемещения. Для этого переключателя не требуется указывать значение.
Так как выходные данные этой команды являются подробными, их следует отправить в файл .CSV для упрощения анализа.
| 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 |
-IncludePassive
Этот параметр доступен только в локальной среде Exchange.
Параметр IncludePassive указывает, следует ли возвращать статистику из всех активных и пассивных копий базы данных. Указывать значение для этого параметра необязательно.
Если этот параметр не используется, команда извлекает статистику только из активных копий базы данных.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeQuarantineDetails
Этот параметр доступен только в локальной среде Exchange.
Параметр IncludeQuarantineDetails указывает, следует ли возвращать дополнительные сведения о карантине о почтовом ящике, которые иначе не включены в результаты. Эти сведения можно использовать, чтобы определить, когда и почему почтовый ящик был помещен в карантин. Для этого переключателя не требуется указывать значение.
В частности, этот параметр возвращает значения свойств QuarantineDescription, QuarantineLastCrash и QuarantineEnd в почтовом ящике. Чтобы увидеть эти значения, используйте командлет форматирования. Например, Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeSoftDeletedRecipients
Этот параметр доступен только в облачной службе.
Параметр IncludeSoftDeletedRecipients указывает, следует ли включать в результаты обратимо удаленные почтовые ящики. Указывать значение для этого параметра необязательно.
Обратимо удаленные почтовые ящики — это почтовые ящики, которые по-прежнему можно восстановить.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-NoADLookup
Этот параметр доступен только в локальной среде Exchange.
Параметр NoADLookup указывает, что сведения извлекаются из базы данных почтовых ящиков, а не из Active Directory. Для этого переключателя не требуется указывать значение.
Этот параметр помогает повысить производительность командлетов при запросе базы данных почтовых ящиков, содержащей большое количество почтовых ящиков.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Этот параметр доступен только в локальной среде Exchange.
Параметр Server указывает сервер, с которого необходимо получить статистику почтовых ящиков. Можно использовать одно из следующих значений:
- Полное доменное имя (FQDN)
- NetBIOS-имя
При указании значения параметра Server команда возвращает статистику по всем почтовым ящикам во всех базах данных, включая базы данных восстановления, на указанном сервере. Если этот параметр не задан, команда возвращает статистику входов в систему для локального сервера.
| Type: | ServerIdParameter |
| Position: | Named |
| 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 |
-StoreMailboxIdentity
Этот параметр доступен только в локальной среде Exchange.
Параметр StoreMailboxIdentity указывает удостоверение почтового ящика при использовании с параметром Database для возврата статистики для одного почтового ящика в указанной базе данных. Можно использовать одно из следующих значений:
- MailboxGuid
- LegacyDN
Используйте этот синтаксис для получения сведений об отключенных почтовых ящиках, которые не имеют соответствующего объекта Active Directory или имеют соответствующий объект Active Directory, который не указывает на отключенный почтовый ящик в базе данных почтовых ящиков.
| Type: | StoreMailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.