Get-MailboxImportRequestStatistics
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут быть эксклюзивными для той или иной среды.
Командлет Get-MailboxImportRequestStatistics позволяет просматривать подробные сведения о запросах на импорт.
Этот командлет доступен только в роли "Импорт и экспорт почтовых ящиков". По умолчанию эта роль не назначена ни одной группе ролей. Чтобы использовать этот командлет, добавьте роль "Импорт и экспорт почтового ящика" в группу ролей (например, в группу ролей "Управление организацией"). Подробнее см. в разделе Добавление роли в группу ролей.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
IdentityOnPremises
Get-MailboxImportRequestStatistics
[-Identity] <MailboxImportRequestIdParameter>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-ReportOnly]
[<CommonParameters>]
IdentityCloud
Get-MailboxImportRequestStatistics
[-Identity] <MailboxImportRequestIdParameter>
[-DiagnosticInfo <String>]
[-IncludeReport]
[-IncludeSkippedItems]
[-ReportOnly]
[<CommonParameters>]
MigrationMRSInstance
Get-MailboxImportRequestStatistics
-MRSInstance <Fqdn>
[-DomainController <Fqdn>]
[-RequestGuid <Guid>]
[<CommonParameters>]
MigrationRequestQueue
Get-MailboxImportRequestStatistics
-RequestQueue <DatabaseIdParameter>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-ReportOnly]
[-RequestGuid <Guid>]
[<CommonParameters>]
Описание
Командлет Get-MailboxImportRequestStatistics можно объединить в конвейер с командлетом Get-MailboxImportRequest.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-MailboxImportRequestStatistics -Identity Tony\MailboxImport1
Этот пример возвращает статистику по умолчанию для второго запроса на импорт для пользователя "Tony Smith". Тип возвращаемых по умолчанию сведений включает имя, почтовый ящик и состояние.
Пример 2
Get-MailboxImportRequestStatistics -Identity Tony\MailboxImport1 | Export-CSV \\SERVER01\ImportRequest_Reports\Tony_Importstats.csv
В этом примере показано, как возвратить подробную статистику по второму запросу на импорт для почтового ящика пользователя Tony Smith и экспортировать отчет в файл CSV.
Пример 3
Get-MailboxImportRequestStatistics -Identity Tony\LegalHold -IncludeReport | Format-List
В этом примере возвращаются дополнительные сведения о запросе на импорт для почтового ящика "Tony Smith" при помощи параметра IncludeReport, а результаты конвейеризуются в команду Format-List.
Пример 4
Get-MailboxImportRequestStatistics -MRSInstance CAS01.contoso.com
В этом примере на сервере Exchange Server 2010 возвращается статистика по умолчанию для запроса на импорт, который был обработан экземпляром MRS, запущенным на сервере CAS01.
Пример 5
Get-MailboxImportRequest -Status Failed | Get-MailboxImportRequestStatistics -IncludeReport | Format-List > AllImportReports.txt
В этом примере возвращаются дополнительные сведения о всех запросах импорта в состоянии Failed с помощью параметра IncludeReport, а затем эти сведения сохраняются в текстовом файле AllImportReports.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 |
MigrationRequestQueue
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
MigrationMRSInstance
| 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 используется для указания идентификатора запроса на импорт. По умолчанию запросы на импорт именованы <alias>\MailboxImportX (где X = 0-9). Если при создании запроса на импорт вы указали имя, используйте следующий синтаксис: Alias\Name.
Примечание. В Exchange Online псевдоним обратимо удаленного почтового ящика может совпадать с псевдонимом активного почтового ящика. Чтобы обеспечить уникальность, используйте значение RequestGuid из вывода командлета Get-MailboxImportRequest в качестве значения этого параметра.
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | MailboxImportRequestIdParameter |
| Значение по умолчанию: | 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 (вместе с параметром RequestQueue) определяет уникальный идентификатор запроса на импорт. Чтобы найти GUID запроса на импорт, используйте командлет Get-MailboxImportRequest.
Имя базы данных
Свойства параметров
| Тип: | 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
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.