Set-MigrationEndpoint
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет Set-MigrationEndpoint для изменения параметров прямой или промежуточной миграции Exchange, миграций IMAP, миграций Google Workspace (ранее G Suite) и удаленных перемещений.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-MigrationEndpoint
[-Identity] <MigrationEndpointIdParameter>
[-AcceptUntrustedCertificates <Boolean>]
[-ApplicationId <String>]
[-AppSecretKeyVaultUrl <String>]
[-Authentication <AuthenticationMethod>]
[-Confirm]
[-Credentials <PSCredential>]
[-DomainController <Fqdn>]
[-ExchangeServer <String>]
[-MailboxPermission <MigrationMailboxPermission>]
[-MaxConcurrentIncrementalSyncs <Unlimited>]
[-MaxConcurrentMigrations <Unlimited>]
[-NspiServer <String>]
[-Partition <MailboxIdParameter>]
[-Port <Int32>]
[-PublicFolderDatabaseServerLegacyDN <String>]
[-RemoteServer <Fqdn>]
[-RpcProxyServer <Fqdn>]
[-Security <IMAPSecurityMechanism>]
[-ServiceAccountKeyFileData <Byte[]>]
[-SkipVerification]
[-SourceMailboxLegacyDN <String>]
[-TestMailbox <MailboxIdParameter>]
[-WhatIf]
[<CommonParameters>] Описание
Командлет Set-MigrationEndpoint используется для указания параметров разных типов миграций:
- Перемещение между лесами. Перемещение почтовых ящиков между двумя разными локальными лесами Exchange. Перемещение между лесами требует использования конечной точки RemoteMove.
- Удаленное перемещение. В гибридном развертывании удаленное перемещение включает в себя подключение или отключение миграции. Удаленные перемещения требуют использования конечной точки RemoteMove. Подключение перемещает почтовые ящики из локальной организации Exchange в Exchange Online и использует конечную точку RemoteMove в качестве исходной конечной точки пакета миграции. Отключение перемещает почтовые ящики из Exchange Online в локальную организацию Exchange и использует конечную точку RemoteMove в качестве целевой конечной точки пакета миграции.
- Прямая миграция Exchange. Перенос всех почтовых ящиков в локальной организации Exchange в Exchange Online. Для прямой миграции Exchange требуется конечная точка Exchange.
- Поэтапная миграция Exchange. Перенос подмножества почтовых ящиков из локальной организации Exchange в Exchange Online. Для промежуточной миграции Exchange требуется использовать конечную точку Exchange.
- Миграция IMAP. Перенос данных почтовых ящиков из локальной организации Exchange или другой почтовой системы в Exchange Online. Перед осуществлением миграции IMAP необходимо создать облачные почтовые ящики. Миграция IMAP требует использования конечной точки IMAP.
- Миграция Gmail. Перенос данных почтовых ящиков из клиента Google Workspace в Exchange Online. Для миграции Google Workspace необходимо сначала создать облачных почтовых пользователей или почтовые ящики перед переносом данных почтовых ящиков. Для миграции Google Workspace требуется конечная точка Gmail.
- Локальный: перемещение почтовых ящиков между разными серверами или базами данных в одном локальном лесу Exchange. Локальные перемещения не требуют использования конечной точки.
Дополнительные сведения о различных сценариях перемещения и миграции см. в документе:
- Почтовый ящик перемещается в Exchange Server
- Управление перемещением локальных почтовых ящиков в Exchange Server
Изменения, внесенные в конечную точку, которые влияют на отдельных пользователей в пакете, применяются с момента следующей обработки пакета. Если вы используете этот командлет в облачной службе и хотите ускорить применение этих параметров, попробуйте запустить командлет Set-MigrationBatch с параметром -Update.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.comВ этом примере параметры MaxConcurrentIncrementalSyncs изменяются на 50 в конечной точке миграции CutoverExchangeEndpoint01 с использованием NSPI-сервера «Server01».
Пример 2
Set-MigrationEndpoint -Identity Onboardingmigrationendpoint01 -MaxConcurrentMigrations 10 -RemoteServer Server01.contoso.comВ этом примере параметры MaxConcurrentMigrations изменяются на 10 в конечной точке миграции Onboardingmigrationendpoint01 с использованием удаленного сервера «Server01».
Параметры
-AcceptUntrustedCertificates
Этот параметр доступен только в облачной службе.
{{ Fill AcceptUntrustedCertificates Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ApplicationId
Этот параметр доступен только в облачной службе.
{{ Fill ApplicationId Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AppSecretKeyVaultUrl
Этот параметр доступен только в облачной службе.
{{ Fill AppSecretKeyVaultUrl Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Authentication
Этот параметр доступен только в облачной службе.
Параметр Authentication указывает метод проверки подлинности, используемый удаленным почтовым сервером.
| Type: | AuthenticationMethod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Type: | SwitchParameter |
| Aliases: | cf |
| 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 |
-Credentials
Параметр Credentials указывает имя пользователя и пароль для подключения к удаленной конечной точке. Учетные данные следует использовать при создании промежуточной или прямой конечной точки Exchange или конечной точки RemoteMove.
Для значения этого параметра требуется командлет 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-ExchangeServer
Этот параметр доступен только в облачной службе.
Параметр ExchangeServer указывает локальный исходный сервер Exchange Server для прямой и поэтапной миграции. Этот параметр применим только к промежуточным и промежуточным конечным точкам Exchange, которые не используют автообнаружение.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Параметр Identity указывает имя конечной точки миграции, которую необходимо настроить.
| Type: | MigrationEndpointIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MailboxPermission
Этот параметр доступен только в облачной службе.
Параметр MailboxPermission указывает, какие разрешения следует использовать для доступа к исходному почтовому ящику во время входящей миграции OutlookAnywhere (поэтапная миграция Exchange и прямая миграция Exchange). Этот параметр не используется для других миграций (кроме OutlookAnywhere).
У указанной учетной записи должны быть следующие разрешения.
- Разрешение на полный доступ. Учетная запись должна иметь разрешение на полный доступ к почтовым ящикам, которые нужно перенести.
- Разрешение администратора. Учетная запись администратора домена, который может получать доступ к любому почтовому ящику, который нужно перенести.
| Type: | MigrationMailboxPermission |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MaxConcurrentIncrementalSyncs
Параметр MaxConcurrentIncrementalSyncs указывает общее максимальное количество добавочных синхронизаций, разрешенное для этой конечной точки в определенное время. Это значение должно быть меньше или равно параметру MaxConcurrentMigrations.
| Type: | Unlimited |
| 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 |
-MaxConcurrentMigrations
Параметр MaxConcurrentMigrations указывает максимальное количество почтовых ящиков, которое будет перенесено в эту конечную точку в определенное время. Этот параметр применим для всех типов миграции.
| Type: | Unlimited |
| 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 |
-NspiServer
Этот параметр доступен только в облачной службе.
Параметр NspiServer указывает полное доменное имя удаленного NSPI-сервера. Этот параметр применим только к промежуточным и промежуточным конечным точкам Exchange, которые не используют автообнаружение.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Partition
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Port
Этот параметр доступен только в облачной службе.
В случае миграции IMAP параметр Port указывает номер порта TCP, используемого при выполнении миграции для подключения к удаленному серверу.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PublicFolderDatabaseServerLegacyDN
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteServer
Параметр RemoteServer указывает удаленный сервер в зависимости от типа протокола для перемещений:
- Перемещение сервера Exchange. Полное доменное имя сервера Exchange Server с установленной ролью клиентского доступа, массивом серверов клиентского доступа или группой серверов клиентского доступа, расположенных за поддерживаемой подсистемой балансировки нагрузки сети.
- Перемещение IMAP: полное доменное имя IMAP-сервера.
| Type: | Fqdn |
| 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 |
-RpcProxyServer
Этот параметр доступен только в облачной службе.
Для поэтапной миграции Exchange параметр RpcProxyServer указывает полное доменное имя прокси-сервера RPC для локального сервера Exchange. Этот параметр применим только к промежуточным и промежуточным конечным точкам Exchange, которые не используют автообнаружение.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Security
Этот параметр доступен только в облачной службе.
Для миграции IMAP параметр Security указывает метод шифрования, используемый удаленным почтовым сервером. Параметры: Нет, Tls или Ssl.
| Type: | IMAPSecurityMechanism |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ServiceAccountKeyFileData
Этот параметр доступен только в облачной службе.
Параметр ServiceAccountKeyFileData используется для указания сведений, необходимых для проверки подлинности в качестве учетной записи службы. Данные должны поступать из файла ключа JSON, который загружается при создании учетной записи службы, которая была предоставлена доступ к удаленному клиенту.
Допустимое значение для этого параметра требует считывания файла в байтовый объект с использованием следующего синтаксиса: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Эту команду можно использовать в качестве значения параметра или записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную в качестве значения параметра ($data).
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SkipVerification
Параметр SkipVerification пропускает проверку того, доступен ли удаленный сервер при создании конечной точки миграции. Указывать значение для этого параметра необязательно.
| 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, Exchange Online |
-SourceMailboxLegacyDN
Этот параметр доступен только в облачной службе.
Параметр SourceMailboxLegacyDN указывает почтовый ящик на целевом сервере. Используйте LegacyExchangeDN для локального тестового почтового ящика в качестве значения данного параметра. Командлет пытается получить доступ к этому почтовому ящику с использованием учетных данных администратора на целевом сервере.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-TestMailbox
Этот параметр доступен только в облачной службе.
Параметр TestMailbox указывает почтовый ящик на целевом сервере. Используйте основной SMTP-адрес в качестве значения для этого параметра. Командлет пытается получить доступ к этому почтовому ящику с использованием учетных данных администратора на целевом сервере.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| 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 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по