共用方式為


New-SendConnector

 

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

上次修改主題的時間: 2007-09-05

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

語法

New-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

詳細描述

此指令程式會建立新的傳送連接器。若要提示新傳送連接器的必要參數,請輸入 New-SendConnector。完成此工作之後,即會建立傳送連接器。

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

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

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

參數

參數 必要 類型 描述

AddressSpaces

必要

Microsoft.Exchange.Data.MultiValuedProperty

除非此連接器連結到接收連接器,否則需要此參數。如果是使用 LinkedReceiveConnector 參數指定連結的接收連接器,則 AddressSpaces 參數的值必須為 $null。否則,AddressSpaces 參數會指定傳送連接器傳送郵件的目標網域名稱。輸入每個位址空間的完整語法如下:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   在 Edge Transport Server 上,位址空間類型必須是 SMTP。在 Hub Transport Server 上,位址空間類型可能是 SMTPX400 或任何其他文字字串。如果略過位址空間類型,則會假設使用 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".

如果您在 Hub Transport Server 所設定的傳送連接器上指定非 SMTP 位址空間類型,則傳送連接器上需要下列設定:

  • 您必須指定 SmartHosts 參數的值,使用智慧型主機來路由傳送電子郵件。
  • 您必須將 DNSRoutingEnabled 參數設為 $False
note附註:
雖然可以在 Hub Transport Server 的傳送連接器上設定非 SMTP 位址空間,但是傳送連接器會使用 SMTP 作為傳輸機制,以將郵件傳送給其他郵件伺服器。Hub Transport Server 上的外部連接器,是用來將郵件傳送給不使用 SMTP 作為其主要傳輸機制的本機郵件伺服器 (如協力廠商傳真閘道伺服器)。如需相關資訊,請參閱外部連接器

Name

必要

System.String

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

AuthenticationCredential

選用

System.Management.Automation.PSCredential

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

Comment

選用

System.String

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

Confirm

選用

System.Management.Automation.SwitchParameter

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

ConnectionInactivityTimeOut

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

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

Custom

選用

System.Management.Automation.SwitchParameter

此參數會指定 Custom 用法類型。用法類型指定指派給傳送連接器的權限與驗證方法。如果使用 Custom 參數,則不能使用下列參數中的任何一個:

  • Internal
  • Internet
  • Partner
  • Usage

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

DNSRoutingEnabled

選用

System.Boolean

DnsRoutingEnabled 參數的有效值是 $True$False。預設值為 $True。如果指定 SmartHosts 參數,則相同命令列中的 DnsRoutingEnabled 參數必須為 $False

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
Get-ExchangeServer

IgnoreSTARTTLS

選用

System.Boolean

此參數指定是否忽略遠端傳送伺服器提供的 StartTLS 選項。此參數是與遠端網域搭配使用。如果 RequireTLS 參數設為 $True,則此參數必須設為 $False。此參數的有效值為 $True$False

Internal

選用

System.Management.Automation.SwitchParameter

此參數會指定 Internal 用法類型。用法類型指定指派給傳送連接器的權限與驗證方法。如果使用 Internal 參數,則不能使用下列參數中的任何一個:

  • Custom
  • Internet
  • Partner
  • Usage

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

Internet

選用

System.Management.Automation.SwitchParameter

此參數會指定 Internet 用法類型。用法類型指定指派給傳送連接器的權限與驗證方法。如果使用 Internet 參數,則不能使用下列參數中的任何一個:

  • Custom
  • Internal
  • Partner
  • Usage

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

IsScopedConnector

選用

System.Boolean

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

LinkedReceiveConnector

選用

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

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

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

搭配 New-SendConnector 指令程式使用 LinkReceiveConnector 參數時,也必須使用下列參數與指定的值:

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

使用 LinkedReceiveConnector 參數時,不可使用 AddressSpace 參數。

MaxMessageSize

選用

Microsoft.Exchange.Data.Unlimited

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

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

無限定的值會視為位元組。以位元組數輸入的值將進位至最接近的 KB。例如,1048575B 會進位至 1MB1048577 會進位至 1025KB。此參數的有效的輸入範圍是 02147483647 個位元組。若要移除傳送連接器上的郵件大小限制,請輸入 unlimited 的值。

Partner

選用

System.Management.Automation.SwitchParameter

此參數會指定 Partner 用法類型。用法類型指定指派給傳送連接器的權限與驗證方法。如果使用 Partner 參數,則不能使用下列參數中的任何一個:

  • Custom
  • Internal
  • Internet
  • Usage

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

Port

選用

System.Int32

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

ProtocolLoggingLevel

選用

Microsoft.Exchange.Data.ProtocolLoggingLevel

此參數會啟用或停用所指定傳送連接器的通訊協定記錄。值 Verbose 會啟用連接器的通訊協定記錄。值 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 時,才使用此參數。有效值為 NoneBasicAuthBasicAuthRequireTLSExchangeServerExternalAuthoritative。所有的值彼此互斥。如果您選取 BasicAuthBasicAuthRequireTLS,必須使用 AuthenticationCredential 參數指定驗證認證。

SmartHosts

選用

Microsoft.Exchange.Data.MultiValuedProperty

如果將 DnsRoutingEnabled 參數設為 $False,則必須指定此參數,而且這兩個參數必須指定在相同的命令列中。SmartHosts 參數可接受一或多個 FQDN (如 server.contoso.com)、一或多個 IP 位址,或 FQDN 及 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 上設定的傳送連接器。

TemplateInstance

選用

System.Management.Automation.PSObject

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

Usage

選用

Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType

可用此參數來指定要指派給傳送連接器的預設權限群組及驗證方法。此參數的有效值如下:CustomInternalInternetPartner。如果沒有為 Usage 參數指定值,則用法類型會預設為 Custom

如果使用 Usage 參數,則不能使用下列參數中的任何一個:

  • Custom
  • Internal
  • Internet
  • Partner

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

UseExternalDNSServersEnabled

選用

System.Boolean

此參數指定此傳送連接器是否應該使用由 Set-TransportServer 指令程式的 ExternalDNSServers 參數所指定的外部網域名稱系統 (DNS) 清單。預設值為 $False。此參數的有效值為 $True$False

WhatIf

選用

System.Management.Automation.SwitchParameter

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

範例

第一個範例顯示的命令會建立透過網際網路傳送電子郵件的新傳送連接器。此範例顯示建立傳送連接器所需的基本參數。位址空間被限制為只能將郵件傳送至 Contoso.com 網域及 Microsoft.com 網域。

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

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

New-SendConnector -Name Test -AddressSpaces contoso.com,microsoft.com
$CredentialObject = Get-Credential
New-SendConnector -Name "Secure E-Mail to Contoso.com" -AddressSpaces contoso.com -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth

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