共用方式為

Test-SmtpConnectivity

模組:
Exchange PowerShell

內部部署 Exchange 才有提供此 Cmdlet。

使用 Test-SmtpConnectivity 指令程式，以診斷是否已在特定伺服器上順利建立連到接收連接器的 SMTP 連線。 雖然您可以手動執行這個指令程式以驗證指定伺服器的 SMTP 連線，不過主要還是由 Microsoft System Center Operations Manager 2007 用於測試傳輸伺服器在這些伺服器的所有接收連接器上，接收每個繫結的 SMTP 連線的能力。

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

語法

Default (預設值) 

Test-SmtpConnectivity
    [[-Identity] <ServerIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

對 Mailbox server 執行 Test-SmtpConnectivity 指令程式時，指令程式會嘗試對該伺服器上主控的所有接收連接器，建立所有繫結的 SMTP 連線。 針對每次嘗試，指令程式會傳回下列資訊：

  • Server:主控接收連接器的伺服器名稱。
  • ReceiveConnector:嘗試對其建立 SMTP 連線的接收連接器名稱。
  • 繫結:在接收連接器上設定的繫結。
  • EndPoint: 嘗試對其建立 SMTP 連線的實際 IP 位址和連接埠。
  • StatusCode:連線嘗試的結果。 這可能是下列其中一個值：成功、無法連接、暫時性錯誤、永久錯誤、外部錯誤。
  • 詳細資料：從所測試伺服器收到的實際回應。 如果連線嘗試並未成功，這個欄位就會包含錯誤字串。

您可以將輸出管線傳送至 ConvertTo-Html 或 ConvertTo-Csv > <filename> 並將 新增至 命令，將結果寫入檔案。 例如：Test-SmtpConnectivity Mailbox01 | ConvertTo-Csv > "C:\My Documents\SMTP Test.csv"。

您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Test-SmtpConnectivity Mailbox01

此範例會驗證名為 Mailbox01 的 Mailbox server上所有接收連接器的 SMTP 連線。

範例 2

Get-TransportService | Test-SmtpConnectivity

這個範例會驗證組織中，Mailbox Server 上所有接收連接器的 SMTP 連線。

參數

-Confirm

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:cf

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Identity 參數會指定 Cmdlet 驗證 SMTP 連線的傳輸伺服器。

Identity 參數會指定您要驗證 SMTP 連線的傳輸伺服器， (測試指定伺服器) 上的所有接收連接器。 您可以使用唯一識別伺服器的任何值。 例如：

  • Name
  • FQDN
  • 辨別名稱 (DN)
  • Exchange Legacy DN

如果您未使用此參數，則會測試本地伺服器上的所有接收連接器。

參數屬性

類型:ServerIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-MonitoringContext

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

MonitoringContext 參數指定是否要在結果中納入相關的監視事件與效能計數器。 有效值為：

  • $true：命令結果中包含監視事件和性能計數器。 一般而言，當輸出傳遞至 Microsoft System Center Operations Manager (SCOM) 時，您會在結果中包含監視事件和性能計數器。
  • $false：監視事件和性能計數器不會包含在命令結果中。 此值為預設值。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:無線

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Input types

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

輸出

Output types

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