Test-MigrationServerAvailability

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

使用 Test-MigrationServerAvailability Cmdlet 來測試目標伺服器的可用性，以準備執行跨樹系信箱移動、將內部部署信箱移轉至Exchange Online，或將內部部署信箱資料從 IMAP 伺服器移轉至Exchange Online信箱。針對所有移轉類型，Cmdlet 會嘗試驗證用來連線到目標伺服器的連線設定。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

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 或參數所需的權限，請參閱 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 伺服器的連線，以準備將內部部署信箱移轉至 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

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 隨處移轉端點時，您可以進行許可權指派，以測試來源郵件伺服器上使用者信箱的連線。

為 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 Proxy 伺服器的 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 參數會指定遠端郵件伺服器所使用的加密方法。選項為 None、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

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。

共用方式為

Test-MigrationServerAvailability

Syntax

Description

範例

範例 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

輸入

輸出

意見反應

其他資源