Командлет 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
следует присвоить значение
При указании типа адресного пространства или затрат адресного
пространства необходимо заключить адресное пространство в двойные
кавычки (
Можно указать несколько адресных пространств, разделяя их
запятыми, как показано в следующем примере:
При указании типа адресного пространства, отличного от SMTP, на соединителе отправки, настроенном на транспортном сервере-концентраторе, на соединителе отправки необходимо указать значения перечисленных ниже параметров.
|
||
Name |
Обязательный |
System.String |
Этот параметр — это имя соединителя, предоставленное
администратором. Если имя содержит пробел, необходимо заключить
параметр Name в двойные кавычки, например: |
||
AuthenticationCredential |
Необязательный |
System.Management.Automation.PSCredential |
Этот параметр требует создания и передачи объекта учетных
данных. Этот объект учетных данных создается с помощью командлета
Get-Credential. Для получения дополнительных сведений о
командлете Get-Credential введите |
||
Comment |
Необязательный |
System.String |
Необходимо заключить параметр Comment в двойные кавычки,
например: |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется. |
||
ConnectionInactivityTimeOut |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Этот параметр указывает максимальное время пребывания
бездействующего подключения в открытом состоянии. Значение по
умолчанию равно 10 минутам. Указываемое значение должно вводиться в
виде интервала времени: дд.чч:мм:сс, где
дд — дни, чч — часы,
мм — минуты, а сс — секунды.
Допустимый диапазон вводимых значений для этого параметра: от
|
||
Custom |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр указывает тип использования
Дополнительные сведения о типах использования соединителя отправки, разрешениях и способах проверки подлинности см. в разделе Отправляющие соединители. |
||
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, предлагаемый удаленным отправляющим сервером. Этот
параметр используется при работе с удаленными доменами. Значение
этого параметра должно быть равно |
||
Internal |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр указывает тип использования
Дополнительные сведения о типах использования соединителя отправки, разрешениях и способах проверки подлинности см. в разделе Отправляющие соединители. |
||
Internet |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр указывает тип использования
Дополнительные сведения о типах использования соединителя отправки, разрешениях и способах проверки подлинности см. в разделе Отправляющие соединители. |
||
IsScopedConnector |
Необязательный |
System.Boolean |
Этот параметр контролирует доступность соединителя остальным
транспортным серверам-концентраторам. Если этому параметру
присвоено значение |
||
LinkedReceiveConnector |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
Этот параметр принудительно отправляет все сообщения, полученные указанным соединителем приема, на данный соединитель отправления. Значением параметра LinkedReceivedConnector может быть любой из следующих идентификаторов для указания соединителя приема:
При использовании параметра LinkReceiveConnector с командлетом Set-SendConnector необходимо также использовать следующие параметры с указанными значениями:
При использовании параметра LinkedReceiveConnector нельзя использовать параметр AddressSpace. |
||
MaxMessageSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальный размер почтовых сообщений,
которые могут проходить через соединитель. Значение по умолчанию:
Если единица измерения отсутствует, считается, что значение
указано в байтах. Значения в байтах округляются до ближайшего
значения в килобайтах. Например значение |
||
Partner |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр указывает тип использования
Дополнительные сведения о типах использования соединителя отправки, разрешениях и способах проверки подлинности см. в разделе Отправляющие соединители. |
||
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 |
Этот параметр используется для указания разрешений и способов
проверки подлинности по умолчанию, назначенных соединителю
отправки. Допустимы следующие значения этого параметра:
Если задан параметр Usage, следующие параметры использовать нельзя:
Дополнительные сведения о типах использования соединителя отправки, разрешениях и способах проверки подлинности см. в разделе Отправляющие соединители. |
||
UseExternalDNSServersEnabled |
Необязательный |
System.Boolean |
Данный параметр определяет, должен ли этот соединитель
отправления использовать внешний список DNS, указанный параметром
ExternalDNSServers командлета Set-TransportServer.
Значение по умолчанию: |
||
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 |