Get-TransportAgent

模組:

Exchange PowerShell

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

使用 Get-TransportAgent Cmdlet 可以檢視傳輸代理程式的組態。

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

語法

Default (預設值)

Get-TransportAgent
    [[-Identity] <TransportAgentObjectId>]
    [-DomainController <Fqdn>]
    [-TransportService <TransportService>]
    [<CommonParameters>]

Description

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

範例

範例 1

Get-TransportAgent

本範例顯示在組織中安裝在 Exchange 伺服器上的所有傳輸代理程式摘要清單。

範例 2

Get-TransportAgent "Transport Rule Agent" -TransportService Hub | Format-List

本範例顯示關於安裝在信箱伺服器上的傳輸服務中的傳輸規則代理程式的詳細資訊。 Get-TransportAgent 命令的輸出會傳送至 Format-List 命令中，以顯示傳輸代理程式的詳細組態。

參數

-DomainController

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

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、Exchange Server SE

Identity 參數可以指定要停用之傳輸代理程式的顯示名稱。 名稱的長度不可超過 64 個字元。

注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。

參數屬性

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

參數集

(All)

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

-TransportService

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

TransportService 參數指定你想要查看或修改的傳輸服務。 此參數的有效值為：

• Hub，用於信箱伺服器上的傳輸服務。
• Hub，用於信箱伺服器上的傳輸服務。
• MailboxSubmission，用於信箱伺服器上的信箱傳輸提交服務。
• MailboxDelivery，用於信箱伺服器上的信箱傳輸傳遞服務。
• FrontEnd，用於信箱伺服器上的前端傳輸服務。

參數屬性

類型:	TransportService
預設值:	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

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