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 необходимо по крайней мере один из следующих параметров: Server, Database или Identity.

С помощью 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 отключенного почтового ящика. Вы также можете использовать LegacyDN.

Пример 7

Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List

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

Пример 8

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
$temp.MoveHistory[0]

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

Пример 9

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv

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

Параметры

-Archive

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

Type:SwitchParameter
Position:Named
Default value:None
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 используется для получения статистики из определенной копии базы данных на указанном сервере.

Параметр MailboxServer указывает сервер почтовых ящиков exExchange2k16 или exExchange2k13, который необходимо протестировать. Этот параметр определяет внутренний сервер, принимающий прокси-подключения от интерфейсного сервера, к которому подключаются клиенты.

  • Имя.
  • полное доменное имя;
  • различающееся имя (DN);
  • Устаревшее различающееся имя Exchange

Устаревшее различающееся имя Exchange

Type:ServerIdParameter
Position:Named
Default value:None
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
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
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 кавычка ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать скобки { }, но только если фильтр не содержит переменные.
  • Свойство является фильтруемым свойством.
  • ComparisonOperator — это оператор сравнения OPath (например, для равного и -eq -like сравнения строк). Дополнительные сведения об операторах сравнения см.в about_Comparison_Operators.
  • Значение — это значение свойства, для поиска. Заключив текстовые значения и переменные в одиночные кавычках ( '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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • Каноническое краткое имя
  • Имя \ пользователя домена
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя
Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
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
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
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 командлет получает статистику только из активных копий базы данных. С помощью параметра IncludePassive командлет возвращает статистику всех активных и пассивных копий базы данных.

Type:SwitchParameter
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-NoADLookup

Этот параметр доступен только в локальной среде Exchange.

Переключатель NoADLookup указывает, что сведения извлекаются из базы данных почтовых ящиков, а не из Active Directory. Это помогает повысить производительность выполнения команды при запросе базы данных почтовых ящиков, содержа которой содержится большое количество почтовых ящиков.

Type:SwitchParameter
Position:Named
Default value:None
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
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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

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

Выходные данные

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