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