Командлет Set-ReceiveConnector используется для изменения существующего получающего соединителя на компьютере с установленной ролью пограничного транспортного сервера или узлового транспорта.
Синтаксис
Set-ReceiveConnector -Identity <ReceiveConnectorIdParameter> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]] |
Set-ReceiveConnector [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-Instance <ReceiveConnector>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]] |
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
Этот параметр указывает идентификатор GUID или имя соединителя, представляющего соединитель получения. Метка Identity может быть пропущена. |
||
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 должны соответствовать одному из указанных ниже требований уникальности.
|
||
ChunkingEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
Comment |
Необязательный |
System.String |
Необходимо заключить параметр Comment в двойные кавычки,
например: |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется. |
||
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 |
Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с ролью пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет запись только в локальный экземпляр ADAM. |
||
DomainSecureEnabled |
Необязательный |
System.Boolean |
Этот параметр является первым этапом процесса включения взаимной проверки подлинности TLS для доменов, обслуживаемых этим соединителем получения. Взаимная проверка подлинности TLS правильно работает только при выполнении следующих условий:
По умолчанию, параметр DomainSecureEnabled имеет значение
По умолчанию параметр DomainSecureEnabled имеет значение
|
||
EightBitMimeEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
EnableAuthGSSAPI |
Необязательный |
System.Boolean |
Этот параметр контролирует объявление способа проверки
подлинности GSSAPI, если на соединителе включена встроенная
проверка подлинности Windows. Если параметр AuthMechanism
содержит значение Если используются серверы обмена сообщениями Microsoft IIS,
проходящие проверку подлинности для данного соединителя приема,
параметру EnableAuthGSSAPI следует присвоить значение
Описываемый параметр может иметь значения |
||
Enabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
EnhancedStatusCodesEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
Fqdn |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Этот параметр определяет полное доменное имя сервера назначения для подключенных серверов обмена сообщениями, использующих данный соединитель приема для отправки входящих сообщений. Значение этого параметра отображается для подключенных серверов обмена сообщениями, когда требуется имя сервера назначения, например:
Значением по умолчанию параметра Fqdn является полное доменное имя транспортного сервера-концентратора или пограничного транспортного сервера, который содержит соединитель приема.
|
||
Instance |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector |
Этот параметр используется, чтобы передать весь объект в команду для обработки. Он обычно используется в сценариях, где целый объект должен быть отправлен команде. |
||
LongAddressesEnabled |
Необязательный |
System.Boolean |
Этот параметр позволяет соединителю приема принимать длинные почтовые адреса X.400. Почтовые адреса X.400 инкапсулируются в почтовые адреса SMTP с использованием способа инкапсуляции IMCEA (Internet Mail Connector Encapsulated Address). Если данный параметр имеет значение Если он имеет значение
Таким образом, после инкапсуляции IMCEA почтовые адреса X.400 могут включать до 1860 знаков. Описываемый параметр может иметь значения |
||
MaxHeaderSize |
Необязательный |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Этим параметром указывается максимальный размер (в байтах)
заголовка сообщения SMTP, которое соединитель получения принимает
перед тем, как закрыть подключение. Значение по умолчанию:
Значение без указания единицы измерения обрабатывается как
количество байт. Допустимый диапазон значений данного
параметра – от |
||
MaxHopCount |
Необязательный |
System.Int32 |
Этот параметр указывает максимально допустимое количество
прыжков, которое может выполнить сообщение до того, как оно будет
отклонено соединителем получения. Максимальное количество прыжков
определяется количеством заголовков |
||
MaxInboundConnection |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр MaxInboundConnection указывает максимальное
количество входящих подключений, которые одновременно обслуживает
получающий соединитель. Значение по умолчанию: |
||
MaxInboundConnectionPercentagePerSource |
Необязательный |
System.Int32 |
Этот параметр указывает максимальное число подключений, которые
одновременно обслуживает соединитель получения с одного IP-адреса.
Значение выражается в виде процента доступных оставшихся
подключений для получающего соединителя. Введите значение как целое
число без символа процента (%). Значение по умолчанию: 2 процента.
Допустимый диапазон значений данного параметра – от
|
||
MaxInboundConnectionPerSource |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этим параметром указывает максимальное число входных
подключений, которые одновременно обслуживает соединитель получения
с одного IP-адреса. Значение по умолчанию: |
||
MaxLocalHopCount |
Необязательный |
System.Int32 |
Этим параметром указывается максимальное допустимое количество
локальных прыжков, которое может выполнить сообщение до того, как
оно будет отклонено соединителем получения. Максимальное количество
локальных прыжков определяется количеством заголовков
|
||
MaxLogonFailures |
Необязательный |
System.Int32 |
Этим параметром указывается количество неудачных попыток входа,
выполняемых соединителем получения до того, как подключение будет
закрыто. Значение по умолчанию: |
||
MaxMessageSize |
Необязательный |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Этот параметр указывает максимальный размер сообщения. Значение
по умолчанию:
Число без указания единицы измерения обрабатывается как количество байт. Допустимый диапазон значений этого параметра — от 65 536 до 2 147 483 647 байт. |
||
MaxProtocolErrors |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальное количество ошибок протокола
SMTP, принимаемых соединителем получения до закрытия подключения.
Значение по умолчанию: |
||
MaxRecipientsPerMessage |
Необязательный |
System.Int32 |
Параметр MaxRecipientsPerMessage указывает максимальное
количество получателей для сообщения, принимаемое принимающим
соединителем до того, как подключение будет закрыто. Значение по
умолчанию: |
||
MessageRateLimit |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальное количество сообщений,
которые могут быть отправлены с одного клиентского IP-адреса в
минуту. Значением по умолчанию для соединителя получения,
настроенного на транспортном сервере-концентраторе, является
|
||
Name |
Необязательный |
System.String |
Этот параметр указывает имя соединителя, переданное
администратором. Значение параметра Name вводится в виде
строки, как показано в следующем примере: |
||
OrarEnabled |
Необязательный |
System.Boolean |
Этот параметр включает функцию ORAR (Originator Requested
Alternate Recipient). Если он имеет значение Описываемый параметр может иметь значения |
||
PermissionGroups |
Необязательный |
Microsoft.Exchange.Data.PermissionGroups |
Этот параметр определяет группы и роли, которые могут отправлять
сообщения соединителю приема, и разрешения, назначаемые этим
группам. Группа разрешений – это предварительно определенный набор
разрешений, предоставляемый известным участникам безопасности.
Допустимы следующие значения этого параметра: |
||
PipeliningEnabled |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
ProtocolLoggingLevel |
Необязательный |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Этот параметр включает или отключает ведение журнала протокола
для заданного соединителя получения. Чтобы включить ведение журнала
протокола для соединителя, необходимо установить значение
|
||
RemoteIPRanges |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр определяет удаленные IP-адреса, с которых
соединитель принимает подключения. Синтаксис параметра:
<начальный IP-адрес>-<конечный IP-адрес>,
например Несколько соединителей приема на одном сервере могут иметь перекрывающиеся диапазоны удаленных IP-адресов, если один диапазон полностью перекрывается другим. Когда диапазоны удаленных IP-адресов перекрываются, используется диапазон удаленных IP-адресов, наиболее точно соответствующий IP-адресу соединяющего сервера. |
||
RequireEHLODomain |
Необязательный |
System.Boolean |
Допустимые значения этого параметра: |
||
RequireTLS |
Необязательный |
System.Boolean |
Допустимыми значениями этого параметра являются
|
||
SizeEnabled |
Необязательный |
Microsoft.Exchange.Data.SizeMode |
Допустимые значения этого параметра — |
||
TarpitInterval |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Параметр TarpitInterval указывает период задержки
SMTP-ответа удаленному серверу, который подозревается Exchange в
злоупотреблении подключением. Авторизованные подключения никогда не
задерживаются таким образом. Значение по умолчанию: 5 секунд.
Указываемое значение должно вводиться как интервал времени:
чч:мм:сс, где ч — часы,
м — минуты, а с — секунды.
Допустимый диапазон значений данного параметра – от
|
||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
Подробное описание
Командлет Set-ReceiveConnector изменяет существующий получающий соединитель. Параметр Identity является обязательным при выполнении командлета Set-ReceiveConnector.
После выполнения этой задачи получающий соединитель изменяется.
Для выполнения командлета Set-ReceiveConnector используемой учетной записи необходимо делегировать следующие роли:
- роль администратора сервера Exchange и членство в локальной
группе администраторов на целевом сервере.
Чтобы выполнить командлет Set-ReceiveConnector на компьютере, на котором установлена роль пограничного транспортного сервера, следует войти в систему с помощью учетной записи, которая является членом локальной группы администраторов на данном компьютере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Пример
В следующем примере команды Set-ReceiveConnector
для параметра Banner задается значение "220 Banner
Text here"
, для параметра ConnectionTimeOut —
значение 00:15:00
.
Копировать код | |
---|---|
Set-ReceiveConnector -Identity "Internet Receive Connector" -Banner "220 Banner Text here" -ConnectionTimeout 00:15:00 |