Командлет 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>] |
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter |
Параметр Identity указывает идентификатор GUID или имя соединителя, представляющего соединитель отправки, который требуется изменить. |
||
AddressSpaces |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр является обязательным, за исключением тех случаев,
когда данный соединитель связан с соединителем приема. Если
связанный соединитель приема указан с помощью параметра
LinkedReceiveConnector, параметру AddressSpaces
следует присвоить значение <область_соединителя>:<тип_адресного_пространства>:<адресное_пространство>;<стоимость_адресного_пространства>
Использование полного синтаксиса для параметра AddressSpaces обязательно при следующих условиях:
Если в качестве значения параметра AddressSpaces вводится имя домена или разделенный запятыми список имен доменов, для каждого адресного пространства предполагается тип адресного пространства SMTP и стоимость, равная 1. Соединители отправки, настроенные на пограничных транспортных серверах, поддерживают только адресные пространства SMTP. Соединители отправки, настроенные на транспортных серверах-концентраторах, поддерживают адресные пространства SMTP и адресные пространства, отличные от SMTP. |
||
AuthenticationCredential |
Необязательный |
System.Management.Automation.PSCredential |
Этот параметр требует создания и передачи объекта учетных
данных. Этот объект учетных данных создается с помощью командлета
Get-Credential. Для получения дополнительных сведений о
командлете Get-Credential введите |
||
Comment |
Необязательный |
System.String |
Параметр Comment необходимо заключать в прямые кавычки,
например: |
||
ConnectionInactivityTimeOut |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Этот параметр указывает максимальное время открытия подключения при его бездействии. Значение по умолчанию — 10 минут. Значение должно вводиться как интервал времени: дд.чч:мм:сс, где дд — дни, чч — часы, мм — минуты, а сс — секунды. Диапазон допустимых значений для этого параметра: от 00:00:01 до 1.00:00:00. |
||
DNSRoutingEnabled |
Необязательный |
System.Boolean |
Этот параметр указывает, следует ли использовать маршрутизацию
службы доменных имен (DNS) или отправлять все сообщения через
промежуточный узел, настроенный с помощью параметра
SmartHosts. Значение по умолчанию: |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с установленной ролью пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет чтение и запись только в локальный экземпляр ADAM. |
||
DomainSecureEnabled |
Необязательный |
System.Boolean |
Этот параметр применяется в процессе включения проверки подлинности Mutual TLS для доменов, обслуживаемых данным соединителем отправки. Проверка подлинности Mutual TLS правильно выполняется только в следующих условиях:
Использование подстановочного знака (*) в доменах, настроенных для проверки подлинности Mutual TLS, не поддерживается. Одно и то же имя домена должно быть определено для соединителя приема и являться значением параметра TLSReceiveDomainSecureList в командлете Get-TransportConfig. Значение по умолчанию для параметра DomainSecureEnabled
равно
Значение по умолчанию для параметра DomainSecureEnabled
равно
|
||
Включен |
Необязательный |
System.Boolean |
Допустимыми значениями этого параметра являются
|
||
Force |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр предотвращает вывод предупреждений или подтверждений при выполнении определенных изменений конфигурации. |
||
ForceHELO |
Необязательный |
System.Boolean |
Допустимыми значениями этого параметра являются
|
||
Fqdn |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Этот параметр указывает полное доменное имя, используемое в качестве исходного сервера для подключенных серверов обмена сообщениями, использующих соединитель отправки для приема исходящих сообщений. Значение этого параметра показывается подключенным серверам обмена сообщениями каждый раз, когда требуется имя исходного сервера, в том числе в следующих случаях:
По умолчанию параметр Fqdn имеет значение
|
||
IgnoreSTARTTLS |
Необязательный |
System.Boolean |
Допустимыми значениями этого параметра являются
|
||
Instance |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig |
Этот параметр позволяет передать команде для обработки весь объект. Он обычно используется в сценариях, где целый объект должен быть передан команде. |
||
LinkedReceiveConnector |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
Этот параметр принудительно отправляет все сообщения, полученные указанным соединителем приема, на данный соединитель отправки. Значением параметра LinkedReceivedConnector может быть любой из следующих идентификаторов для указания соединителя получения:
При использовании параметра LinkReceiveConnector с командлетом Set-SendConnector необходимо также указать значения следующих параметров:
|
||
MaxMessageSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальный размер сообщений, которые
могут проходить через соединитель. Значение по умолчанию:
Если единица измерения не задана, считается, что значение
указано в байтах. Диапазон допустимых значений для этого параметра
— от |
||
Name |
Необязательный |
System.String |
Параметр Name — это имя соединителя, заданное
администратором. Если имя содержит пробел, необходимо заключить
параметр Name в прямые кавычки, например: |
||
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 |
Этот параметр может содержать одно или несколько полных доменных
имен, например |
||
SourceIPAddress |
Необязательный |
System.Net.IPAddress |
Этот параметр задает локальный IP-адрес, используемый в качестве
конечной точки SMTP-соединения с удаленным сервером обмена
сообщениями. По умолчанию используется IP-адрес
|
||
SourceTransportServers |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр определяет имена транспортных серверов-концентраторов, которые могут использовать данный соединитель отправки. Можно указать имена нескольких транспортных серверов-концентраторов, разделив их запятыми. Этот параметр недопустим для соединителей отправки, настроенных на пограничных транспортных серверах. |
||
UseExternalDNSServersEnabled |
Необязательный |
System.Boolean |
Данный параметр определяет, должен ли этот соединитель отправки
использовать внешний список DNS, указанный параметром
ExternalDNSServers командлета Set-TransportServer.
Значение по умолчанию: |
Подробное описание
Командлет Set-SendConnector изменяет существующий соединитель отправки. При выполнении командлета Set-SendConnector требуется указать параметр Name. Параметр Identity требуется только при изменении значения параметра Name.
После выполнения этой задачи соединитель отправки изменяется.
Для выполнения командлета Set-SendConnector используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.
Для выполнения командлета Set-SendConnector на компьютере с установленной ролью пограничного транспортного сервера необходимо войти в систему с учетной записью, которая является членом локальной группы администраторов на данном компьютере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Пример
В первом примере программы показана команда 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 |