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

Set-SendConnector

  • Статья

 

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

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

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

Синтаксис

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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

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

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter

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

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.

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

Confirm

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

System.Management.Automation.SwitchParameter

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

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

Этот параметр применяется в процессе включения взаимной 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

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

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

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

IsScopedConnector

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

System.Boolean

Этот параметр контролирует доступность соединителя остальным транспортным серверам-концентраторам. Если этому параметру присвоено значение $False, соединитель может использоваться всеми транспортными серверами-концентраторами в организации Exchange. Если этому параметру присвоено значение $True, соединитель может использоваться только транспортными серверами-концентраторами на одном сайте Active Directory. По умолчанию данный параметр имеет значение $False.

LinkedReceiveConnector

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

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

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

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

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

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

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

  • AddressSpaces $null

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

MaxMessageSize

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

Microsoft.Exchange.Data.Unlimited

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

  • B (байт)

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

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

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

Значение без указания единицы обрабатывается как количество байт. Значения в байтах округляются до ближайшего значения в килобайтах. Например значение 1048575B округляется до 1MB, а значение 1048577 округляется до 1025KB. Допустимый диапазон вводимых значений для этого параметра составляет от 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 (Transport Layer Security). Значение по умолчанию: $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 или запись адреса. Если в качестве идентификатора промежуточного узла настроить полное доменное имя, сервер-источник соединителя отправления должен иметь возможность использовать разрешение имен 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.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Пример

Первый пример кода демонстрирует команду 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