Поделиться через


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

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.