Get-MoveRequest
Этот командлет доступен в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.