Get-MoveRequest

Модуль:

ExchangePowerShell

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

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

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

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

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

Синтаксис

Get-MoveRequest
   [[-Identity] <MoveRequestIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-IncludeSoftDeletedObjects]
   [-ProxyToMailbox <MailboxIdParameter>]
   [<CommonParameters>]

Get-MoveRequest
   [-BatchName <String>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Flags <RequestFlags>]
   [-HighPriority <Boolean>]
   [-IncludeSoftDeletedObjects]
   [-MoveStatus <RequestStatus>]
   [-Offline <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Protect <Boolean>]
   [-ProxyToMailbox <MailboxIdParameter>]
   [-RemoteHostName <Fqdn>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-SourceDatabase <DatabaseIdParameter>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-SuspendWhenReadyToComplete <Boolean>]
   [-TargetDatabase <DatabaseIdParameter>]
   [<CommonParameters>]

Описание

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

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

Примеры

Пример 1

Get-MoveRequest -Identity 'tony@contoso.com'

В этом примере извлекается состояние текущего перемещения почтового ящика для почтового ящика Тони Смита (tony@contoso.com).

Пример 2

Get-MoveRequest -MoveStatus InProgress -TargetDatabase DB05

В этом примере показано получение состояния текущих перемещений почтовых ящиков в целевую базу данных DB05.

Пример 3

Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus CompletedWithWarning

В этом примере показано получение состояния запросов на перемещение в пакете FromDB01ToDB02, который был завершен, но с предупреждениями.

Параметры

-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

-Credential

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

Параметр Credential указывает имя пользователя и пароль, используемые для выполнения этой команды. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

Type:	PSCredential
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

-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

-Flags

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

• CrossOrg
• HighPriority
• IntraOrg
• Присоединиться
• MoveOnlyArchiveMailbox
• MoveOnlyPrimaryMailbox
• Нет
• Автономный режим
• Защищенный
• Подписка по запросу
• Push-уведомление
• RemoteLegacy
• Разделение
• Приостановить
• SuspendWhenReadyToComplete
• TargetIsAggregatedMailbox

Type:	RequestFlags
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, Exchange Online

-HighPriority

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

Параметр HighPriority указывает, что командлет возвращает запросы, созданные с помощью флажка HighPriority. Флажок HighPriority показывает, что запрос должен осуществиться раньше других запросов с более низким приоритетом в очереди.

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

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 идентифицирует запрос на перемещение с помощью идентификатора почтового ящика или пользователя. Можно использовать любое уникальное значение, идентифицирующее почтовый ящик или пользователя почты. Например:

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

Этот параметр можно использовать со следующими параметрами:

• BatchName
• HighPriority
• MoveStatus
• Автономный режим
• Защита
• RemoteHostName
• SourceDatabase
• Приостановить
• SuspendWhenReadyToComplete
• TargetDatabase

Type:	MoveRequestIdParameter
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

-IncludeSoftDeletedObjects

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

Параметр IncludeSoftDeletedObjects указывает, следует ли возвращать обратимо удаленные почтовые ящики. Этот параметр принимает значения $true или $false.

Type:	SwitchParameter
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

-MoveStatus

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

• AutoSuspended
• Завершено
• CompletedWithWarning
• ЗавершениеInProgres
• Не выполнено
• Inprogress
• В очереди
• Повтор
• Suspended

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

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

-Offline

Параметр Offline определяет, нужно ли возвращать почтовые ящики, переведенные в автономный режим. Этот параметр принимает значения $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

-OrganizationalUnit

Параметр OrganizationalUnit фильтрует результаты по расположению объекта в Active Directory. Возвращаются только те объекты, которые существуют в указанном расположении. Допустимые значения для этого параметра — подразделение или домен, которые возвращаются с помощью командлета Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:

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

Type:	OrganizationalUnitIdParameter
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

-Protect

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

Параметр Protect возвращает почтовые ящики, перемещаемые в защищенном режиме. Этот параметр принимает значения $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

-ProxyToMailbox

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

Параметр ProxyToMailbox фильтрует результаты по расположению указанного почтового ящика (также известного как прокси-сервер). Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

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

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteHostName

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

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

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, Exchange Online

-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

-SortBy

Параметр SortBy указывает свойство, по которому необходимо сортировать результаты. Вы можете выполнять сортировку не более, чем по одному свойству одновременно. Результаты будут отсортированы в порядке возрастания.

Если в представлении по умолчанию нет свойства, по которым выполняется сортировка, можно добавить команду с | Format-Table -Auto Property1,Property2,...PropertyXпомощью . , чтобы создать новое представление, содержащее все свойства, которые нужно просмотреть. В именах свойств поддерживаются подстановочные знаки (*).

Можно выполнять сортировку по следующим свойствам:

• Имя
• DisplayName
• Alias (Псевдоним)

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

-SourceDatabase

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

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

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

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

Type:	DatabaseIdParameter
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

-Status

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

Параметр Status фильтрует результаты по состоянию. Допустимые значения:

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

Type:	RequestStatus
Aliases:	MoveStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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

-SuspendWhenReadyToComplete

Параметр SuspendWhenReadytoComplete указывает, следует ли возвращать почтовые ящики, которые были перемещены с помощью команды New-MoveRequest и ее параметра SuspendWhenReadyToComplete. Этот параметр принимает значения $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

-TargetDatabase

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

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

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

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

Type:	DatabaseIdParameter
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

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

Input types

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

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

Output types

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