Install-TransportAgent

 

適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間: 2007-07-27

使用 Install-TransportAgent 指令程式,在 Microsoft Exchange Server 2007 組織中已安裝 Edge Transport server role 或 Hub Transport server role 的電腦上登錄傳輸代理程式。

語法

Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

詳細描述

Install-TransportAgent 指令程式是用來登錄在 Edge Transport Server 或 Hub Transport Server 上使用的傳輸代理程式。

Caution請注意:
傳輸代理程式對於接觸的所有電子郵件都有完整的存取權。Exchange 對於傳輸代理程式的行為沒有任何限制。不穩定或含有安全性瑕疵的傳輸代理程式,可能會影響到 Exchange 的穩定性與安全性。因此,請務必只安裝您完全信任、並在測試環境中經過完整測試的傳輸代理程式。

若要執行 Install-TransportAgent 指令程式,您使用的帳戶必須已委派下列資格:

  • Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組

若要在已安裝 Edge Transport server role 的電腦上執行 Install-TransportAgent 指令程式,則必須使用屬於該電腦之本機 Administrators 群組成員的帳戶進行登入。

如需管理 Exchange 2007 所需之權限、委派角色以及權利的相關資訊,請參閱權限考量

參數

參數 必要 類型 描述

AssemblyPath

必要

System.String

此參數可以指定傳輸代理程式 Microsoft .NET 組件的位置。不可以使用通用命名慣例 (UNC) 檔案路徑。

Name

必要

System.String

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

TransportAgentFactory

必要

System.String

此參數指定傳輸代理程式 Factory 的 Microsoft .NET 類別類型。要安裝傳輸代理程式的開發人員則會提供傳輸代理程式 Factory 及相關資訊。如需相關資訊,請參閱由傳輸代理程式的開發人員所提供的文件。

Confirm

選用

System.Management.Automation.SwitchParameter

Confirm 參數會使得命令暫停處理,並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN),請在命令中加入 DomainController 參數。執行 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會讀取和寫入至本機 ADAM 執行個體。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

例外狀況

例外狀況 描述

 

範例

下列範例顯示如何將虛構防毒應用程式安裝在 Edge Transport Server 或 Hub Transport Server 上。

Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"

若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.