Поделиться через

New-SendConnector (окончательная первоначальная версия)

  • Статья

 

Применимо к: Exchange Server 2007 SP1, Exchange Server 2007

Последнее изменение раздела: 2007-08-27

Командлет New-SendConnector используется для создания соединителя отправки на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.

Синтаксис

New-SendConnector -Name <String> -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>] [-MaxMessageSize <Unlimited>] [-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>]

New-SendConnector -Name <String> [-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>] [-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>]

Подробное описание

Этот командлет создает соединитель отправки. Чтобы получить запрос на ввод нужных параметров нового соединителя отправки, введите New-SendConnector. После выполнения этой задачи создается соединитель отправки.

Для выполнения командлета New-SendConnector используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

Чтобы выполнить командлет New-SendConnector на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему с учетной записью, которая является членом локальной группы администраторов на данном компьютере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательный Тип Описание

AddressSpaces

Обязательный

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр является обязательным, за исключением тех случаев, когда данный соединитель связан с соединителем получения с помощью параметра LinkedReceiveConnector. Параметр AddressSpaces указывает имена доменов, на которые отправляет сообщения соединитель отправки. Можно указать несколько адресных пространств, разделяя их запятыми. Полный синтаксис для ввода каждого адресного пространства выглядит следующим образом:

<область_соединителя>:<тип_адресного_пространства>:<адресное_пространство>;<затраты_адресного_пространства>

  • Область_соединителя   Если указано значение Local, соединитель может использоваться только другими транспортными серверами-концентраторами, существующими в том же сайте Active Directory, в качестве исходного транспортного сервера-концентратора, на котором выполняется командлет New-SendConnector. Если квалификатор область_соединителя отсутствует, соединитель может использоваться всеми транспортными серверами-концентраторами всей организации сервера Exchange 2007.

  • Тип_адресного_пространства   На пограничном транспортном сервере тип адресного пространства должен иметь значение SMTP. На транспортном сервере-концентраторе типу адресного пространства можно присвоить значение SMTP, X400 или любую текстовую строку. Если опустить тип адресного пространства, будет использоваться тип адресного пространства SMTP.

  • Адресное_пространство   Для типа адресного пространства SMTP введенное значение адресного пространства должно быть совместимо с RFC 1035. Например, значения *, *.com и *.contoso.com допустимы, а значение *contoso.com недопустимо. Для типа адресного пространства X.400 введенное значение адресного пространства должно быть совместимо с RFC 1685, например o=MySite;p=MyOrg;a=adatum;c=us. Для всех остальных типов адресов в качестве адресного пространства можно ввести произвольный текст.

  • Затраты_адресного_пространства   Допустимый диапазон затрат — от 1 до 100. Чем ниже затраты, тем лучше маршрут. Этот параметр является необязательным. Если опустить значение затрат адресного пространства, будет использоваться значение 1. При вводе отличного от SMTP адресного пространства, содержащего точку с запятой (;), необходимо указать затраты адресного пространства.

Полный синтаксис для параметра адресные_пространства необходимо использовать только при наличии следующих условий.

  • Соединители с заданной областью имеют квалификатор Local.

  • Имеются адресные пространства, не являющиеся адресными пространствами SMTP.

  • Имеются адресные пространства SMTP с затратами, отличными от 1.

Можно указать несколько адресных пространств, разделяя их запятыми, как показано в следующем примере: contoso.com,fabrikam.com. При указании области соединителя, типа адресного пространства или затрат адресного пространства необходимо заключить адресное пространство в двойные кавычки ("), как показано в следующем примере: "contoso.com;2","fabrikam.com;3".

При указании типа адресного пространства, отличного от SMTP, на соединителе отправки, настроенном на транспортном сервере-концентраторе, на соединителе отправки необходимо указать значения перечисленных ниже параметров.

  • Для маршрутизации электронной почты необходимо использовать промежуточный узел, указав значение параметра SmartHosts.

  • Параметру DNSRoutingEnabled необходимо присвоить значение $False.

noteПримечание.
Хотя на соединителе отправки на транспортном сервере-концентраторе можно настроить адресные пространства, отличные от SMTP, соединитель отправки использует SMTP в качестве механизма транспорта для отправки сообщений на другие серверы обмена сообщениями. Внешние соединители на транспортных серверах-концентраторах используются для отправки сообщений на локальные серверы обмена сообщениями, такие как серверы шлюзов для факсов сторонних производителей, которые не используют SMTP в качестве основного механизма транспорта. Дополнительные сведения см. в разделе Внешние соединители.

Name

Обязательный

System.String

Этот параметр — это имя соединителя, предоставленное администратором. Если имя содержит пробел, необходимо заключить параметр Name в двойные кавычки, например: "New Send Connector".

AuthenticationCredential

Необязательный

System.Management.Automation.PSCredential

Этот параметр требует создания и передачи объекта учетных данных. Этот объект учетных данных создается с помощью командлета Get-Credential. Для получения дополнительных сведений о командлете Get-Credential введите Get-Help Get-Credential в командной консоли Exchange.

Comment

Необязательный

System.String

Необходимо заключить параметр Comment в двойные кавычки, например: "this is an admin note".

ConnectionInactivityTimeOut

Необязательный

Microsoft.Exchange.Data.EnhancedTimeSpan

Этот параметр указывает максимальное время пребывания бездействующего подключения в открытом состоянии. Значение по умолчанию — 10 минут. Указываемое значение должно вводиться в виде интервала времени: дд.чч:мм:сс, где дд — дни, чч — часы, мм — минуты, а сс — секунды. Допустимый диапазон вводимых значений для этого параметра составляет от 00:00:01 до 1.00:00:00.

DNSRoutingEnabled

Необязательный

System.Boolean

Допустимыми значениями параметра DnsRoutingEnabled являются $True и $False. По умолчанию этот параметр имеет значение $True. Если указан параметр SmartHosts, параметр DnsRoutingEnabled в той же командной строке должен быть $False.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с ролью пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет чтение и запись только в локальный экземпляр ADAM.

DomainSecureEnabled

Необязательный

System.Boolean

Этот параметр применяется в процессе включения взаимной TLS-проверки подлинности для доменов, обслуживаемых соединителем отправки. Взаимная проверка подлинности TLS правильно работает только при выполнении следующих условий:

  • Параметру DomainSecureEnabled присвоено значение $True.

  • Параметру DNSRoutingEnabled присвоено значение $True.

  • Параметру IgnoreStartTLS присвоено значение $False.

Использование подстановочного знака (*) в доменах, настроенных для взаимной проверки подлинности TLS, не поддерживается. Одно и то же имя домена должно быть определено для соединителя получения и являться значением параметра TLSReceiveDomainSecureList в командлете Get-TransportConfig.

Параметр DomainSecureEnabled по умолчанию имеет значение $False для следующих типов соединителей отправки:

  • все соединители отправки, определенные на транспортном сервере-концентраторе;

  • созданные пользователем соединители отправки, определенные на пограничном транспортном сервере.

Параметр DomainSecureEnabled по умолчанию имеет значение $True для следующих типов соединителей отправки:

  • соединители отправки по умолчанию, определенные на пограничном транспортном сервере.

Enabled

Необязательный

System.Boolean

Допустимые значения этого параметра: $True или $False. По умолчанию этот параметр имеет значение $True. Используйте параметр Enabled, чтобы включить или отключить возможность обработки соединителем сообщений электронной почты.

Force

Необязательный

System.Management.Automation.SwitchParameter

Этот параметр предотвращает появление предупреждений или запросов подтверждения при выполнении определенных изменений конфигурации.

ForceHELO

Необязательный

System.Boolean

Допустимые значения этого параметра: $True или $False. По умолчанию этот параметр имеет значение $False. По умолчанию используется EHLO. Если значение этого параметра равно $True, вместо EHLO посылается HELO.

Fqdn

Необязательный

Microsoft.Exchange.Data.Fqdn

Этот параметр указывает полное доменное имя, используемое в качестве исходного сервера для подключенных серверов обмена сообщениями, использующих соединитель отправки для приема исходящих сообщений. Значение этого параметра показывается подключенным серверам обмена сообщениями каждый раз, когда требуется имя исходного сервера, как показано в приведенных ниже примерах.

  • В команде EHLO/HELO, когда соединитель отправки взаимодействует с сервером обмена сообщениями следующего прыжка

  • В самом последнем поле заголовка Received: сообщения, которое добавляется к сообщению сервером обмена сообщениями следующего прыжка после того, как сообщение покидает транспортный сервер-концентратор или пограничный транспортный сервер

  • В процессе проверки подлинности TLS

По умолчанию параметр Fqdn имеет значение $Null. Это означает, что фактическое значение по умолчанию параметра FQDN — полное доменное имя транспортного сервера-концентратора или пограничного транспортного сервера, содержащего соединитель отправки.

noteПримечание.
Если соединитель отправки настроен на транспортном сервере-концентраторе, на котором также установлена роль сервера почтовых ящиков, любое значение, указанное для параметра Fqdn, не используется. Вместо этого всегда используется полное доменное имя сервера, показываемое командлетом Get-ExchangeServer.
Для серверов, на которых установлены роли транспортного сервера-концентратора и сервера почтовых ящиков, единственный способ удалить имя сервера из заголовков Received: исходящего сообщения заключается в использовании командлета Remove-ADPermission для отъема разрешения Ms-Exch-Send-Headers-Routing у участников безопасности, использующих соединитель. Это действие приведет к удалению всех заголовков Received: из сообщения при покидании сообщением транспортного сервера-концентратора. Не рекомендуется удалять заголовки Received: для внутренних сообщений, поскольку заголовки Received: используются для расчета максимального количества прыжков. Дополнительные сведения о командлетах Remove-ADPermission и Get-ExchangeServer см. в следующих разделах:
• Командлет Remove-ADPermission (окончательная первоначальная версия)
• Командлет Get-ExchangeServer (окончательная первоначальная версия)

IgnoreSTARTTLS

Необязательный

System.Boolean

Этот параметр определяет, следует ли пропустить параметр StartTLS, предлагаемый удаленным отправляющим сервером. Этот параметр используется при работе с удаленными доменами. Значение этого параметра должно быть равно $False, если значение параметра RequireTLS равно $True. Допустимые значения этого параметра — $True и $False.

LinkedReceiveConnector

Необязательный

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Этот параметр принудительно отправляет все сообщения, полученные указанным соединителем получения, на данный соединитель отправки. Значением параметра LinkedReceivedConnector может быть любой из следующих идентификаторов для указания соединителя получения:

  • Идентификатор GUID

  • Различающееся имя (DN)

  • имя_сервера\имя_соединителя.

При использовании параметра LinkReceiveConnector с командлетом Set-SendConnector необходимо также использовать следующие параметры с указанными значениями:

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

При использовании параметра LinkedReceiveConnector нельзя использовать параметр AddressSpace.

MaxMessageSize

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр MaxMessageSize указывает максимальный размер почтовых сообщений, которые могут проходить через соединитель. Можно также перегрузить этот параметр, введя значение unlimited, если нет необходимости накладывать подобные ограничения на этот соединитель. По умолчанию этот параметр имеет значение 10MB. При вводе целого числа значение следует квалифицировать с использованием одной из следующих единиц измерения:

  • B (байт)

  • KB (килобайт)

  • MB (мегабайт)

  • GB (гигабайт)

Значение без указания единицы измерения обрабатывается как количество байт. Значения в байтах округляются до ближайшего значения в килобайтах. Например значение 1048575B округляется до 1MB, а значение 1048577 округляется до 1025KB. Допустимый диапазон вводимых значений для этого параметра: от 0 до 2147483647 .

Port

Необязательный

System.Int32

Допустимым диапазоном вводимых значений для этого параметра является любое целое число между 0 и 65535. По умолчанию этот параметр имеет значение 25. Если указано значение параметра SmartHosts, значение параметра Port определяет номер порта, который будет использоваться для пересылки с помощью промежуточного узла. В большинстве организаций номер порта равен 25.

ProtocolLoggingLevel

Необязательный

Microsoft.Exchange.Data.ProtocolLoggingLevel

Этот параметр включает и отключает ведение журнала протокола для указанного соединителя отправки. Чтобы включить ведение журнала протокола для соединителя, необходимо установить значение Verbose. Чтобы отключить ведение журнала протокола для соединителя, необходимо установить значение None. Местоположение журналов протокола соединителя отправки для всех соединителей отправки, настроенных на транспортном сервере-концентраторе или на пограничном транспортном сервере, указывается с помощью параметра SendProtocolLogPath в командлете Set-TransportServer.

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

Этот параметр необходим и должен быть указан в той же командной строке, если значение параметра DnsRoutingEnabled равно $False. Параметр SmartHosts может содержать одно или несколько полных доменных имен, например server.contoso.com, один или несколько IP-адресов или сочетание IP-адресов и полных доменных имен. Каждое значение отделяется запятой. При вводе IP-адреса необходимо использовать текстовый формат, например: 10.10.1.1. Идентификатором промежуточного узла может быть полное доменное имя сервера промежуточного узла, запись MX или запись адреса. Если в качестве идентификатора промежуточного узла настроено полное доменное имя, сервер-источник соединителя отправки должен иметь возможность использовать разрешение имен DNS для нахождения сервера промежуточного узла.

SourceIPAddress

Необязательный

System.Net.IPAddress

Этот параметр задает локальный IP-адрес, используемый в качестве конечной точки SMTP-подключения к удаленному серверу обмена сообщениями. По умолчанию используется IP-адрес 0.0.0.0. Это значение означает, что сервер может использовать любой доступный локальный IP-адрес. Этот параметр допустим только для соединителей отправки, настроенных на пограничных транспортных серверах.

SourceTransportServers

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр определяет имена транспортных серверов-концентраторов, которые могут использовать данный соединитель отправки. Можно указать имена нескольких транспортных серверов-концентраторов, разделив их запятыми. Этот параметр недопустим для соединителей отправки, настроенных на пограничных транспортных серверах.

TemplateInstance

Необязательный

System.Management.Automation.PSObject

Когда существующий объект предоставляется этому параметру, команда использует конфигурацию объекта для создания точной копии объекта на локальном или целевом сервере.

Usage

Необязательный

Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType

Этот параметр помогает настроить для соединителя значения по умолчанию в зависимости от способа использования соединителя. Допустимы следующие значения этого параметра: Custom, Internal, Internet или Partner. Дополнительные сведения о вариантах использования соединителя отправки см. в разделе Отправляющие соединители.

UseExternalDNSServersEnabled

Необязательный

System.Boolean

Данный параметр определяет, должен ли этот соединитель отправки использовать внешний список DNS, указанный параметром ExternalDNSServers командлета Set-TransportServer. По умолчанию этот параметр имеет значение $False. Допустимые значения этого параметра — $True и $False.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Пример

В первом примере показана команда, создающая соединитель отправки, который отправляет сообщения электронной почты через Интернет. В примере приведены минимальные параметры, необходимые для создания соединителя отправки. Адресное пространство ограничено отправкой писем только в домены Contoso.com и Microsoft.com.

Во втором примере показаны команды для создания соединителя отправки, который будет отправлять сообщения электронной почты в домен Contoso.com. На сервере электронной почты Contoso.com требуется, чтобы локальный сервер Exchange 2007 проходил на нем проверку подлинности для отправки сообщений электронной почты. Чтобы настроить соединитель отправки на использование проверки подлинности, необходимо сначала выполнить команду 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