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)

無限定的值會視為位元組。此參數的有效的輸入範圍是 12147483647 個位元組。如果輸入 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。此參數的有效的輸入範圍是 02147483647 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"