Get-MailboxImportRequest

Модуль:

ExchangePowerShell

Применяется к:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Командлет Get-MailboxImportRequest используется для просмотра подробного состояния текущего запроса на импорт, инициированного с помощью командлета New-MailboxImportRequest.

Этот командлет доступен только в роли экспорта импорта почтовых ящиков, и по умолчанию роль не назначается ни одной группе ролей. Чтобы использовать этот командлет, добавьте роль "Импорт и экспорт почтового ящика" в группу ролей (например, в группу ролей "Управление организацией"). Подробнее см. в разделе Добавление роли в группу ролей.

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

Синтаксис

Get-MailboxImportRequest
   [[-Identity] <MailboxImportRequestIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-MailboxImportRequest
   [-BatchName <String>]
   [-Database <DatabaseIdParameter>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Mailbox <MailboxOrMailUserIdParameter>]
   [-Name <String>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-RequestQueue <DatabaseIdParameter>]
   [<CommonParameters>]

Get-MailboxImportRequest
   [-BatchName <String>]
   [-Database <DatabaseIdParameter>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Mailbox <MailboxLocationIdParameter>]
   [-Name <String>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-RequestQueue <DatabaseIdParameter>]
   [<CommonParameters>]

Описание

Критерии поиска для командлета Get-MailboxImportRequest — это логический оператор And. Если используется несколько параметров, этот оператор сужает область поиска и уменьшает количество результатов.

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

Примеры

Пример 1

Get-MailboxImportRequest -Identity "tony\Recovered"

В этом примере возвращаются сведения по умолчанию, касающиеся состояния текущего запроса на импорт "tony\Recovered". Сведения, получаемые по умолчанию, включают имя, почтовый ящик и состояние.

Пример 2

Get-MailboxImportRequest -Status InProgress -Database DB01

В Exchange Server 2010 г. этот пример возвращает состояние выполняемых запросов на импорт для почтовых ящиков или архивов, находящихся в базе данных DB01.

Пример 3

Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status Completed

В этом примере возвращается состояние выполненных запросов на импорт в пакете ImportingDB1PSTs.

Пример 4

Get-MailboxImportRequest -Name "Recovered" -Suspend $true

В этом примере возвращаются все запросы на импорт с именем Recovered и приостановленным импортом.

Параметры

-BatchName

Параметр BatchName указывает имя, присвоенное пакетному запросу на импорт.

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Database

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

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

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

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

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

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

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-HighPriority

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

Параметр HighPriority фильтрует результаты на основе значения Priority, присвоенного при создании запроса. Для этого параметра допускаются значения $true и $false. Вот как эти значения фильтруют результаты:

• $true Возвращает запросы, созданные со значением Приоритет высокий, Высокий, Высокий или Чрезвычайный.
• $false Возвращает запросы, созданные со значением Приоритета Обычный, Низкий, Нижний или Нижний.

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Параметр Identity используется для указания идентификатора запроса на импорт. По умолчанию запросы на импорт именуются <alias>\MailboxImportX (где X = 0–9). Если указать имя для запроса на импорт, используйте следующий синтаксис: Alias\Name. Майкрософт Exchange автоматически предшествует запросу с псевдонимом почтового ящика.

Этот параметр нельзя использовать совместно с приведенными ниже параметрами.

• BatchName
• Mailbox
• Имя
• Состояние
• Приостановить
• HighPriority

Type:	MailboxImportRequestIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

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

Параметр Mailbox фильтрует результаты по целевому почтовому ящику, в который импортируется содержимое.

В Exchange 2016 CU7 или более поздней версии этот параметр является типом MailboxLocationIdParameter, поэтому самым простым значением, которое можно использовать для идентификации почтового ящика, является значение Alias.

В Exchange 2016 CU6 или более ранней версии этот параметр является типом MailboxOrMailUserIdParameter, поэтому можно использовать любое значение, однозначно определяющее почтовый ящик. Например:

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Домен\Имя пользователя
• Адрес электронной почты
• GUID
• LegacyExchangeDN
• SamAccountName
• Идентификатор пользователя или имя участника-пользователя

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

Type:	MailboxOrMailUserIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013

-Name

Параметр Name указывает, что возвращаются запросы на импорт с указанным именем.

Этот параметр используется для поиска по имени, заданному при создании запроса на импорт. Если при создании запроса имя не указывалось, имя по умолчанию имеет вид MailboxImportX (где X = 0-9).

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RequestQueue

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

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

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

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

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Status

Параметр Status фильтрует результаты по состоянию. Можно использовать следующие значения:

• AutoSuspended
• Завершено
• CompletedWithWarning
• ЗавершениеInProgres
• Не выполнено
• Inprogress
• В очереди
• Повтор
• Suspended
• "Synced" (Синхронизированы);

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

CompletionInProgress и AutoSuspended неприменимы к запросам на импорт и не возвращают какие-либо сведения.

Type:	RequestStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Suspend

Параметр Suspend указывает, следует ли возвращать приостановленные запросы. Для этого параметра допускаются значения $true и $false.

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Input types

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

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

Output types

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