Set-SendConnector (RTM)

  • 發行項

 

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

上次修改主題的時間： 2007-08-27

使用 Set-SendConnector 指令程式可在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上修改傳送連接器。

語法

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Instance <SmtpSendConnectorConfig>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

詳細描述

Set-SendConnector 指令程式會修改現有的傳送連接器。執行 Set-SendConnector 指令程式時需要 Name 參數。僅有在修改 Name 參數值時，才需要 Identity 參數。

完成此工作後，即已修改傳送連接器。

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

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

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

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter

Identity 參數指定代表您想要修改之傳送連接器的 GUID 或連接器名稱。

AddressSpaces

選用

Microsoft.Exchange.Data.MultiValuedProperty

除非此連接器連結到接收連接器，否則需要此參數。如果是使用 LinkedReceiveConnector 參數指定連結的接收連接器，則 AddressSpaces 的值必須為 $null。否則，AddressSpaces 參數會指定傳送連接器傳送郵件的目標網域名稱。您可以使用逗號分隔位址空間來指定多個位址空間，輸入每個位址空間的完整語法如下：

<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。Edge Transport Server 上設定的傳送連接器只支援 SMTP 位址空間。Hub Transport Server 上設定的傳送連接器則支援 SMTP 及非 SMTP 位址空間。

AuthenticationCredential

選用

System.Management.Automation.PSCredential

此參數需要建立及傳遞認證物件。此認證物件是使用 Get-Credential 指令程式來建立。如需 Get-Credential 指令程式的相關資訊，請在 Exchange 管理命令介面中輸入 Get-Help Get-Credential。

Comment

選用

System.String

您必須以雙引號括住 Comment 參數，例如： "this is an admin note".

ConnectionInactivityTimeOut

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

此參數指定閒置連線可維持開啟的時間上限。預設值是 10 分鐘。若要指定值，請輸入時間範圍格式：dd.hh:mm:ss，其中 d = 天數、h = 小時數、m = 分鐘數，s = 秒數。此參數的有效輸入範圍為 00:00:01 到 1.00:00:00。

DNSRoutingEnabled

選用

System.Boolean

此參數指定應使用網域名稱系統 (DNS) 路由，或應透過使用 SmartHosts 參數設定的智慧主機來傳送所有郵件。預設值為 $True。若要將值設為 $False，必須先設定 SmartHosts 參數的值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

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

DomainSecureEnabled

選用

System.Boolean

此參數適用於為此傳送連接器所服務的網域啟用相互傳輸層安全性 (TLS) 驗證的過程。只有在符合下列條件時，相互 TLS 驗證才會正確運作：

  • DomainSecureEnabled 參數的值必須為 $True。
  • DNSRoutingEnabled 參數的值必須為 $True。
  • IgnoreStartTLS 參數的值必須為 $False。

萬用字元 (*) 在已設定為交互 TLS 驗證的網域中不受支援。相同的網域也必須定義在對應的接收連接器上，以及 Get-TransportConfig 指令程式的 TLSReceiveDomainSecureList 參數值中。

下列類型之傳送連接器的 DomainSecureEnabled 預設值為 $False：

  • Hub Transport Server 上定義的所有傳送連接器。
  • Edge Transport Server 上定義之使用者建立的傳送連接器。

下列類型之傳送連接器的 DomainSecureEnabled 預設值為 $True：

  • Edge Transport Server 上定義的預設傳送連接器。

Enabled

選用

System.Boolean

此參數的有效輸入為 $True 或 $False。預設值為 $True。使用 Enabled 參數可啟用或停用連接器處理電子郵件的能力。

Force

選用

System.Management.Automation.SwitchParameter

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

ForceHELO

選用

System.Boolean

此參數的有效輸入為 $True 或 $False。預設值為 $False。預設會使用 EHLO。若此參數設為 $True，則會傳送 HELO 而非 EHLO。

Fqdn

選用

Microsoft.Exchange.Data.Fqdn

此參數指定作為所連接的郵件伺服器的來源伺服器的 FQDN，這些郵件伺服器使用傳送連接器來接收外寄郵件。每當需要來源伺服器名稱時，此參數的值會顯示給連接的郵件伺服器，如下列範例所示：

  • 在傳送連接器與下一個躍點郵件伺服器通訊時的 EHLO/HELO 命令中
  • 在郵件離開 Hub Transport Server 或 Edge Transport Server 之後，下一個躍點郵件伺服器新增至郵件的郵件最新 Received: 標頭欄位中
  • 在 TLS 驗證期間

Fqdn 參數的預設值是 $Null。這表示實際預設 FQDN 值是包含傳送連接器的 Hub Transport Server 或 Edge Transport Server 的 FQDN。

note附註：
如果在同時安裝 Mailbox server role 的 Hub Transport Server 上設定傳送連接器，則不會使用指定給 Fqdn 參數的任何值。而是一律使用利用 Get-ExchangeServer 指令程式所顯示的伺服器 FQDN。
針對同時安裝 Hub Transport server role 及 Mailbox server role 的伺服器，則從外寄郵件 Received: 標頭移除伺服器名稱的唯一方式是使用 Remove-ADPermission 指令程式，從使用連接器之安全性主體移除 Ms-Exch-Send-Headers-Routing 權限。此動作會在郵件離開 Hub Transport Server 時，移除郵件的所有 Received: 標頭。因為 Received: 標頭是用於進行最大躍點計數計算，建議您不要移除內部郵件的 Received: 標頭。如需 Remove-ADPermission 指令程式及 Get-ExchangeServer 指令程式的相關資訊，請參閱下列主題：
• Remove-ADPermission (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

選用

System.Boolean

此參數的有效輸入為 $True 或 $False。此參數指定是否忽略遠端傳送伺服器提供的 StartTLS 選項。此參數是與遠端網域搭配使用。如果 RequireTLS 參數設為 $True，則此參數必須設為 $False。根據預設，DNSRoutingEnabled 參數值設為 $True 的傳送連接器，其 IgnoreStartTLS 參數值也會設為 $False。這表示，如果 TLS 是由接收伺服器所提供，則傳送連接器一律會交涉 TLS。如果將 IgnoreStartTLS 參數值設為 $True，則傳送連接器絕不會嘗試向接收伺服器交涉 TLS。

Instance

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

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

LinkedReceiveConnector

選用

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

此參數會將指定的接收連接器所接收的所有郵件強制透過此傳送連接器送出。LinkedReceivedConnector 的值可使用下列任何一個識別碼指定接收連接器：

  • GUID
  • 辨別名稱 (DN)
  • Servername\ConnectorName

搭配使用 LinkReceiveConnector 參數與 Set-SendConnector 指令程式時，也必須使用具有指定值的下列參數：

  • AddressSpaces $null
  • DNSRoutingEnabled $False
  • MaxMessageSize unlimited
  • Smarthosts <SmarthostID>
  • SmarthostAuthMechanism <AuthMechanism>

MaxMessageSize

選用

Microsoft.Exchange.Data.Unlimited

此參數指定可通過連接器之郵件的大小上限。預設值為 10MB。當您輸入值時，請以下列其中一個單位來限定值：

  • B (位元組)
  • KB (KB)
  • MB (MB)
  • GB (GB)

無限定的值會視為位元組。此參數的有效的輸入範圍是 0 到 2147483647 個位元組。若要移除傳送連接器上的郵件大小限制，請輸入 unlimited 的值。

Name

選用

System.String

Name 參數是系統管理員提供的連接器名稱。如果名稱含有空格，則必須用雙引號括住 Name 參數，如以下範例所示： "New Send Connector".

Port

選用

System.Int32

此參數的有效的輸入範圍是 0 到 65535 間的整數。預設值為 25。如果指定 SmartHosts 參數的值，Port 值便可指定用於智慧主機轉寄的通訊埠號碼。在大多數的組織中，通訊埠號碼是設定為 25。

ProtocolLoggingLevel

選用

Microsoft.Exchange.Data.ProtocolLoggingLevel

此參數會啟用或停用所指定傳送連接器的通訊協定記錄。值 Verbose 會啟用連接器的通訊協定記錄。值 None 會停用連接器的通訊協定記錄。預設值為 None。使用 Set-TransportServer 命令的 SendProtocolLogPath 參數，可以為 Hub Transport Server 或 Edge Transport Server 上設定的所有傳送連接器，指定傳送連接器通訊協定記錄位置。

RequireTLS

選用

System.Boolean

此參數指定是否必須使用 TLS 傳輸所有透過此連接器傳送的郵件。預設值為 $False。

SmartHostAuthMechanism

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms

在與遠端伺服器驗證期間會使用此參數。只有在設定了智慧主機且 DNSRoutingEnabled 參數設為 $False 時，才使用此參數。有效值為 None、BasicAuth、BasicAuthRequireTLS、ExchangeServer 或 ExternalAuthoritative。所有的值彼此互斥。如果您選取 BasicAuth 或 BasicAuthRequireTLS，必須使用 AuthenticationCredential 參數指定驗證認證。

SmartHosts

選用

Microsoft.Exchange.Data.MultiValuedProperty

此參數使用一或多個 FQDN (如 server.contoso.com)，或者一或多個 IP 位址，其間以逗號來分隔。如果輸入 IP 位址，必須輸入文字的 IP 位址，如以下範例所示：10.10.1.1。智慧主機身分可以是智慧主機伺服器的 FQDN、郵件交換 (MX) 記錄或位址 (A) 記錄。如果將 FQDN 設定為智慧主機身分，則傳送連接器的來源伺服器必須能夠使用 DNS 名稱解析來尋找智慧主機伺服器。

SourceIPAddress

選用

System.Net.IPAddress

這個參數會指定本機 IP 位址，當作 SMTP 連接到遠端郵件伺服器的端點。預設的 IP 位址為 0.0.0.0。這個值會告訴伺服器使用任何可用的本機 IP 位址。這個參數只能用於已在 Edge Transport Server 上設定的傳送連接器。

SourceTransportServers

選用

Microsoft.Exchange.Data.MultiValuedProperty

這個參數會指定可使用此傳送連接器之 Hub Transport Server 的名稱。您可以用逗點區隔各個名稱，即可指定多個 Transport Server 的名稱。這個參數無法用於已在 Edge Transport Server 上設定的傳送連接器。

UseExternalDNSServersEnabled

選用

System.Boolean

此參數指定此傳送連接器是否應該使用以 Set-TransportServer 指令程式的 ExternalDNSServers 參數來指定的外部 DNS 清單。預設值為 $False。此參數的有效值為 $True 及 $False。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

範例

第一個程式碼範例顯示會修改現有傳送連接器的 Set-SendConnector 命令。此命令會將 MaxMessageSize 限制設為 10 MB，並將 ConnectionInactivityTimeOut 設為 15 分鐘。

第二個範例顯示的命令會修改現有傳送連接器，以在傳送連接器將電子郵件傳送至 Contoso.com 時使用驗證。本機 Exchange Server 2007 伺服器必須先通過 Contoso.com 電子郵件伺服器的驗證，然後才能提交電子郵件。若要設定傳送連接器使用驗證，必須先執行 Get-Credential 命令，並將命令指派給變數。執行 Get-Credential 命令時，此命令會詢問與 Contoso.com 電子郵件伺服器驗證期間要使用之帳戶的使用者名稱及密碼。

在範例中，Get-Credential 命令會指派給 $CredentialObject 變數。驗證認證指派給 $CredentialObject 變數後，可使用 Set-SendConnector 指令程式來修改傳送連接器。$CredentialObject 變數會傳遞至 AuthenticationCredential 參數。除了設定要使用的認證之外，還必須將 SmartHostAuthMechanism 參數設為 BasicAuth，指示傳送連接器使用提供的認證向 Contoso.com 電子郵件伺服器進行驗證。

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00 
$CredentialObject = Get-Credential
Set-SendConnector "E-Mail to Contoso.com" -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth

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