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

Синтаксис

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>]]

Параметры

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

AddressSpaces

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр является обязательным, за исключением тех случаев, когда данный соединитель связан с соединителем приема. Если связанный соединитель приема указан с помощью параметра LinkedReceiveConnector параметру AddressSpaces следует присвоить значение $null. В противном случае параметр AddressSpaces указывает имена доменов, в которые соединитель отправки отправляет сообщения. Полный синтаксис, используемый для ввода каждого адресного пространства, имеет следующий вид: <тип_адресного_пространства>:<адресное_пространство>;<затраты_адресного_пространства>

  • Тип_адресного_пространства   На пограничном транспортном сервере тип адресного пространства должен иметь значение 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 адресного пространства, содержащего точку с запятой (;), необходимо указать затраты адресного пространства.

При указании типа адресного пространства или затрат адресного пространства необходимо заключить адресное пространство в двойные кавычки ( " ). Например, следующие записи адресного пространства равнозначны:

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

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

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

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

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

Примечание.
Хотя на соединителе отправки на транспортном сервере-концентраторе можно настроить адресные пространства, отличные от 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".

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется.

ConnectionInactivityTimeOut

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

Microsoft.Exchange.Data.EnhancedTimeSpan

Этот параметр указывает максимальное время пребывания бездействующего подключения в открытом состоянии. Значение по умолчанию равно 10 минутам. Указываемое значение должно вводиться в виде интервала времени: дд.чч:мм:сс, где дд — дни, чч — часы, мм — минуты, а сс — секунды. Допустимый диапазон вводимых значений для этого параметра: от 00:00:01 до 1.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

Чтобы указать полное доменное имя (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 — полное доменное имя транспортного сервера-концентратора или пограничного транспортного сервера, содержащего соединитель отправки.

Примечание.
Если соединитель отправки настроен на транспортном сервере-концентраторе, на котором также установлена роль сервера почтовых ящиков, любое значение, указанное для параметра 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.

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

Этот параметр контролирует доступность соединителя остальным транспортным серверам-концентраторам. Если этому параметру присвоено значение $False, соединитель может использоваться всеми транспортными серверами-концентраторами в организации Exchange. Если этому параметру присвоено значение $True, соединитель может использоваться только транспортными серверами-концентраторами на одном сайте Active Directory. Значение по умолчанию: $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

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

  • B (байт)

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

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

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

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

Partner

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

System.Management.Automation.SwitchParameter

Этот параметр указывает тип использования Partner. Тип использования указывает разрешения и способы проверки подлинности, назначенные соединителю отправки. Если задан параметр Partner, следующие параметры использовать нельзя:

  • Custom

  • Internal

  • Internet

  • Usage

Дополнительные сведения о типах использования соединителя отправки, разрешениях и способах проверки подлинности см. в разделе Отправляющие соединители.

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. Если значение параметра Usage не указано, по умолчанию устанавливается тип использования Custom.

Если задан параметр Usage, следующие параметры использовать нельзя:

  • Custom

  • Internal

  • Internet

  • Partner

Дополнительные сведения о типах использования соединителя отправки, разрешениях и способах проверки подлинности см. в разделе Отправляющие соединители.

UseExternalDNSServersEnabled

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

System.Boolean

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

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

Ошибки

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

 

 

Пример

В первом примере показана команда, создающая соединитель отправления, который отправляет сообщения электронной почты по Интернету. В примере приведены минимальные параметры, необходимые для создания соединителя отправления. Адресное пространство ограничено отправкой писем только в домены 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