Get-MailboxStatistics
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут быть эксклюзивными для той или иной среды.
Используйте командлет Get-MailboxStatistics для возврата сведений о почтовом ящике, таких как размер почтового ящика, количество содержащихся в нем сообщений и время последнего обращения к почтовому ящику. Кроме того, вы можете получить историю перемещений или отчет о выполненных запросах на перемещение.
Примечание. В Exchange Online PowerShell рекомендуется использовать командлет Get-EXOMailboxStatistics вместо этого командлета. Дополнительные сведения см. в статье Connect to Exchange Online PowerShell.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Database
Get-MailboxStatistics
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>]
Identity
Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[-UseCustomRouting]
[<CommonParameters>]
Server
Get-MailboxStatistics
-Server <ServerIdParameter>
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludePassive]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>]
Описание
Только на серверах почтовых ящиков можно использовать командлет Get-MailboxStatistics без параметров. В этом случае командлет возвращает статистику по всем почтовым ящикам во всех базах данных на локальном сервере.
Для успешной работы командлета Get-MailboxStatistics требуется по крайней мере один из следующих параметров: сервер, база данных или удостоверение.
С помощью командлета Get-MailboxStatistics можно вернуть подробную историю перемещений и отчет о выполненных запросах на перемещение для устранения неполадок с запросом на перемещение. Чтобы просмотреть журнал перемещений, вы должны передать этот командлет как объект. Истории перемещений сохраняются в базе данных почтовых ящиков и постепенно нумеруются, при этом последний выполненный запрос на перемещение всегда нумеруется как 0. Дополнительные сведения см. в примерах 7, 8 и 9.
Вы можете просматривать только отчеты о перемещениях и журнал перемещений для выполненных запросов на перемещение.
Примечание. Мы не рекомендуем свойство LastUserActionTime в Exchange Online PowerShell. Не используйте значение этого свойства в качестве последнего активного времени для почтового ящика.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-MailboxStatistics -Identity AylaKol
В этом примере статистика почтового ящика пользователя Ayla Kol получает статистику по почтовому ящику пользователя 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 отключенного почтового ящика. Вы также можете использовать LegacyDN.
Пример 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
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Ключ "Архив" определяет, следует ли возвращать статистику по архивному почтовому ящику, связанному с почтовым ящиком. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CopyOnServer
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр CopyOnServer используется для получения статистики из определенной копии базы данных на указанном сервере.
Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- Имя.
- полное доменное имя;
- различающееся имя (DN);
- Устаревшее различающееся имя Exchange
Устаревшее различающееся имя Exchange
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Database
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Database
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр Database возвращает статистику для всех почтовых ящиков в указанной базе данных. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:
- имя;
- различающееся имя (DN);
- GUID
Этот параметр принимает входные данные конвейера из командлета Get-MailboxDatabase.
Свойства параметров
| Тип: | DatabaseIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Database
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Filter
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде 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'
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Database
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
Server
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр Identity указывает почтовый ящик, для которого требуется вернуть статистику. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | GeneralMailboxOrMailUserIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeMoveHistory
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Ключ IncludeMoveHistory определяет, следует ли возвращать дополнительные сведения о почтовом ящике, включающие журнал выполненных запросов на перемещение, такие как состояние, флаги, целевая база данных, поврежденные элементы, время начала, время окончания, длительность различных этапов запроса на перемещение и коды сбоев. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeMoveReport
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Ключ IncludeMoveReport указывает, следует ли возвращать подробный отчет о перемещении для выполненного запроса на перемещение, например, подключений к серверу и этапов перемещения. С этим параметром не нужно указывать значение.
Так как выходные данные этой команды подробные, их следует отправить в файл .CSV для упрощения анализа.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludePassive
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Ключ IncludePassive определяет, следует ли возвращать статистику из всех активных и пассивных копий базы данных. С этим параметром не нужно указывать значение.
Если этот переключатель не используется, команда получает статистику только из активных копий базы данных.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Server
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeQuarantineDetails
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр IncludeQuarantineDetails определяет, следует ли возвращать дополнительные сведения о карантине почтового ящика, которые не включены в результаты. С помощью этих сведений можно определить, когда и почему почтовый ящик был помещен на карантин. С этим параметром не нужно указывать значение.
В частности этот ключ возвращает значения свойств QuarantineDescription, QuarantineLastCrash и QuarantineEnd в почтовом ящике. Чтобы увидеть эти значения, вам потребуется командлет форматирования. Например, Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeSoftDeletedRecipients
Применимо: Exchange Online
Этот параметр доступен только в облачной службе.
Ключ IncludeSoftDeletedRecipients определяет, следует ли включать в результаты обратимо удаленные почтовые ящики. С этим параметром не нужно указывать значение.
Программно удаленные почтовые ящики — это удаленные почтовые ящики, которые все еще можно восстановить.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NoADLookup
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Ключ NoADLookup указывает, что информация извлекается из базы данных почтовых ящиков, а не из Active Directory. С этим параметром не нужно указывать значение.
Этот ключ помогает повысить производительность командлетов при запросе базы данных почтовых ящиков, содержащей большое количество почтовых ящиков.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Server
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр Server указывает сервер, с которого необходимо получить статистику почтовых ящиков. Можно использовать одно из следующих значений:
- Полное доменное имя (FQDN)
- NetBIOS-имя
Если указать значение параметра Server, команда возвращает статистику по всем почтовым ящикам во всех базах данных, включая базы данных восстановления, на указанном сервере. Если этот параметр не задан, команда возвращает статистику входов в систему для локального сервера.
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Server
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-StoreMailboxIdentity
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр StoreMailboxIdentity указывает идентификатор почтового ящика при использовании с параметром Database для возврата статистики для одного почтового ящика в указанной базе данных. Можно использовать одно из следующих значений:
- MailboxGuid
- LegacyDN
Используйте этот синтаксис для получения сведений об отключенных почтовых ящиках, у которых нет соответствующего объекта Active Directory или который имеет соответствующий объект Active Directory, не указывающий на отключенный почтовый ящик в базе данных почтовых ящиков.
Свойства параметров
| Тип: | StoreMailboxIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Database
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-UseCustomRouting
Применимо: Exchange Online
Этот параметр доступен только в облачной службе.
{{ Fill UseCustomRouting Description }}
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.