共用方式為

Set-ForeignConnector (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-11

使用 Set-ForeignConnector 指令程式，可以修改執行 Microsoft Exchange Server 2007 且已安裝 Hub Transport server role 之電腦上的現有外部連接器。「外部連接器」會使用 Hub Transport Server 上的放置目錄，將郵件傳送至未使用簡易郵件傳送通訊協定 (SMTP) 作為主要傳輸機制的本機郵件伺服器。這些郵件伺服器稱為外部閘道伺服器。協力廠商傳真閘道伺服器是外部閘道伺服器的範例。指派給外部連接器的位址空間可為 SMTP 或非 SMTP。

語法

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Instance <ForeignConnector>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

詳細描述

Set-ForeignConnector 指令程式會修改現有的外部連接器。使用 Set-ForeignConnector 指令程式時，所指定的內容變更會覆寫現有的內容值。

若要執行 Set-ForeignConnector 指令程式，您使用的帳戶必須已獲委派 Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組。

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

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

此參數指定要修改的外部連接器。Identity 參數可以採用外部連接器物件的下列任一個值：

  • GUID

  • 連接器名稱

  • ServerName\ConnectorName

AddressSpaces

選用

Microsoft.Exchange.Data.MultiValuedProperty

這個參數指定外部連接器應傳送郵件的目標網域名稱。您可以使用逗號分隔位址空間來指定多個位址空間，輸入每個位址空間的完整語法如下：

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   如果指定 Local 的值，則只有與您執行 New-SendConnector 指令程式所在的來源 Hub Transport Server 處於相同 Active Directory 站台之其他 Hub Transport Server 可以使用連接器。如果省略 ConnectorScope 限定詞，則整個 Exchange 2007 組織中的所有 Hub Transport Server 都可以使用連接器。

  • AddressSpaceType   如果是 SMTP 位址空間，則此值必須為 SMTP。如果是非 SMTP 位址空間，則此值可以是任一個描述性文字字串 (如 "Lotus Notes")。

  • AddressSpace   如果是 SMTP 位址空間，則可以使用 RFC 1035 中所定義的網域名稱系統 (DNS) 萬用字元 (*) (例如 "*"、"*.com." 或 "*.contoso.com")。如果是非 SMTP 位址空間，則可以使用萬用字元 (*) 及其他字元 (例如 "*contoso.com" 或 "@contoso")。

  • AddressSpaceCost   成本的有效的輸入範圍是 1 到 100。成本愈低表示路由愈好。此參數是選用的。如果您在使用完整語法輸入位址空間時省略 AddressSpaceCost 辨識符號，則會採用成本 1。

只有在下列狀況時，您才必須使用 AddressSpaces 參數的完整語法：

  • 具有 Local 限定詞的範圍連接器

  • 非 SMTP 位址空間

  • 成本不是 1 的 SMTP 位址空間

如果您輸入單一網域名稱或以逗號分隔的網域名稱清單作為 AddressSpaces 參數的值，則每個網域名稱都會採用 SMTP 位址空間類型及成本 1。

Comment

選用

System.String

此參數指定外部連接器的選用備註。您必須用雙引號括住 Comment 參數，如下所示："這是管理的備註事項"。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN)，請加入 DomainController 參數。

DropDirectory

選用

System.String

此參數指定這個外部連接器所使用的放置目錄名稱。所有傳送至此外部連接器所定義之位址空間的輸出郵件，都會放在指定的放置目錄中。每一個外部連接器的放置目錄位置由下列兩個項目控制：

  • Set-TransportServer 指令程式的 RootDropDirectoryPath 參數 這個選項適用於 Hub Transport Server 上的所有外部連接器。RootDropDirectoryPath 參數的值可能是本機路徑，或遠端伺服器的通用命名慣例 (UNC) 路徑。

  • Set-ForeignConnector 指令程式的 DropDirectory 參數 這個值是針對 Hub Transport Server 上存在的每一個外部連接器設定。

RootDropDirectoryPath 參數預設為空白。這表示 RootDropDirectoryPath 的值是 Exchange 2007 安裝資料夾。預設的 Exchange 2007 安裝資料夾是 C:\Program Files\Microsoft\Exchange Server\。DropDirectory 參數的預設值是外部連接器的名稱。

如果 DropDirectory 參數的值不含絕對路徑資訊，則會由 DropDirectory 參數和 RootDropDirectoryPath 參數的組合來定義放置目錄的位置。如果 DropDirectory 參數的值包含絕對路徑資訊，則不可指定 RootDropDirectoryPath 的值。只由 DropDirectory 參數的值來定義放置目錄的位置。

不會為您建立放置目錄。因此，您必須手動建立每一個放置目錄資料夾。

放置目錄必須已獲派下列權限：

  • 網路服務：完全控制

  • 系統：完全控制

  • 系統管理員：完全控制

DropDirectoryQuota

選用

Microsoft.Exchange.Data.Unlimited

此參數指定放置目錄中所有郵件檔案的大小上限。達到指定的值時，除非傳遞並刪除現有的郵件，否則無法將任何新郵件檔案複製至放置目錄。當您輸入 DropDirectoryQuota 參數的值時，請以下列其中一個單位來限定值：

  • B (位元組)

  • KB (KB)

  • MB (MB)

  • GB (GB)

  • TB (TB)

無限定的值會視為位元組。此參數的有效的輸入範圍是 1 到 2147483647 個位元組。如果輸入 unlimited 值，則放置目錄沒有郵件大小限制。預設值為 unlimited。

Enabled

選用

System.Boolean

此參數會啟用或停用外部連接器。有效的輸入值為 $True 或 $False。預設值為 $True。

Instance

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

Instance 參數可讓您將整個物件傳遞至要處理的命令。它主要是用於必須將整個物件傳遞至該命令的指令碼。

MaxMessageSize

選用

Microsoft.Exchange.Data.Unlimited

此參數指定可以通過這個外部連接器的郵件大小上限。當您輸入 MaxMessageSize 參數的值時，請以下列其中一個單位來限定值：

  • B (位元組)

  • KB (KB)

  • MB (MB)

  • GB (GB)

  • TB (TB)

無限定的值會視為 KB。如果輸入 unlimited 值，則此外部連接器沒有郵件大小限制。預設值為 unlimited。此參數的有效的輸入範圍是 0 到 2147483647 KB。如果將 MaxMessageSize 參數的值設為 0，則可有效停用外部連接器。不過，當 Enabled 屬性的值為 $True 時，如果將 MaxMessageSize 參數設為 0，則會產生事件日誌錯誤。停用外部連接器最好的方法是使用 Enabled 參數。

Name

選用

System.String

此參數指定外部連接器的描述性名稱。

RelayDsnRequired

選用

System.Boolean

此參數指定將郵件寫入至放置目錄時，外部連接器是否需要轉送傳遞狀態通知 (DSN)。此參數的有效輸入值為 $True 或 $False。預設值為 $False。

SourceTransportServers

選用

Microsoft.Exchange.Data.MultiValuedProperty

這個參數可指定使用此外部連接器之 Hub Transport Server 的名稱。您可以指定多個 Hub Transport Server，方法是以逗號分隔伺服器名稱。將單一外部連接器置於多個 Hub Transport Server 上，可以在其中一個 Hub Transport Server 失敗時，提供容錯及高可用性。此參數的預設值是第一個安裝這個外部連接器之 Hub Transport Server 的名稱。

範例

下列程式碼範例顯示兩個使用 Set-ForeignConnector 指令程式的範例。

第一個範例顯示的 Set-ForeignConnector 命令，會修改名為 "Contoso Foreign Connector" 的現有外部連接器。此命令會將 MaxMessageSize 參數設為 10 MB。

第二個範例顯示的 Set-ForeignConnector 命令，會修改名為 "Contoso Foreign Connector" 之現有外部連接器所服務的位址空間。位址空間的詳細資料如下：

  • 第一個位址空間：

    • 位址空間類型：SMTP

    • 位址空間："*.contoso.com"

    • 位址空間成本： 1

  • 第二個位址空間：

    • 位址空間類型：Lotus Notes

    • 位址空間："*@domino"

    • 位址空間成本： 55

Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"