Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Командлет Get-MailboxStatistics используется для получения сведений о почтовом ящике, таких как размер почтового ящика, количество находящихся в нем сообщений и время последнего обращения к почтовому ящику. Кроме того, пользователь может получить сведения об истории перемещений или отчет о перемещении по выполненному запросу.

Синтаксис

Get-MailboxStatistics -Identity <GeneralMailboxOrMailUserIdParameter> [-Archive <SwitchParameter>] [-DomainController <Fqdn>] [-IncludeMoveHistory <SwitchParameter>] [-IncludeMoveReport <SwitchParameter>]
Get-MailboxStatistics -Database <DatabaseIdParameter> [-DomainController <Fqdn>]
Get-MailboxStatistics -Server <ServerIdParameter> [-DomainController <Fqdn>]

Параметры

Параметр Обязательный Тип Описание

Database

Обязательный

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Параметр Database указывает имя базы данных почтового ящика. При наличии значения у параметра Database командная консоль Exchange возвращает статистику для всех почтовых ящиков в указанной базе данных.

Ниже приведены значения, которые можно использовать.

  • GUID

  • Server\Database

  • Database

Этот параметр принимает конвейерный ввод от командлета Get-MailboxDatabase.

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.GeneralMailboxOrMailUserIdParameter

Параметр Identity указывает почтовый ящик. Если значение параметра Identity задано, команда находит почтовый ящик, указанный в параметре Identity, подключается к серверу, на котором находится этот почтовый ящик, и возвращает статистику для этого почтового ящика. Можно использовать одно из следующих значений:

  • GUID

  • Различающееся имя (DN)

  • Домен\учетная_запись

  • Имя участника-пользователя

  • Старое различающееся имя Exchange

  • SMTP-адрес

  • Псевдоним

Server

Обязательный

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server указывает сервер, с которого необходимо получить статистику почтовых ящиков. Можно использовать одно из следующих значений:

  • Полное доменное имя (FQDN)

  • имя NetBIOS

Если задано значение параметра Server, команда возвращает статистику для всех почтовых ящиков во всех базах данных заданного сервера, включая базы данных восстановления. Если этот параметр не задан, команда возвращает статистику входов в систему для локального сервера.

Archive

Необязательный

System.Management.Automation.SwitchParameter

Параметр Archive указывает необходимость возврата статистики почтового ящика для архивного ящика, связанного с указанным.

Указывать значение для этого параметра необязательно.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

IncludeMoveHistory

Необязательный

System.Management.Automation.SwitchParameter

Параметр IncludeMoveHistory указывает на необходимость возврата дополнительных сведений о почтовом ящике, в том числе историю выполненных запросов перемещения (состояние, флаги, целевая база данных, поврежденные элементы, время начала и завершения, продолжительность запроса перемещения на различных этапах и коды ошибок).

IncludeMoveReport

Необязательный

System.Management.Automation.SwitchParameter

Параметр IncludeMoveReport указывает на необходимость возвращения подробного отчета о перемещении по выполненному запросу (например, сведений о подключениях сервера и этапах перемещения).

Примечание.
Эта команда выводит подробные сведения, поэтому полученные данные необходимо отправить в файл CSV, что облегчит анализ.

Подробное описание

На серверах почтовых ящиков можно использовать командлет Get-MailboxStatistics без параметров. В этом случае командлет возвращает статистику для всех почтовых ящиков всех баз данных локального сервера.

Примечание.
Для успешной работы командлета Get-MailboxStatistics требуется наличие по крайней мере одного из следующих параметров: Server, Database или Identity.

Командлет Get-MailboxStatistics используется для возвращения подробной истории перемещения и отчета о перемещении по выполненным запросам для диагностики запроса перемещения. Чтобы просмотреть историю перемещений, необходимо передать этот командлет в виде объекта. Сведения о перемещениях хранятся в базе данных почтового ящика и нумеруются последовательно, а последний выполненный запрос перемещения всегда имеет номер 0. Дополнительные сведения см. в примерах 6, 7 и 8 в этом разделе.

Примечание.
Отчеты и историю перемещений можно просматривать только для выполненных запросов перемещения.

Тема «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Примеры

ПРИМЕР 1

В этом примере извлекается статистика для почтового ящика с псевдонимом AylaKol.

Скопировать код 
Get-MailboxStatistics -Identity AylaKol

ПРИМЕР 2

В этом примере происходит получение статистики почтового ящика для всех ящиков на сервере MailboxServer01.

Скопировать код 
Get-MailboxStatistics -Server MailboxServer01

ПРИМЕР 3

В этом примере происходит получение статистики почтового ящика для указанного ящика.

Скопировать код 
Get-MailboxStatistics -Identity contoso\chris

ПРИМЕР 4

В этом примере происходит получение статистики почтового ящика для всех ящиков в указанной базе данных ящиков.

Скопировать код 
Get-MailboxStatistics -Database "Mailbox Database"

ПРИМЕР 5

В этом примере происходит получение статистики почтового ящика для всех отключенных ящиков. В этом примере используется условие WHERE. Переменная $_ используется для указания объекта, переданного в конвейер. Оператор -ne означает неравенство.

Скопировать код 
Get-MailboxStatistics | Where {$_.DisconnectDate -ne $null}

ПРИМЕР 6

В этом примере выполняется получение общей истории перемещений по выполненному запросу для почтового ящика пользователя Ayla Kol. Если полученные данные не передаются командлету Format-List, то история перемещения не отображается.

Скопировать код 
Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List

ПРИМЕР 7

В этом примере выполняется получение подробной истории перемещений по выполненному запросу для почтового ящика пользователя Ayla Kol. Временная переменная используется в примере для хранения объекта статистики почтового ящика. Если почтовый ящик перемещен несколько раз, то для каждого действия будет существовать отдельный отчет. Последним отчетом о перемещении всегда является MoveReport[0].

Скопировать код 
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
$temp.MoveHistory[0]

ПРИМЕР 8

В этом примере выполняется получение подробной истории перемещений и подробного отчета о перемещении для почтового ящика пользователя Ayla Kol. Временная переменная используется в примере для хранения объекта статистики запроса перемещения. Отчет о перемещении выводится в файл CSV.

Скопировать код 
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv