Get-MailboxRestoreRequestStatistics

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.

Используйте командлет Get-MailboxRestoreRequestStatistics для просмотра подробных сведений о запросах на восстановление.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

IdentityOnPremises

Get-MailboxRestoreRequestStatistics
    [-Identity] <MailboxRestoreRequestIdParameter>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-IncludeReport]
    [-ReportOnly]
    [<CommonParameters>]

IdentityCloud

Get-MailboxRestoreRequestStatistics
    [-Identity] <MailboxRestoreRequestIdParameter>
    [-IncludeReport]
    [-IncludeSkippedItems]
    [-DiagnosticInfo <String>]
    [-ReportOnly]
    [<CommonParameters>]

MigrationMRSInstance

Get-MailboxRestoreRequestStatistics
    -MRSInstance <Fqdn>
    [-DomainController <Fqdn>]
    [-RequestGuid <Guid>]
    [<CommonParameters>]

MigrationRequestQueue

Get-MailboxRestoreRequestStatistics
    -RequestQueue <DatabaseIdParameter>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-IncludeReport]
    [-ReportOnly]
    [-RequestGuid <Guid>]
    [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-MailboxRestoreRequestStatistics -Identity "Tony\MailboxRestore1"

В этом примере возвращается статистика по умолчанию для запроса на восстановление с идентификатором Tony\MailboxRestore1. Тип возвращаемых по умолчанию сведений включает имя, почтовый ящик, состояние и процент завершения.

Пример 2

Get-MailboxRestoreRequestStatistics -Identity Tony\MailboxRestore | Export-CSV \\SERVER01\RestoreRequest_Reports\Tony_Restorestats.csv

Этот пример возвращает статистику для почтового ящика Тони Смита и экспортирует отчет в CSV-файл.

Пример 3

Get-MailboxRestoreRequestStatistics -Identity Tony\MailboxRestore -IncludeReport | Format-List

В этом примере возвращаются дополнительные сведения о запросе на восстановление почтового ящика Тони Смита с помощью параметра IncludeReport и передачи результатов в команду Format-List.

Пример 4

Get-MailboxRestoreRequestStatistics -MRSInstance CAS01.contoso.com

В Exchange Server 2010 и 2013 годах этот пример возвращает статистику по умолчанию для запроса на восстановление, обрабатываемого экземпляром MRS, запущенным на сервере CAS01. Эта команда возвращает только сведения о запросах на восстановление, которые в настоящее время обрабатываются экземпляром MRS. Если сервер клиентского доступа выполнил все запросы на восстановление, то данные не возвращаются. Эта команда предназначена только для отладки и должна выполняться только по запросу сотрудников службы поддержки.

Пример 5

Get-MailboxRestoreRequest -Status Failed | Get-MailboxRestoreRequestStatistics -IncludeReport | Format-List > C:\Reports\AllRestoreReports.txt

Этот пример возвращает дополнительные сведения для всех запросов на восстановление с состоянием Failed с помощью параметра IncludeReport, а затем сохраняет эти сведения в текстовый файл C:\Reports\AllRestoreReports.txt.

Параметры

-Diagnostic

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

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

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

Обычно этот параметр используется только по запросу службы поддержки пользователей Майкрософт для устранения проблем.

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-DiagnosticArgument

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

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

Параметр DiagnosticArgument изменяет результаты, возвращаемые с помощью параметра Diagnostic. Обычно параметры Diagnostic и DiagnosticArgument используются только по запросу службы поддержки пользователей Майкрософт для устранения проблем.

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-DiagnosticInfo

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

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

Как правило, параметр DiagnosticInfo используется только по запросу Службы поддержки клиентов Майкрософт для устранения неполадок.

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

IdentityCloud
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов: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

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

IdentityOnPremises
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
MigrationMRSInstance
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
MigrationRequestQueue
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 используется для указания идентификатора запроса на восстановление. Параметр Identity состоит из псевдонима почтового ящика, подлежащего восстановлению, и имени, указанного при создании запроса на восстановление. Идентификатор запроса на восстановление использует следующий синтаксис: Alias\Name.

Если вы не указали имя для запроса на восстановление при его создании, Exchange автоматически сгенерировало имя по умолчанию MailboxRestore. Exchange создает до 10 имен, начиная с MailboxRestore, а затем MailboxRestoreX (где X = 1–9).

Этот параметр нельзя использовать с параметрами MRSInstance или RequestQueue.

Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.

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

Тип:MailboxRestoreRequestIdParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-IncludeReport

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

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-IncludeSkippedItems

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

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

{{ Fill IncludeSkippedItems Description }}

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-MRSInstance

Применимо: Exchange Server 2010 г.

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

Параметр MRSInstance указывает полное доменное имя (FQDN) сервера клиентского доступа, на котором находится служба репликации почтовых ящиков Microsoft Exchange (MRS). При использовании этого параметра возвращаются все записи для указанного экземпляра службы.

Этот параметр нельзя использовать с параметрами Identity или RequestQueue.

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

Тип:Fqdn
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ReportOnly

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

Параметр ReportOnly возвращает результаты в виде массива записей отчета (закодированных строк). С этим параметром не нужно указывать значение.

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-RequestGuid

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

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

Параметр RequestGuid указывает уникальный идентификатор запроса на восстановление. Чтобы найти GUID, используйте командлет Get-MailboxRestoreRequest.

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

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-RequestQueue

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

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

Этот параметр предназначен только для отладки.

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

  • имя;
  • различающееся имя (DN);
  • GUID

Имя базы данных

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

Тип:DatabaseIdParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

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

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

Output types

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