Test-MigrationServerAvailability

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Используйте командлет Test-MigrationServerAvailability для проверки доступности целевого сервера при подготовке к перемещению почтовых ящиков между лесами, переносу локальных почтовых ящиков в Exchange Online или переносу данных локального почтового ящика с IMAP-сервера в Exchange Online почтовые ящики. Для всех типов миграции командлет пытается проверить параметры подключения, используемые для подключения к целевому серверу.

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

Синтаксис

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Confirm]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-Partition <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-FilePath <String>]
    [-PSTImport]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -ExchangeServer <String>
    -RPCProxyServer <Fqdn>
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-EmailAddress <SmtpAddress>]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-TestMailbox <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolder]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Endpoint <MigrationEndpointIdParameter>
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    -Port <Int32>
    [-Imap]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Security <NIMAPSecurityMechanism]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -ServiceAccountKeyFileData <Byte[]>
    [-Gmail]
    [-EmailAddress <SmtpAddress>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Compliance]
    [-RemoteServer <Fqdn>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolderToUnifiedGroup]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolderToUnifiedGroup]
    [-Authentication <AuthenticationMethod>]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolder]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Командлет Test-MigrationServerAvailability проверяет, можно ли взаимодействовать с локальным почтовым сервером, на котором хранятся данные почтового ящика, которые требуется перенести в облачные почтовые ящики. При выполнении этого командлета необходимо указать тип миграции. Вы можете указать, следует ли взаимодействовать с IMAP-сервером или с сервером Exchange.

Для миграции по протоколу IMAP этот командлет использует полное доменное имя сервера (FQDN) и номер порта для проверки подключения. Если проверка прошла успешно, используйте те же параметры подключения при создании запроса на миграцию с помощью командлета New-MigrationBatch.

При миграции Exchange этот командлет использует один из следующих параметров для взаимодействия с локальным сервером:

В Exchange 2003 используется полное доменное имя сервера и учетные данные для учетной записи администратора, которая может получить доступ к серверу.
Для Exchange Server 2007 и более поздних версий можно подключиться с помощью службы автообнаружения и адреса электронной почты учетной записи администратора, которая может получить доступ к серверу.

Если проверка прошла успешно, можно использовать те же параметры для создания конечной точки миграции. Дополнительные сведения см. в разделе:

New-MigrationEndpoint
New-MigrationBatch

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

Примеры

Пример 1

Test-MigrationServerAvailability -Imap -RemoteServer imap.contoso.com -Port 143

При миграции IMAP в этом примере проверяется подключение к почтовому серверу IMAP imap.contoso.com.

Пример 2

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

В этом примере используются параметры автообнаружения и ExchangeOutlookAnywhere для проверки подключения к локальному серверу Exchange Server при подготовке к переносу локальных почтовых ящиков в Exchange Online. Аналогичный пример можно использовать для проверки параметров подключения для поэтапной миграции Exchange или прямой миграции Exchange.

Пример 3

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -ExchangeServer exch2k3.contoso.com -Credentials $Credentials -RPCProxyServer mail.contoso.com -Authentication NTLM

В этом примере проверяется подключение к серверу под управлением Microsoft Exchange Server 2003 с именем exch2k3.contoso.com и используется NTLM для метода проверки подлинности.

Пример 4

Test-MigrationServerAvailability -Endpoint endpoint.contoso.com

В этом примере проверяются параметры подключения к удаленному серверу с помощью параметров, хранящихся в существующей конечной точке миграции в Exchange Online.

Пример 5

$MRSEndpoints = (Get-MigrationEndpoint).Identity

Foreach ($MEP in $MRSEndpoints) {Test-MigrationServerAvailability -Endpoint $MEP}

В этом примере проверяется несколько существующих конечных точек.

Параметры

-AcceptUntrustedCertificates

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

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

-Authentication

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

Параметр Authentication указывает метод проверки подлинности, используемый на локальном почтовом сервере. Используйте базовый или NTLM. Если этот параметр не включен, используется метод аутентификации Basic.

Параметр используется только для прямой миграции Exchange и промежуточной миграции Exchange.

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

-Autodiscover

Параметр автообнаружения указывает, что команда должна использовать службу автообнаружения для получения параметров подключения для целевого сервера. Для этого переключателя не требуется указывать значение.

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

-Compliance

Параметр Соответствие указывает, что тип конечной точки соответствует требованиям. Указывать значение для этого параметра необязательно.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, 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 указывает имя пользователя и пароль для учетной записи, которая может получить доступ к почтовым ящикам на целевом сервере. Укажите имя пользователя в формате домен\имя пользователя или имя участника-пользователя (UPN) (user@example.com).

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

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

-EmailAddress

Параметр EmailAddress указывает адрес электронной почты учетной записи администратора, которая может получать доступ к удаленному серверу. Этот параметр является обязательным при использовании параметра автообнаружения.

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

-Endpoint

Параметр Endpoint указывает имя конечной точки миграции для подключения. Конечная точка миграции содержит параметры подключения и другие параметры конфигурации миграции. Если этот параметр включен, командлет Test-MigrationServerAvailability пытается проверить возможность подключения к удаленному серверу с помощью параметров в конечной точке миграции.

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

-ExchangeOutlookAnywhere

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

Параметр ExchangeOutlookAnywhere указывает тип миграции для переноса локальных почтовых ящиков в Exchange Online. Указывать значение для этого параметра необязательно.

Используйте этот параметр, если вы планируете перенести почтовые ящики в Exchange Online с помощью поэтапной миграции Exchange или прямой миграции Exchange.

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

-ExchangeRemoteMove

Параметр ExchangeRemoteMove указывает тип миграции, в котором почтовые ящики перемещаются с полной точностью между двумя локальными лесами или между локальным лесом и Exchange Online. Указывать значение для этого параметра необязательно.

Используйте этот параметр, если вы планируете перемещать или переносить почтовые ящики между локальной организацией Exchange и Exchange Online в гибридном развертывании.

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

-ExchangeServer

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

Параметр ExchangeServer указывает полное доменное имя локального сервера Exchange Server. Используйте этот параметр, когда планируете выполнить поэтапную миграцию Exchange или прямую миграцию Exchange. Этот параметр является обязательным, если параметр автообнаружения не используется.

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

-FilePath

Параметр FilePath указывает путь, содержащий PST-файлы при тестировании конечной точки миграции импорта PST.

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

-Gmail

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

Параметр Gmail указывает Gmail в качестве типа миграции. Указывать значение для этого параметра необязательно.

Этот параметр необходим, если требуется перенести данные из клиента Google Workspace (ранее G Suite) в Exchange Online почтовые ящики.

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

-Imap

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

Параметр Imap указывает тип миграции IMAP. Указывать значение для этого параметра необязательно.

Этот параметр необходим, если требуется перенести данные с почтового сервера IMAP в Exchange Online почтовые ящики.

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

-MailboxPermission

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

Параметр MailboxPermission указывает, какие разрешения назначаются учетной записи администратора миграции, определенной параметром Credentials. Назначение разрешений выполняется для проверки подключения к почтовому ящику пользователя на исходном почтовом сервере при тестировании параметров подключения при подготовке к поэтапной или прямой миграции Exchange или созданию конечной точки миграции Exchange Anywhere.

Укажите одно из следующих значений для учетной записи, определенной параметром Credentials:

FullAccess. Учетной записи назначено разрешение на Full-Access почтовым ящикам, которые будут перенесены.
Администратор. Учетная запись входит в группу администраторов домена в организации, где размещаются почтовые ящики, которые будут перенесены.

Этот параметр не используется для проверки подключения к удаленному серверу для удаленной миграции или миграции по протоколу IMAP.

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

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

Параметр Port указывает номер TCP-порта, используемый процессом миграции IMAP для подключения к целевому серверу. Этот параметр требуется только для миграций IMAP.

Стандартом является использование порта 143 для незашифрованных подключений, порта 143 для tls и порта 993 для ssl.

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

-PSTImport

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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-PublicFolder

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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-PublicFolderDatabaseServerLegacyDN

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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-PublicFolderToUnifiedGroup

Параметр PublicFolderToUnifiedGroup указывает, что тип конечной точки является общедоступными папками для Группы Microsoft 365. Указывать значение для этого параметра необязательно.

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

-RemoteServer

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

Перемещение между лесами
Удаленное перемещение (гибридные развертывания)
Миграция IMAP

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

-RPCProxyServer

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

Параметр RPCProxyServer указывает полное доменное имя прокси-сервера RPC для локального сервера Exchange. Этот параметр является обязательным, если параметр автообнаружения не используется. Используйте этот параметр, если планируется выполнить поэтапную миграцию Exchange или прямую миграцию Exchange для переноса почтовых ящиков в Exchange Online.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourceMailboxLegacyDN

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

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

Type:	String
Position:	Named
Default value:	None
Required:	True
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

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

Поделиться через

Test-MigrationServerAvailability

Синтаксис

Описание

Примеры

Пример 1

Пример 2

Пример 3

Пример 4

Пример 5

Параметры

-AcceptUntrustedCertificates

-Authentication

-Autodiscover

-Compliance

-Confirm

-Credentials

-EmailAddress

-Endpoint

-ExchangeOutlookAnywhere

-ExchangeRemoteMove

-ExchangeServer

-FilePath

-Gmail

-Imap

-MailboxPermission

-Partition

-Port

-PSTImport

-PublicFolder

-PublicFolderDatabaseServerLegacyDN

-PublicFolderToUnifiedGroup

-RemoteServer

-RPCProxyServer

-Security

-ServiceAccountKeyFileData

-SourceMailboxLegacyDN

-TestMailbox

-WhatIf

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

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

Обратная связь

Дополнительные ресурсы