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

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

Параметры

-Diagnostic

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

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

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

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

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

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

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

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

-DiagnosticInfo

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

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

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

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

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

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

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

-MRSInstance

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

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

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

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

Тип:Fqdn
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию: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

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