Get-MigrationUser
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Командлет Get-MigrationUser используется для просмотра информации о пользователях перемещений и миграций.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
MailboxGuid
Get-MigrationUser
-MailboxGuid <Guid>
[-DomainController <Fqdn>]
[-IncludeAssociatedUsers]
[-ResultSize <Unlimited>]
[-Partition <MailboxIdParameter>]
[<CommonParameters>]
StatusAndBatchId
Get-MigrationUser
[-BatchId <MigrationBatchIdParameter>]
[-Status <MigrationUserStatus>]
[-StatusSummary <MigrationUserStatusSummary>]
[-DomainController <Fqdn>]
[-IncludeAssociatedUsers]
[-ResultSize <Unlimited>]
[-Partition <MailboxIdParameter>]
[<CommonParameters>]
Identity
Get-MigrationUser
[[-Identity] <MigrationUserIdParameter>]
[-DomainController <Fqdn>]
[-IncludeAssociatedUsers]
[-ResultSize <Unlimited>]
[-Partition <MailboxIdParameter>]
[<CommonParameters>]
EmailAddress
Get-MigrationUser
-EmailAddress <SmtpAddress>
[-DomainController <Fqdn>]
[-IncludeAssociatedUsers]
[-ResultSize <Unlimited>]
[-Partition <MailboxIdParameter>]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-MigrationUser -Identity TonySmith@contoso.com
В этом примере извлекается информация о состоянии недавно перенесенного пользователя Tony Smith.
Пример 2
Get-MigrationUser -MailboxGuid b6a6795c-a010-4f67-aaaa-da372d56fcb9 | Get-MigrationUserStatistics
В этом примере извлекаются более подробные сведения о текущей миграции для пользователя с указанным идентификатором GUID почтового ящика.
Пример 3
Get-MigrationUser -EmailAddress TonySmith@contoso.com
В этом примере извлекается информация о состоянии недавно перенесенного пользователя Tony Smith.
Пример 4
Get-MigrationUser -EmailAddress TonySmith@contoso.com | Get-MigrationUserStatistics
В этом примере извлекаются более подробные сведения о любой текущей миграции для пользователя с указанным адресом электронной почты.
Параметры
-BatchId
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр BatchId указывает имя пакета миграции, для которого необходимо вернуть пользователей.
Свойства параметров
| Тип: | MigrationBatchIdParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
StatusAndBatchId
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EmailAddress
Применимо: Exchange Online
Параметр EmailAddress указывает конкретного пользователя, о котором вы хотите получить сведения. Параметр EmailAddress представлен в виде адреса электронной почты. Этот параметр доступен только в облачной службе.
Свойства параметров
| Тип: | EmailAddress |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
EmailAddress
| Позиция: | Named |
| Обязательный: | True |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр Identity указывает конкретную текущую миграцию, о которой требуется получить сведения. Параметр Identity обычно представляется в виде адреса электронной почты.
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | MigrationUserIdParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
Identity
| Позиция: | 1 |
| Обязательный: | False |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeAssociatedUsers
Применимо: Exchange Online
Этот параметр доступен только в облачной службе.
{{ Fill IncludeAssociatedUsers Description }}
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MailboxGuid
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр MailboxGuid указывает идентификатор GUID почтового ящика, информацию о миграции которого необходимо просмотреть.
Свойства параметров
| Тип: | Guid |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
MailboxGuid
| Позиция: | Named |
| Обязательный: | True |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Partition
Применимо: Exchange Online
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MailboxIdParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Свойства параметров
| Тип: | Unlimited |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Status
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр Status возвращает сведения о пользователях миграции с указанным состоянием. Используйте одно из следующих значений:
- Завершено
- CompletedWithWarnings
- Завершения
- ЗавершениеFailed
- ЗавершениеSynced
- Повреждено
- Не выполнено
- IncrementalFailed
- IncrementalStopped
- IncrementalSynced
- IncrementalSyncing
- Подготовка
- ProvisionUpdating
- В очереди
- Снятие
- Пусковой
- Остановлено
- Зубная пломба
- "Synced" (Синхронизированы);
- Синхронизации
- Идет проверка
Свойства параметров
| Тип: | MigrationUserStatus |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
StatusAndBatchId
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-StatusSummary
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр StatusSummary возвращает краткую информацию о пользователях миграции с указанным значением состояния. Используйте одно из следующих значений:
- Активное
- Завершено
- Не выполнено
- Остановлено
- "Synced" (Синхронизированы);
Свойства параметров
| Тип: | MigrationUserStatusSummary |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
StatusAndBatchId
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входы
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходы
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.