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 參數的值必須為
若指定位址空間類型或位址空間成本,則必須將位址空間以雙引號 (
例如,您可以如下所示,使用逗號來分隔位址空間以指定多個位址空間: 如果您在 Hub Transport Server 所設定的傳送連接器上指定非 SMTP 位址空間類型,則傳送連接器上需要下列設定:
|
||
Name |
必要 |
System.String |
此參數是系統管理員提供的連接器名稱。如果名稱含有空格,則必須用雙引號括住 Name 參數,如以下範例所示: |
||
AuthenticationCredential |
選用 |
System.Management.Automation.PSCredential |
此參數需要建立及傳遞認證物件。此認證物件是使用 Get-Credential 指令程式來建立。如需 Get-Credential 指令程式的相關資訊,請在 Exchange 管理命令介面中輸入 |
||
Comment |
選用 |
System.String |
您必須用雙引號括住 Comment 參數,如下所示: |
||
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
Confirm 參數會使得命令暫停處理,並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。 |
||
ConnectionInactivityTimeOut |
選用 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
此參數指定閒置連線可維持開啟的時間上限。預設值是 10 分鐘。若要指定值,請輸入時間範圍格式:dd.hh:mm:ss,其中 d = 天數、h = 小時數、m = 分鐘數,s = 秒數。此參數的有效的輸入範圍是 |
||
Custom |
選用 |
System.Management.Automation.SwitchParameter |
此參數會指定
如需傳送連接器用法類型、權限及驗證方法的相關資訊,請參閱傳送連接器。 |
||
DNSRoutingEnabled |
選用 |
System.Boolean |
DnsRoutingEnabled 參數的有效值是 |
||
DomainController |
選用 |
Microsoft.Exchange.Data.Fqdn |
若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN),請在命令中加入 DomainController 參數。執行 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會讀取和寫入至本機 ADAM 執行個體。 |
||
DomainSecureEnabled |
選用 |
System.Boolean |
此參數適用於為此傳送連接器所服務的網域啟用相互傳輸層安全性 (TLS) 驗證的過程。只有在符合下列條件時,相互 TLS 驗證才會正確運作:
萬用字元 (*) 在已設定為交互 TLS 驗證的網域中不受支援。相同的網域也必須定義在對應的接收連接器上,以及 Get-TransportConfig 指令程式的 TLSReceiveDomainSecureList 參數值中。 下列類型之傳送連接器的 DomainSecureEnabled 預設值為
下列類型之傳送連接器的 DomainSecureEnabled 預設值為
|
||
Enabled |
選用 |
System.Boolean |
此參數的有效值為 |
||
Force |
選用 |
System.Management.Automation.SwitchParameter |
此參數會抑制在特定組態變更期間出現的警告或確認。 |
||
ForceHELO |
選用 |
System.Boolean |
此參數的有效值為 |
||
Fqdn |
選用 |
Microsoft.Exchange.Data.Fqdn |
此參數指定作為所連接的郵件伺服器的來源伺服器的 FQDN,這些郵件伺服器使用傳送連接器來接收外寄郵件。每當需要來源伺服器名稱時,此參數的值會顯示給連接的郵件伺服器,如下列範例所示:
Fqdn 參數的預設值是
|
||
IgnoreSTARTTLS |
選用 |
System.Boolean |
此參數指定是否忽略遠端傳送伺服器提供的 StartTLS 選項。此參數是與遠端網域搭配使用。如果 RequireTLS 參數設為 |
||
Internal |
選用 |
System.Management.Automation.SwitchParameter |
此參數會指定
如需傳送連接器用法類型、權限及驗證方法的相關資訊,請參閱傳送連接器。 |
||
Internet |
選用 |
System.Management.Automation.SwitchParameter |
此參數會指定
如需傳送連接器用法類型、權限及驗證方法的相關資訊,請參閱傳送連接器。 |
||
IsScopedConnector |
選用 |
System.Boolean |
此參數控制至其他 Hub Transport Server 之連接器的可用性。此參數的值是 |
||
LinkedReceiveConnector |
選用 |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
此參數會將指定的接收連接器所接收的所有郵件強制透過此傳送連接器送出。LinkedReceivedConnector 的值可使用下列任何一個識別碼指定接收連接器:
搭配 New-SendConnector 指令程式使用 LinkReceiveConnector 參數時,也必須使用下列參數與指定的值:
使用 LinkedReceiveConnector 參數時,不可使用 AddressSpace 參數。 |
||
MaxMessageSize |
選用 |
Microsoft.Exchange.Data.Unlimited |
此參數指定可通過連接器之郵件的大小上限。預設值為
無限定的值會視為位元組。以位元組數輸入的值將進位至最接近的 KB。例如, |
||
Partner |
選用 |
System.Management.Automation.SwitchParameter |
此參數會指定
如需傳送連接器用法類型、權限及驗證方法的相關資訊,請參閱傳送連接器。 |
||
Port |
選用 |
System.Int32 |
此參數的有效的輸入範圍是 |
||
ProtocolLoggingLevel |
選用 |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
此參數會啟用或停用所指定傳送連接器的通訊協定記錄。值 |
||
RequireTLS |
選用 |
System.Boolean |
此參數指定是否必須使用 TLS 傳輸所有透過此連接器傳送的郵件。預設值為 |
||
SmartHostAuthMechanism |
選用 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms |
在與遠端伺服器驗證期間會使用此參數。只有在設定了智慧主機且 DNSRoutingEnabled 參數設為 |
||
SmartHosts |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
如果將 DnsRoutingEnabled 參數設為 |
||
SourceIPAddress |
選用 |
System.Net.IPAddress |
這個參數會指定本機 IP 位址,當作 SMTP 連接到遠端郵件伺服器的端點。預設的 IP 位址為 |
||
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 |
可用此參數來指定要指派給傳送連接器的預設權限群組及驗證方法。此參數的有效值如下: 如果使用 Usage 參數,則不能使用下列參數中的任何一個:
如需傳送連接器用法類型、權限及驗證方法的相關資訊,請參閱傳送連接器。 |
||
UseExternalDNSServersEnabled |
選用 |
System.Boolean |
此參數指定此傳送連接器是否應該使用由 Set-TransportServer 指令程式的 ExternalDNSServers 參數所指定的外部網域名稱系統 (DNS) 清單。預設值為 |
||
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 技術資源中心.