New-ReceiveConnector (RTM)

 

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

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

您可以使用 New-ReceiveConnector 指令程式,在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上建立新的接收連接器。

語法

New-ReceiveConnector -Name <String> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-Server <ServerIdParameter>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internet | Internal | Client | Partner>]

詳細描述

New-ReceiveConnector 指令程式會建立新的接收連接器。若要提示新接收連接器的必要參數,請輸入 New-ReceiveConnectorNameBindingsRemoteIPRanges 參數都是新接收連接器的必要參數。

完成此工作之後,即會建立接收連接器。

若要執行 New-ReceiveConnector 指令程式,必須對您使用的帳戶委派下列項目:

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

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

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

參數

參數 必要 類型 描述

Name

必要

System.String

此參數指定系統管理員提供的連接器名稱。請如下所示以字串形式輸入 Name 參數,例如: "New Receive Connector".

AuthMechanism

選用

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

此參數指定已通告及接受的驗證機制。驗證選項有 NoneTLSIntegratedBasicAuthBasicAuthRequireTLSExchangeServerExternalAuthoritative。您可以用逗號隔開值,以輸入 AuthMechanism 參數的多個值。如果 RequireTLS 參數設為 $true,則 AuthMechanism 參數必須設為 TLS。如果將 AuthMechanism 參數設為 BasicAuthRequireTLS,則也必須選取 BasicAuthTLSAuthMechanism 參數值 ExternalAuthoritative 只可以與值 TLS 共存。如果將 AuthMechanism 參數設為 ExternaAuthoritative,則 PermissionGroups 參數的值也必須為 ExchangeServers

Banner

選用

System.String

此參數會覆寫預設的簡易郵件傳送通訊協定 (SMTP) 220 橫幅。Banner 參數的值為空白時,預設 SMTP 橫幅如下:

220 <Servername> Microsoft ESMTP MAIL service ready at <RegionalDay-Date-24HourTimeFormat> <RegionalTimeZoneOffset>

指定 Banner 參數的值時,必須使用下列語法:

"220 <RemainingBannerText>".

220 是 RFC 2821 中所定義的預設「服務就緒」SMTP 回應碼。

BinaryMimeEnabled

選用

System.Boolean

此參數的有效值為 $True$False。預設值為 $True。當 BinaryMimeEnabled 參數設為 $True 時,BINARYMIME EHLO 關鍵字會在 EHLO 回應中通告給遠端伺服器,且可供使用。當 BinaryMimeEnabled 參數設為 $False 時,BINARYMIME EHLO 關鍵字不會在 EHLO 回應中通告給遠端伺服器,且會停用。

Bindings

選用

Microsoft.Exchange.Data.MultiValuedProperty

這個參數指定接收連接器用於接聽輸入郵件的本機 IP 位址和 TCP 通訊埠號碼。此參數的有效語法為 <IP Address>:<TCP Port>,例如 192.168.1.1:25。IP 位址 0.0.0.0 表示接收連接器使用所有網路介面卡上設定的所有 IP 位址,來接聽輸入郵件。

note附註:
您必須指定接收連接器所在之 Hub Transport Server 或 Edge Transport Server 的有效本機 IP 位址。如果指定無效的本機 IP 位址,則在重新啟動服務時,Microsoft Exchange Transport 服務可能無法啟動。若要指定所有網路介面卡上設定的所有 IP 位址,可以使用 IP 位址 0.0.0.0

您使用 Bindings 參數指定的值,必須滿足下列其中一個獨特性要求:

  • 您可以指定 IP 位址和 TCP 通訊埠的唯一組合,此組合必須與伺服器上另一個接收連接器之 Bindings 參數中使用的 IP 位址或 TCP 通訊埠沒有衝突。
  • 您可以使用現有的 IP 位址和 TCP 通訊埠組合,但是使用 RemoteIPRanges 參數限制接收連接器所服務的遠端伺服器。

如果為 Usage 參數指定了下列值,您就必須指定 Bindings 參數的值:

  • Internet
  • Custom

ChunkingEnabled

選用

System.Boolean

此參數的有效輸入為 $True$False。預設值為 $True。當 ChunkingEnabled 參數設為 $True 時,CHUNKING EHLO 關鍵字會在 EHLO 回應中通告給遠端伺服器,且可供使用。當 ChunkingEnabled 參數設為 $False 時,CHUNKING EHLO 關鍵字不會在 EHLO 回應中通告給遠端伺服器,且會停用。

Comment

選用

System.String

您必須用雙引號括住 Comment 參數,如下所示,例如: "this is an admin note".

ConnectionInactivityTimeout

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

此參數指定關閉接收連接器的連線之前,最長的閒置時間。Hub Transport Server 上所設定之接收連接器的預設值是 5 分鐘。Edge Transport Server 上所設定之接收連接器的預設值是 1 分鐘。若要指定值,請輸入時間範圍格式:dd.hh:mm:ss,其中 d = 天數、h = 小時數、m = 分鐘數,s = 秒數。ConnectionTimeout 參數所指定的值必須大於 ConnectionInactivityTimeout 參數所指定的值。上述任一參數的有效的輸入範圍是 00:00:011.00:00:00

ConnectionTimeOut

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

此參數指定即使連線正在主動傳輸資料,該連線還可保留開啟狀態的時間上限。Hub Transport Server 上所設定之接收連接器的預設值是 10 分鐘。Edge Transport Server 上所設定之接收連接器的預設值是 5 分鐘。若要指定值,請輸入時間範圍格式:dd.hh:mm:ss,其中 d = 天數、h = 小時數、m = 分鐘數,s = 秒數。ConnectionTimeout 參數所指定的值必須大於 ConnectionInactivityTimeout 參數所指定的值。上述任一參數的有效的輸入範圍是 00:00:011.00:00:00

DefaultDomain

選用

Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter

此參數指定在未提供網域名稱時,要附加至由傳送伺服器提交給郵件信封中之 MAIL FROM:RCPT TO: 值的網域名稱。

DeliveryStatusNotificationEnabled

選用

System.Boolean

此參數的有效值為 $True$False。預設值為 $True。當 DeliveryStatusNotificationEnabled 參數設為 $True 時,DSN EHLO 關鍵字會在 EHLO 回應中通告給遠端伺服器,且可供使用。當 DeliveryStatusNotificationEnabled 參數設為 $False 時,DSN EHLO 關鍵字不會在 EHLO 回應中通告給遠端伺服器,且會停用。ESMTP 的 DSN 延伸模組提供了在 RFC 1891 指定的加強型傳遞狀態通知功能。

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
  • AuthMechanism 參數包含值 TLS,而未包含值 ExternalAuthoritative
  • AuthMechanism 參數的值包含 TLS
  • Get-TransportConfig 指令程式中的 TLSReceiveDomainSecureList 參數至少會包含一個由此接收連接器所服務的網域。萬用字元 (*) 在已設定為交互 TLS 驗證的網域中不受支援。對應的傳送連接器上及 Get-TransportConfig 指令程式之 TLSSendDomainSecureList 參數的值中也必須定義相同網域。

下列接收連接器類型的 DomainSecureEnabled 預設值為 $False

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

針對 Edge Transport Server 上定義的預設接收連接器,DomainSecureEnabled 的預設值是 $True

EightBitMimeEnabled

選用

System.Boolean

此參數的有效值為 $True$False。預設值為 $True。當 EightBitMimeEnabled 參數設為 $True 時,8BITMIME EHLO 關鍵字會在 EHLO 回應中通告給遠端伺服器,且可供使用。當 EightBitMimeEnabled 參數設為 $False 時,8BITMIME EHLO 關鍵字不會在 EHLO 回應中通告給遠端伺服器,且會停用。

Enabled

選用

System.Boolean

此參數的有效值為 $True$False。預設值為 $True。使用 Enabled 參數可啟用或停用連接器。

EnhancedStatusCodesEnabled

選用

System.Boolean

此參數的有效值為 $True$False。預設值為 $True。當 EnhancedStatusCodesEnabled 參數設為 $True 時,ENHANCEDSTATUSCODES EHLO 關鍵字會在 EHLO 回應中通告給遠端伺服器,且可供使用。當 EnhancedStatusCodesEnabled 參數設為 $False 時,ENHANCEDSTATUSCODES EHLO 關鍵字不會在 EHLO 回應中通告給遠端伺服器,且會停用。ENHANCEDSTATUSCODES 延伸模組在傳送至遠端伺服器的傳遞狀態通知 (DSN) 中提供了加強型錯誤及狀態資訊。

Fqdn

選用

Microsoft.Exchange.Data.Fqdn

這個參數指定一個 FQDN,這個 FQDN 作為使用接收連接器來傳送內送郵件之已連接郵件伺服器的目標伺服器。任何時候需要目標伺服器名稱時,系統就會向連接的郵件伺服器顯示這個參數的值,如以下範例所示:

  • 在接收連接器的預設 SMTP 橫幅中
  • 在接收連接器的 EHLO/HELO 回應中
  • 在郵件進入 Hub Transport Server 或 Edge Transport Server 時之內送郵件的最新 Received: 標頭欄位
  • 在傳輸層安全性 (TLS) 驗證期間

Fqdn 參數的預設值,是包含接收連接器之 Hub Transport Server 或 Edge Transport Server 的 FQDN。

note附註:
請勿修改自動建立於 Hub Transport Server 上,名為「Default <Server Name>」之預設接收連接器的 FQDN 值。如果 Exchange 組織中有多個 Hub Transport Server,而且變更了「Default <Server Name>」之接收連接器的 FQDN 值,則 Hub Transport Server 之間的內部郵件流程會失敗。

MaxHeaderSize

選用

Microsoft.Exchange.Data.ByteQuantifiedSize

此參數指定接收連接器在關閉連線之前所接受的 SMTP 郵件標頭大小上限 (位元組)。預設值是 65536 個位元組。當您輸入值時,請以下列其中一個單位來限定值:

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

無限定的值會視為位元組。此參數的有效的輸入範圍是 12147483647 個位元組。

MaxHopCount

選用

System.Int32

此參數指定接收連接器拒絕郵件之前,該郵件可以採用的躍點數目上限。預設值為 30。此參數的有效的輸入範圍是 1500

附註   躍點數目上限是由所提交郵件中的 Received: 標頭欄位數目所決定。

MaxInboundConnection

選用

Microsoft.Exchange.Data.Unlimited

此參數指定此接收連接器同時間服務的輸入連線數目上限。預設值為 5000。此參數的有效的輸入範圍是 12147483647。若要停用接收連接器上的輸入連線限制,請輸入值 unlimited

MaxInboundConnectionPercentagePerSource

選用

System.Int32

此參數指定接收連接器同時從單一 IP 位址服務的連線數目上限,以接收連接器上的可用剩餘連線百分比表示。輸入值時請使用不含百分比 (%) 字元的整數。預設值為百分之 2。此參數的有效的輸入範圍是 1100

MaxInboundConnectionPerSource

選用

Microsoft.Exchange.Data.Unlimited

此參數指定這個接收連接器同時從單一 IP 位址服務的連線數目上限。預設值為 100。此參數的有效的輸入範圍是 110000。若要停用接收連接器上的每個來源輸入連線限制,請輸入值 unlimited

MaxLocalHopCount

選用

System.Int32

此參數指定接收連接器拒絕郵件之前,該郵件可以採用的本機躍點數目上限。預設值為 3。此參數的有效的輸入範圍是 050。指定值 0 時,根據本機躍點數目,絕不會拒絕郵件。

note附註:
本機躍點數目上限是由所提交郵件中具有本機伺服器位址的「已接收:」標頭數目所決定。

MaxLogonFailures

選用

System.Int32

此參數指定接收連接器在關閉連線之前重試登入失敗的次數。預設值為 3。此參數的有效的輸入範圍是 010。指定值 0 時,就算登入失敗,也絕對不會關閉連線。

MaxMessageSize

選用

Microsoft.Exchange.Data.ByteQuantifiedSize

此參數指定郵件的大小上限。預設值為 10 MB。輸入值時,請以下列其中一個單位來限定值:

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

無限定的值會視為位元組。此參數的有效的輸入範圍是 1 到 2147483647 個位元組。

MaxProtocolErrors

選用

Microsoft.Exchange.Data.Unlimited

此參數指定接收連接器在關閉連線之前所接受的 SMTP 通訊協定錯誤數目上限。預設值為 5。此參數的有效的輸入範圍是 02147483647。指定值 unlimited 時,就算發生通訊協定錯誤,也絕對不會關閉連線。

MaxRecipientsPerMessage

選用

System.Int32

此參數指定接收連接器在關閉連線之前所接受之每封郵件的收件者數目上限。預設值為 200。此參數的有效的輸入範圍是 1512000

MessageRateLimit

選用

Microsoft.Exchange.Data.Unlimited

此參數指定單一用戶端 IP 位址每分鐘能夠傳送的郵件數目上限。Hub Transport Server 上所設定之接收連接器的預設值是 unlimited。Edge Transport Server 上所設定之接收連接器的預設值是每分鐘 600 封郵件。此參數的有效的輸入範圍是 12147483647。若要移除接收連接器上的郵件率限制,請輸入值 unlimited

PermissionGroups

選用

Microsoft.Exchange.Data.PermissionGroups

此參數會定義可以將郵件提交給接收連接器的群組或角色,以及指派給那些群組的權限。權限群組是授與已知安全性主體的一組預先定義權限。此參數的有效值如下:NoneAnonymousUsersExchangeUsersExchangeServersExchangeLegacyServersPartners。指派給接收連接器的預設權限群組,取決於 Usage 參數在建立接收連接器時所指定的連接器用法類型。如需接收連接器用法類型的相關資訊,請參閱 接收連接器

PipeliningEnabled

選用

System.Boolean

此參數的有效值為 $True$False。當 PipeliningEnabled 參數設為 $True 時,PIPELINING EHLO 關鍵字會在 EHLO 回應中通告給遠端伺服器,且可供使用。當 PipeliningEnabled 參數設為 $False 時,PIPELINING EHLO 關鍵字不會在 EHLO 回應中通告給遠端伺服器,且會停用。PIPELINING 延伸模組讓遠端伺服器能夠傳送要求,而不需等待來自此接收連接器的回應。預設值為 $True

ProtocolLoggingLevel

選用

Microsoft.Exchange.Data.ProtocolLoggingLevel

此參數會啟用或停用所指定之接收連接器的通訊協定記錄。值 Verbose 會啟用連接器的通訊協定記錄。值 None 會停用連接器的通訊協定記錄。預設值為 None。使用 Set-TransportServer 指令程式的 ReceiveProtocolLogPath 參數,可以為所有在 Hub Transport Server 或 Edge Transport Server 上設定的接收連接器,指定其接收連接器通訊協定記錄的位置。

RemoteIPRanges

選用

Microsoft.Exchange.Data.MultiValuedProperty

這個參數會指定這個連接器接受郵件的來源遠端 IP 位址。此參數的有效語法為 <Starting IP Address>-<Ending IP Address>,例如192.168.1.1-192.168.1.10。您可以指定多個 IP 位址 (以逗號分隔)。

如果為 Usage 參數指定了下列值,您就必須指定 RemoteIPRanges 參數的值:

  • Internal
  • Custom

只要一個 IP 位址完全與另一個 IP 位址重疊,則相同伺服器上的多個接收連接器便可以使用重疊的遠端 IP 位址範圍。當遠端 IP 位址範圍重疊時,將使用與連接伺服器 IP 位址最符合的遠端 IP 位址範圍。

RequireEHLODomain

選用

System.Boolean

此參數的有效值為 $True$False。預設值為 $False。當 RequireEHLODomain 參數設為 $True 時,遠端電腦必須建立 SMTP 連線之後,在 EHLO 信號交換中提供網域名稱。如果遠端電腦不提供網域名稱,SMTP 連線便會關閉。

RequireTLS

選用

System.Boolean

此參數的有效值是 $True$False。預設值為 $False。當 RequireTLs 參數設為 $True 時,此連接器所接收的所有郵件皆需要傳輸層安全性 (TLS) 傳輸。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

此參數指定應該建立新接收連接器的伺服器。

SizeEnabled

選用

Microsoft.Exchange.Data.SizeMode

此參數的有效值為 EnabledDisabledEnabledwithoutValue。預設值為 EnabledSizeEnabled 參數設為 Enabled 時,會啟用 SIZE SMTP 延伸模組,而 MaxMessageSize 參數的允許郵件大小值上限則會在 EHLO 橫幅中通告。SizeEnabled 參數設為 Disabled 時,不會使用 SIZE SMTP 延伸模組,而且絕對不會將允許郵件大小值上限透露給遠端伺服器。SizeEnabled 參數設為 EnabledWithoutValue 時,會啟用 SIZE SMTP 延伸模組。然而,不會將 MaxMessageSize 參數的允許郵件大小值上限通告在 EHLO 橫幅中。這允許郵件略過 Hub Transport Server 間已驗證之連線的郵件大小檢查。SIZE SMTP 延伸模組是定義在 RFC 1870 中。SIZE 會讓來源伺服器宣告目標伺服器之輸入郵件的大小。也允許目標伺服器宣告允許接受之傳送伺服器的郵件大小上限。如果輸入郵件的通告大小超過 MessageSizeMax 參數中的值,則接收連接器會使用錯誤碼來回應遠端伺服器,並且關閉連線。

TarpitInterval

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

此參數指定延遲遠端伺服器之 SMTP 回應的時間量,因為 Exchange 判斷此伺服器可能濫用連線。驗證過的連線絕不會以此方式遭到延遲。

預設值為 5 秒。若要指定值,請輸入時間範圍格式:dd.hh:mm:ss,其中 d = 天數、h = 小時數、m = 分鐘數,s = 秒數。此參數的有效的輸入範圍是 00:00:0000:10:00。將值設為 00:00:00 時,會停用垃圾郵件防堵 (Tarpitting) 間隔。

TemplateInstance

選用

System.Management.Automation.PSObject

提供現有物件給此參數時,命令會使用該物件組態,在本機或目標伺服器上建立物件的相同副本。

Usage

選用

Microsoft.Exchange.Management.SystemConfigurationTasks.NewReceiveConnector+UsageType

此參數指定指派給此接收連接器的預設權限群組及驗證方法。Usage 參數的有效值如下:ClientCustomInternalInternetPartner

如果您為 Usage 參數指定下列任一值,則 Bindings 參數也需要有值:

  • Internet
  • Custom

如果您為 Usage 參數指定下列任一值,則 RemoteIPRanges 參數也需要有值:

  • Internal
  • Custom

如果沒有為必要的參數指定值,命令會以失敗結束。New-ReceiveConnector 指令程式不會提示您輸入遺漏的必要參數。

如需接收連接器用法類型、權限群組及驗證方法的相關資訊,請參閱接收連接器

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

範例

New-ReceiveConnector 命令會建立新的接收連接器。此範例顯示建立接收連接器所需的基本參數。

note附註:
您無法建立多個共用相同 Bindings 參數及 RemoteIPRanges 參數的接收連接器。
New-ReceiveConnector -Name Test -Bindings 10.10.1.1:25 -RemoteIPRanges 192.168.0.1-192.168.0.24

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