Test-MigrationServerAvailability

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 Test-MigrationServerAvailability cmdlet 测试目标服务器的可用性，以便准备执行跨林邮箱移动、将本地邮箱迁移到Exchange Online或将本地邮箱数据从 IMAP 服务器迁移到Exchange Online邮箱。对于所有迁移类型，cmdlet 会尝试验证用于连接到目标服务器的连接设置。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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 cmdlet 验证是否可以与包含要迁移到基于云的邮箱的邮箱数据的本地邮件服务器通信。运行此 cmdlet 时，必须指定迁移类型。可以指定是与 IMAP 服务器通信还是与 Exchange 服务器通信。

对于 IMAP 迁移，此 cmdlet 使用服务器的完全限定域名 (FQDN) 和端口号来验证连接。如果验证成功，请在使用 New-MigrationBatch cmdlet 创建迁移请求时使用相同的连接设置。

对于 Exchange 迁移，此 cmdlet 使用以下设置之一与本地服务器通信：

对于 Exchange 2003，它将服务器的 FQDN 和凭据用于可访问服务器的管理员帐户。
对于 Exchange Server 2007 及更高版本，可以使用自动发现服务和可访问服务器的管理员帐户的电子邮件地址进行连接。

如果验证成功，则可以使用相同的设置来创建迁移终结点。有关更多信息，请参阅：

New-MigrationEndpoint
New-MigrationBatch

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 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

此示例使用 Autodiscover 和 ExchangeOutlookAnywhere 参数来验证与本地 Exchange 服务器的连接，以便准备将本地邮箱迁移到Exchange Online。可以使用类似的示例来测试分阶段 Exchange 迁移或直接转换 Exchange 迁移的连接设置。

示例 3

$Credentials = Get-Credential

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

此示例验证与运行名为 exch2k3.contoso.com Microsoft Exchange Server 2003 的服务器的连接，并使用 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

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。对于这些 cmdlet，指定不含值的 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 参数指定可以访问目标服务器上的邮箱的帐户的用户名和密码。以 domain\username 格式指定用户名，或者 (UPN user@example.com) () 格式的用户主体名称。

此参数的值需要 Get-Credential cmdlet。要暂停此命令并接收凭据提示，请使用值 (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 cmdlet 将尝试使用迁移终结点中的设置来验证是否能够连接到远程服务器。

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 迁移或直接转换 Exchange 迁移将邮箱迁移到Exchange Online，请使用此开关。

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 服务器的 FQDN。计划执行暂存 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 Outlook 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

此参数仅在基于云的服务中可用。

保留此参数以供 Microsoft 内部使用。

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

-Port

此参数仅在基于云的服务中可用。

Port 参数指定 IMAP 迁移进程用于连接到目标服务器的 TCP 端口号。只有 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 中可用。

保留此参数以供 Microsoft 内部使用。

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

此参数仅在基于云的服务中可用。

保留此参数以供 Microsoft 内部使用。

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

-PublicFolderDatabaseServerLegacyDN

此参数仅在基于云的服务中可用。

保留此参数以供 Microsoft 内部使用。

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 参数指定本地邮件服务器的 FQDN。如果要执行以下迁移类型之一，则需要此参数：

跨林移动
远程移动 (混合部署)
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 参数指定本地 Exchange 服务器的 RPC 代理服务器的 FQDN。不使用自动发现参数时，此参数是必需的。如果计划执行分阶段 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 作为此参数的值。 cmdlet 将尝试使用目标服务器上管理员帐户的凭据访问此邮箱。

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

-TestMailbox

此参数仅在基于云的服务中可用。

TestMailbox 参数指定目标服务器上的一个邮箱。使用主 SMTP 地址作为此参数的值。 cmdlet 将尝试使用目标服务器上管理员帐户的凭据访问此邮箱。

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

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。

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

输入

输出

反馈

反馈

其他资源