Set-ForeignConnector

  • 發行項

 

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

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

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

語法

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

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

詳細描述

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

這個參數指定外部連接器應傳送郵件的目標網域名稱。輸入每個位址空間的完整語法如下：<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   此位址空間類型可能是 SMTP、 X400 或任何其他文字字串。如果略過位址空間類型，則會假設使用 SMTP 位址空間類型。

  • AddressSpace   如果是 SMTP 位址空間類型，則輸入的位址空間必須符合 RFC 1035。例如，允許 *、*.com 及 *.contoso.com，但不允許 *contoso.com。如果是 X.400 位址空間類型，則輸入的位址空間必須符合 RFC 1685 (如 o=MySite;p=MyOrg;a=adatum;c=us)。如果是其他所有值的位址類型，則位址空間可以輸入任何文字。

  • AddressSpaceCost   成本的有效的輸入範圍是 1 到 100。成本愈低表示路由愈好。如果略過位址空間成本，則會假設使用成本 1。如果輸入的非 SMTP 位址空間包含分號字元 (;)，則必須指定位址空間成本。

若指定位址空間類型或位址空間成本，則必須將位址空間以雙引號 ( " ) 括住。例如，下列位址空間項目是同等項目：

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

例如，您可以如下所示，使用逗號來分隔位址空間以指定多個位址空間：contoso.com,fabrikam.com。若指定位址空間類型或位址空間成本，則必須將位址空間以雙引號 (") 括住，如下列範例所示： "contoso.com;2","fabrikam.com;3".

Comment

選用

System.String

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

Confirm

選用

System.Management.Automation.SwitchParameter

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

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。

Force

選用

System.Management.Automation.SwitchParameter

此參數會抑制在特定組態變更期間出現的警告或確認。

Instance

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

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

IsScopedConnector

選用

System.Boolean

此參數控制至其他 Hub Transport Server 之連接器的可用性。此參數的值是 $False 時，Exchange 組織中所有 Hub Transport Server 都可以使用連接器。此參數的值是 $True 時，只有相同 Active Directory 站台的 Hub Transport Server 才能使用連接器。預設值為 $False。

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 的名稱。

WhatIf

選用

System.Management.Automation.SwitchParameter

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

範例

下列程式碼範例顯示兩個使用 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"