Get-MailboxStatistics

Модуль:

Exchange PowerShell

Этот командлет доступен в локальной среде 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 с использованием связанного псевдонима 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

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online

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

Свойства параметров

Тип:	SwitchParameter
Default value:	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
Default value:	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
Default value:	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
Default value:	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
Default value:	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
Default value:	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
Default value:	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
Default value:	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
Default value:	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
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-IncludeSoftDeletedRecipients

Применимо: Exchange Online

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

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

Обратимо удаленные почтовые ящики — это почтовые ящики, которые по-прежнему можно восстановить.

Свойства параметров

Тип:	SwitchParameter
Default value:	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
Default value:	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
Default value:	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
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

Database

Position:	1
Обязательно:	False
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-UseCustomRouting

Применимо: Exchange Online

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

{{ Fill UseCustomRouting Description }}

Свойства параметров

Тип:	SwitchParameter
Default value:	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

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