Set-ReceiveConnector (окончательная первоначальная версия)
Применимо к: Exchange Server 2007 SP1, Exchange Server 2007
Последнее изменение раздела: 2007-07-23
Командлет 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>] [-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>] [-Name <String>] [-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>]
Set-ReceiveConnector [-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>] [-Instance <ReceiveConnector>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-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>]
Подробное описание
Командлет Set-ReceiveConnector изменяет существующий соединитель приема. Параметр Identity является обязательным при выполнении командлета Set-ReceiveConnector.
После выполнения этой задачи соединитель приема изменяется.
Для выполнения командлета Set-ReceiveConnector используемой учетной записи необходимо делегировать следующее:
- роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.
Для выполнения командлета Set-ReceiveConnector на компьютере с установленной ролью пограничного транспортного сервера необходимо войти в систему с учетной записью, которая является членом локальной группы администраторов на данном компьютере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
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 в прямые кавычки, например: |
||
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 является полное доменное имя транспортного сервера-концентратора или пограничного транспортного сервера, который содержит соединитель приема.
|
||
Instance |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector |
Используйте этот параметр, чтобы передать команде для обработки весь объект. Он обычно используется в сценариях, где целый объект должен быть передан команде. |
||
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 |
Этот параметр задает максимальный размер сообщения. Значением параметра MaxMessageSize должно быть целое число. Значение по умолчанию —
Если единица измерения не задана, считается, что значение указано в байтах. Диапазон допустимых значений этого параметра — от 1 до 2 147 483 647 байт. |
||
MaxProtocolErrors |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальное количество ошибок протокола SMTP, принимаемых соединителем приема до закрытия подключения. Значение по умолчанию — |
||
MaxRecipientsPerMessage |
Необязательный |
System.Int32 |
Параметр MaxRecipientsPerMessage указывает максимальное количество получателей для сообщения, принимаемое соединителем приема до закрытия подключения. Значение по умолчанию — |
||
MessageRateLimit |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальное количество сообщений, которые могут быть отправлены с одного клиентского IP-адреса в минуту. Значение по умолчанию для соединителя приема, настроенного на транспортном сервере-концентраторе, — |
||
Name |
Необязательный |
System.String |
Этот параметр указывает имя соединителя, заданное администратором. Значение параметра Name вводится в виде строки, как показано в следующем примере: |
||
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 секундам. Значение должно вводиться как интервал времени: чч:мм:сс, где ч — часы, м — минуты, а с — секунды. Диапазон допустимых значений данного параметра – от |
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Пример
В следующем примере команды
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