Командлет New-ReceiveConnector используется для создания нового соединителя приема на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.
Синтаксис
New-ReceiveConnector -Name <String> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-Server <ServerIdParameter>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internet | Internal | Client | Partner>] |
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Name |
Обязательный |
System.String |
Этот параметр указывает имя соединителя, заданное
администратором. Значение параметра Name вводится в виде
строки, как показано в следующем примере: " |
||
AuthMechanism |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector+AuthMechanisms |
Этот параметр указывает объявленные и принятые механизмы
проверки подлинности. Доступны следующие варианты проверки
подлинности: |
||
Banner |
Необязательный |
System.String |
Этот параметр переопределяет используемый по умолчанию заголовок SMTP 220. Если значение параметра Banner не установлено, по умолчанию задается следующий заголовок SMTP:
При указании значения параметра Banner необходимо использовать следующий синтаксис:
220 является кодом оклика SMTP «Служба готова» по умолчанию (согласно документу RFC 2821). |
||
BinaryMimeEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
Bindings |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр определяет локальный IP-адрес и номера TCP-портов,
используемые соединителем приема для прослушивания входящих
сообщений. Синтаксис параметра:
<IP-адрес>:<TCP-порт>, например:
Значения параметра Bindings должны соответствовать одному из указанных ниже требований уникальности.
Значение параметра Bindings необходимо указывать, если заданы следующие значения параметра Usage:
|
||
ChunkingEnabled |
Необязательный |
System.Boolean |
Допустимыми значениями этого параметра являются
|
||
Comment |
Необязательный |
System.String |
Необходимо заключить параметр Comment в прямые кавычки,
например: |
||
ConnectionInactivityTimeout |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Этот параметр указывает максимальное время ожидания до закрытия
подключения к соединителю приема. Значение по умолчанию для
соединителя приема, настроенного на транспортном
сервере-концентраторе, — 5 минут. Значение по умолчанию для
соединителя приема, настроенного на пограничном транспортном
сервере, — 1 минута. Значение должно вводиться как интервал
времени: дд.чч:мм:сс, где дд — дни,
чч — часы, мм — минуты, а
сс — секунды. Значение, заданное параметром
ConnectionTimeout, должно быть больше значения, заданного
параметром ConnectionInactivityTimeout. Диапазон допустимых
значений для любого из этих параметров – от
|
||
ConnectionTimeOut |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Этот параметр задает максимальное количество времени, в течение
которого подключение может оставаться открытым, даже если через
подключение выполняется активная передача данных. Значение по
умолчанию для соединителя приема, настроенного на транспортном
сервере-концентраторе, — 10 минут. Значение по умолчанию для
соединителя приема, настроенного на пограничном транспортном
сервере, — 5 минут. Значение должно вводиться как интервал времени:
дд.чч:мм:сс, где дд — дни,
чч — часы, мм — минуты, а
сс — секунды. Значение, заданное параметром
ConnectionTimeout, должно быть больше значения, заданного
параметром ConnectionInactivityTimeout. Диапазон допустимых
значений для любого из этих параметров – от
|
||
DefaultDomain |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter |
Этот параметр задает имя домена, которое должно добавляться к
значениям, передающимся отправляющим сервером в |
||
DeliveryStatusNotificationEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с ролью пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет чтение и запись только в локальный экземпляр ADAM. |
||
DomainSecureEnabled |
Необязательный |
System.Boolean |
Этот параметр является первым этапом включения проверки подлинности Mutual TLS для доменов, обслуживаемых этим соединителем приема. Проверка подлинности Mutual TLS правильно работает только при выполнении следующих условий:
По умолчанию параметр DomainSecureEnabled имеет значение
По умолчанию параметр DomainSecureEnabled имеет значение
|
||
EightBitMimeEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
Enabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
EnhancedStatusCodesEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
Fqdn |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Этот параметр определяет полное доменное имя конечного сервера для подключенных серверов обмена сообщениями, использующих данный соединитель приема для отправки входящих сообщений. Значение этого параметра отображается для подключенных серверов обмена сообщениями, когда требуется имя конечного сервера, например:
Значением по умолчанию параметра Fqdn является полное доменное имя транспортного сервера-концентратора или пограничного транспортного сервера, который содержит соединитель приема.
|
||
MaxHeaderSize |
Необязательный |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Этот параметр указывает максимальный размер (в байтах) заголовка
сообщения SMTP, которое соединитель приема принимает перед
закрытием подключения. Значение по умолчанию:
Если единица измерения не задана, считается, что значение
указано в байтах. Диапазон допустимых значений данного
параметра – от |
||
MaxHopCount |
Необязательный |
System.Int32 |
Этот параметр указывает максимальное количество прыжков, которое
может выполнить сообщение до того, как оно будет отклонено
соединителем приема. Значение по умолчанию: Примечание. Максимальное количество
прыжков определяется количеством полей заголовков
|
||
MaxInboundConnection |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр задает максимальное количество входящих
подключений, которые одновременно обслуживает этот соединитель
приема. Значение по умолчанию: |
||
MaxInboundConnectionPercentagePerSource |
Необязательный |
System.Int32 |
Этот параметр задает максимальное количество подключений,
которое соединитель приема обслуживает одновременно с одного
IP-адреса, выраженное в процентах доступных оставшихся подключений
для соединителя приема. Введите значение как целое число без
символа процента (%). Значение по умолчанию: |
||
MaxInboundConnectionPerSource |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальное число подключений, которые
одновременно обслуживает соединитель приема с одного IP-адреса.
Значение по умолчанию: |
||
MaxLocalHopCount |
Необязательный |
System.Int32 |
Этот параметр указывает максимальное количество локальных
прыжков, которое может выполнить сообщение до того, как оно будет
отклонено соединителем приема. Значение по умолчанию:
|
||
MaxLogonFailures |
Необязательный |
System.Int32 |
Этот параметр указывает количество неудачных попыток входа,
выполняемых соединителем приема до закрытия подключения. Значение
по умолчанию: |
||
MaxMessageSize |
Необязательный |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Этот параметр задает максимальный размер сообщения. Значение по
умолчанию:
Если единица измерения не задана, считается, что значение указано в байтах. Диапазон допустимых значений этого параметра — от 1 до 2 147 483 647 байт. |
||
MaxProtocolErrors |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальное количество ошибок протокола
SMTP, принимаемых соединителем приема до закрытия подключения.
Значение по умолчанию: |
||
MaxRecipientsPerMessage |
Необязательный |
System.Int32 |
Этот параметр указывает максимальное количество получателей для
сообщения, принимаемое соединителем приема до закрытия подключения.
Значение по умолчанию: |
||
MessageRateLimit |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальное количество сообщений,
которые могут быть отправлены с одного клиентского IP-адреса в
минуту. Значение по умолчанию для соединителя приема, настроенного
на транспортном сервере-концентраторе, — |
||
PermissionGroups |
Необязательный |
Microsoft.Exchange.Data.PermissionGroups |
Этот параметр определяет группы и роли, которые могут отправлять
сообщения соединителю приема, и разрешения, назначаемые этим
группам. Группа разрешений – это предварительно определенный набор
разрешений, предоставляемый известным участникам безопасности.
Допустимы следующие значения этого параметра: |
||
PipeliningEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
ProtocolLoggingLevel |
Необязательный |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Этот параметр включает или отключает ведение журнала протокола
для заданного соединителя приема. Чтобы включить ведение журнала
протокола для соединителя, установите значение
|
||
RemoteIPRanges |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр определяет удаленные IP-адреса, с которых
соединитель принимает подключения. Синтаксис параметра:
<начальный_IP-адрес>-<конечный_IP-адрес>,
например: Значение параметра RemoteIPRanges необходимо указывать, если заданы следующие значения параметра Usage:
Несколько соединителей приема на одном сервере могут иметь перекрывающиеся диапазоны удаленных IP-адресов, если один диапазон полностью перекрывается другим. Если диапазоны удаленных IP-адресов перекрываются, используется диапазон удаленных IP-адресов, наиболее точно соответствующий IP-адресу подключающегося сервера. |
||
RequireEHLODomain |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
RequireTLS |
Необязательный |
System.Boolean |
Допустимыми значениями этого параметра являются
|
||
Server |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Этот параметр задает сервер, на котором необходимо создать соединитель приема. |
||
SizeEnabled |
Необязательный |
Microsoft.Exchange.Data.SizeMode |
Допустимые значения этого параметра — |
||
TarpitInterval |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Этот параметр указывает период задержки отклика SMTP удаленному серверу, который подозревается Exchange в злоупотреблении подключением. Подключения, для которых выполнена проверка подлинности, никогда не задерживаются таким образом. Значение по умолчанию равно 5 секундам. Значение должно
вводиться как интервал времени: дд.чч:мм:сс, где
дд — дни, чч — часы,
мм — минуты, а сс — секунды.
Диапазон допустимых значений данного параметра – от
|
||
TemplateInstance |
Необязательный |
System.Management.Automation.PSObject |
Когда в качестве значения этого параметра указывается существующий объект, команда использует конфигурацию этого объекта для создания его точной копии на локальном или целевом сервере. |
||
Usage |
Необязательный |
Microsoft.Exchange.Management.SystemConfigurationTasks.NewReceiveConnector+UsageType |
Этот параметр указывает группы разрешений по умолчанию и способы
проверки подлинности, назначенные этому соединителю приема. Для
параметра Usage допустимы следующие значения:
Значение параметра Bindings является обязательным, если указано какое-либо из следующих значений параметра Usage:
Значение параметра RemoteIPRanges является обязательным, если указано какое-либо из следующих значений параметра Usage:
Если не указать значение обязательного параметра, выполнение команды завершится неудачей. Командлет New-ReceiveConnector не запрашивает отсутствующие обязательные параметры. Дополнительные сведения о типах использования соединителя приема, группах разрешений и способах проверки подлинности см. в разделе Получающие соединители. |
Подробное описание
Командлет New-ReceiveConnector создает новый соединитель приема. Чтобы узнать обязательные параметры для нового соединителя приема, введите New-ReceiveConnector. Параметры Name, Bindings и RemoteIPRanges — обязательные параметры нового соединителя приема.
После выполнения этой задачи создается соединитель приема.
Для выполнения командлета New-ReceiveConnector используемой учетной записи необходимо делегировать следующее:
- роль администратора сервера Exchange и членство в локальной
группе администраторов на целевом сервере.
Чтобы выполнить командлет New-ReceiveConnector на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему с учетной записью, входящей в локальную группу администраторов на этом компьютере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Пример
Команда New-ReceiveConnector создает соединитель приема. В примере приведены минимальные параметры, необходимые для создания соединителя приема.
Примечание. |
---|
Невозможно создать несколько соединителей приема с одинаковыми параметрами Bindings и RemoteIPRanges. |
Копировать код | |
---|---|
New-ReceiveConnector -Name Test -Bindings 10.10.1.1:25 -RemoteIPRanges 192.168.0.1-192.168.0.24 |