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

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

  • Статья

 

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

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

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

Синтаксис

Set-SendConnector -Identity <SendConnectorIdParameter> [-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>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Set-SendConnector [-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>] [-Instance <SmtpSendConnectorConfig>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

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

Командлет Set-SendConnector изменяет существующий соединитель отправки. При выполнении командлета Set-SendConnector требуется указать параметр Name. Параметр Identity требуется только при изменении значения параметра Name.

После выполнения этой задачи соединитель отправки изменяется.

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

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

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

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter

Параметр Identity указывает идентификатор GUID или имя соединителя, представляющего соединитель отправки, который требуется изменить.

AddressSpaces

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

Microsoft.Exchange.Data.MultiValuedProperty

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

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

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

  • Тип_адресного_пространства.   Для адресных пространств SMTP необходимо указать значение «SMTP». Для адресных пространств, не являющихся SMTP, значение может быть любой описательной текстовой строкой, например «Lotus Notes».

  • Адресное_пространство.   Для адресных пространств SMTP можно использовать подстановочный знак (*) службы доменных имен (DNS), как определено в документе RFC 1035. Например, можно использовать строки «*», «*.com.» или «*.contoso.com». Для адресных пространств, отличных от SMTP, можно использовать подстановочные знаки (*) и другие знаки, например: «contoso.com» или «@contoso».

  • Стоимость_адресного_пространства.   Диапазон допустимых значений — от 1 до 100. Чем ниже стоимость, тем лучше маршрут. Этот параметр является необязательным. Если квалификатор стоимость_соединителя опустить при вводе адресного пространства с использованием полного синтаксиса, для стоимости соединителя устанавливаются значение 1.

Использование полного синтаксиса для параметра AddressSpaces обязательно при следующих условиях:

  • наличие соединителей с заданной областью, имеющих квалификатор Local;

  • наличие адресных пространств, отличных от SMTP;

  • наличие адресных пространств SMTP со стоимостью, отличной от 1.

Если в качестве значения параметра AddressSpaces вводится имя домена или разделенный запятыми список имен доменов, для каждого адресного пространства предполагается тип адресного пространства SMTP и стоимость, равная 1. Соединители отправки, настроенные на пограничных транспортных серверах, поддерживают только адресные пространства SMTP. Соединители отправки, настроенные на транспортных серверах-концентраторах, поддерживают адресные пространства SMTP и адресные пространства, отличные от SMTP.

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

Этот параметр указывает, следует ли использовать маршрутизацию службы доменных имен (DNS) или отправлять все сообщения через промежуточный узел, настроенный с помощью параметра SmartHosts. Значение по умолчанию: $True. Чтобы задать значение $False, необходимо сначала задать значение параметра SmartHosts.

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

DomainSecureEnabled

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

System.Boolean

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

  • значение параметра DomainSecureEnabled равно $True;

  • значение параметра DNSRoutingEnabled равно $True;

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

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

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

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

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

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

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

Включен

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

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

Допустимыми значениями этого параметра являются $True и $False. Этот параметр определяет, следует ли пропустить параметр StartTLS, предлагаемый удаленным отправляющим сервером. Этот параметр используется при работе с удаленными доменами. Если значением параметра RequireTLS является $True, для этого параметра необходимо установить значением $False. По умолчанию для соединителей отправки, параметр DNSRoutingEnabled которых имеет значение $True, для параметра IgnoreStartTLS установлено значение $False. Это означает, что соединитель отправки будет всегда согласовывать TLS, если TLS предлагается получающим сервером. Если для параметра IgnoreStartTLS установлено значение $True, соединитель отправки никогда не будет пытаться согласовать TLS с получающим сервером.

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

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

LinkedReceiveConnector

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

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

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

  • GUID;

  • различающееся имя;

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

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

  • AddressSpaces $null

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

MaxMessageSize

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

Microsoft.Exchange.Data.Unlimited

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

  • B (байты)

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

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

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

Если единица измерения не задана, считается, что значение указано в байтах. Диапазон допустимых значений для этого параметра — от 0 до 2147483647 байт. Чтобы удалить ограничение размера сообщения для соединителя отправки, введите значение unlimited.

Name

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

System.String

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

Port

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

System.Int32

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

ProtocolLoggingLevel

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

Microsoft.Exchange.Data.ProtocolLoggingLevel

Этот параметр включает и отключает ведение журнала протокола для указанного соединителя отправки. Чтобы включить ведение журнала протокола для соединителя, установите значение Verbose. Чтобы отключить ведение журнала протокола для соединителя, установите значение None. Значение по умолчанию: 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

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

SourceIPAddress

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

System.Net.IPAddress

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

SourceTransportServers

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

Microsoft.Exchange.Data.MultiValuedProperty

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

UseExternalDNSServersEnabled

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

System.Boolean

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

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

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

Ошибки

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

 

 

Пример

В первом примере программы показана команда Set-SendConnector, которая изменяет существующий соединитель отправки. Эта команда задает ограничение в 10 МБ для параметра MaxMessageSize и ограничение в 15 минут для параметра ConnectionTimeOut.

Во втором примере показаны команды, которые настраивают существующий соединитель отправки на использование проверки подлинности при отправке сообщения электронной почты в Contoso.com. Для сервера электронной почты Contoso.com необходимо, чтобы локальный сервер Exchange Server 2007 прошел проверку подлинности для передачи сообщения электронной почты. Чтобы настроить соединитель отправки на использование проверки подлинности, необходимо сначала выполнить команду Get-Credential и назначить эту команду переменной. При выполнении команды Get-Credential она запрашивает имя пользователя и пароль учетной записи, которая будет использоваться при проверке подлинности на сервере электронной почты Contoso.com.

В этом примере команда Get-Credential назначена переменной $CredentialObject. После назначения учетных данных проверки подлинности переменной $CredentialObject соединитель отправки можно изменить с помощью командлета Set-SendConnector. Переменная $CredentialObject передается параметру AuthenticationCredential. Кроме настройки используемых учетных данных необходимо установить для параметра SmartHostAuthMechanism значение BasicAuth, чтобы соединитель отправки проходил проверку подлинности на сервере электронной почты Contoso.com с помощью предоставленных учетных данных.

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00 
$CredentialObject = Get-Credential
Set-SendConnector "E-Mail to Contoso.com" -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth