Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Командлет Set-ImapSettings используется для задания определенных параметров протокола IMAP4 для сервера под управлением Microsoft Exchange Server 2010 с установленной ролью сервера клиентского доступа и запущенной службой Microsoft Exchange IMAP4. 

Синтаксис

Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-EnforceCertificateErrors <$true | $false>] [-ExternalConnectionSettings <MultiValuedProperty>] [-InternalConnectionSettings <MultiValuedProperty>] [-LiveIdBasicAuthReplacement <$true | $false>] [-LogFileLocation <String>] [-LogFileRollOverSettings <Hourly | Daily | Weekly | Monthly>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-LogPerFileSizeQuota <Unlimited>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-OwaServerUrl <Uri>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProtocolLogEnabled <$true | $false>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-SuppressReadReceipt <$true | $false>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

Параметры

Параметр Обязательность Тип Описание

AuthenticatedConnectionTimeout

Необязательный

Microsoft.Exchange.Data.EnhancedTimeSpan

Параметр AuthenticatedConnectionTimeout указывает период времени ожидания перед закрытием неиспользуемого подключения, подлинность которого проверена. По умолчанию установлено значение 1800 секунд. Диапазон возможных значений: от 30 до 86400 секунд.

Banner

Необязательный

System.String

Параметр Banner указывает строку заголовка, которая отображается после создания подключения к серверу клиентского доступа.

CalendarItemRetrievalOption

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

Параметр CalendarItemRetrievalOption указывает тип элемента календаря, который возвращается при обращении к календарю по протоколу IMAP4. Возможны следующие значения:

  • 0:iCalendar

  • 1:IntranetUrl

  • 2:InternetUrl

  • 3:Custom

При использовании значения «3. Custom» необходимо указать параметр OWAServerUrl.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

EnableExactRFC822Size

Необязательный

System.Boolean

Параметр EnableExactRFC822Size позволяет вычислить точный размер каждого сообщения MIME, которое может быть получено с сервера. Если для этого параметра установлено значение $true, точный размер сообщений MIME, хранящихся на сервере Exchange, становится доступным для клиентских программ POP3 или IMAP4, для работы которых необходимы эти сведения.

Примечание.
По умолчанию для этого параметра установлено значение $false. Если для этого параметра не установлено значение $true, размер каждого сообщения MIME, который сервер Exchange возвращает клиентским программам POP3 и IMAP4, может незначительно отличаться от точного значения. Так как установка для этого параметра значения $true может снизить производительность, его следует использовать только в том случае, если многие пользователи работают с клиентом, требующим точный размер сообщений MIME.

EnforceCertificateErrors

Необязательный

System.Boolean

Параметр EnforceCertificateErrors указывает, следует ли принудительно применять допустимые сертификаты SSL (Secure Sockets Layer). Чтобы использовать этот параметр, укажите сервер клиентского доступа назначения, для которого необходимо применить допустимые сертификаты SSL. Если для параметра EnforceCertificateErrors указано значение $true, а целевой сертификат прокси-сервера недопустим, вход на прокси-сервер будет невозможен.

Значение по умолчанию — $false.

ExternalConnectionSettings

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ExternalConnectionSettings указывает имя узла, порт и тип шифрования, которые использует Exchange при подключении IMAP4-клиентов, находящихся вне корпоративной сети, к своей электронной почте.

Введите значение в следующем формате: <Имя_узла>:<Порт>:<Тип шифрования>. Компонент многозначного значения <Тип шифрования> является необязательным. Для параметра <Тип шифрования> допустимыми значениями являются TLS (Transport Layer Security) или SSL.

InternalConnectionSettings

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр InternalConnectionSettings указывает имя узла, порт и тип шифрования, которые используются при подключении IMAP4-клиентов, находящихся в корпоративной сети, к своей электронной почте. Этот параметр также используется для указания имени узла, порта и типа шифрования при переадресации подключения пользователя на другой сервер клиентского доступа.

Введите значение в следующем формате: <Имя_узла>:<Порт>: <Тип шифрования>. Компонент многозначного значения <Тип шифрования> является необязательным. Для параметра <Тип шифрования> допустимыми значениями являются TLS или SSL.

LiveIdBasicAuthReplacement

Необязательный

System.Boolean

LogFileLocation

Необязательный

System.String

Параметр LogFileLocation указывает расположение файлов журнала протокола IMAP4. По умолчанию файлы журнала протокола IMAP4 расположены в каталоге C:\Program Files\Microsoft\Exchange Server\V14\Logging\Imap4.

LogFileRollOverSettings

Необязательный

Microsoft.Exchange.Diagnostics.LogFileRollOver

Параметр LogFileRollOverSettings определяет, как часто в ходе ведения журнала протокола IMAP4 создаются новые файлы журналов. По умолчанию новый файл журнала создается каждый час. Возможные значения:

  • 1:Hourly

  • 2:Daily

  • 3:Weekly

  • 4:Monthly

Этот параметр применяется только в случае, если параметр LogPerFileSizeQuota имеет значение 0.

LoginType

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

Параметр LoginType указывает параметр проверки подлинности, который используется для сервера клиентского доступа под управлением службы Microsoft Exchange IMAP4. Возможные значения:

  • 1:PlainTextLogin

  • 2:PlainTextAuthentication

  • 3:SecureLogin

LogPerFileSizeQuota

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр LogPerFileSizeQuota указывает максимальный размер файла журнала протокола IMAP4 в байтах. По умолчанию для этого параметра установлено значение 0. Если значение равно 0, то новые файлы журнала протокола создаются с частотой, заданной параметром LogFileRollOverSettings.

MaxCommandSize

Необязательный

System.Int32

Параметр MaxCommandSize указывает максимальный размер одиночной команды. Размер по умолчанию — 40 байт. Диапазон возможных значений: от 40 до 1024 байт.

MaxConnectionFromSingleIP

Необязательный

System.Int32

Параметр MaxConnectionFromSingleIP указывает число подключений, принимаемых указанным сервером с одного IP-адреса. Значение по умолчанию — 2000. Диапазон возможных значений: от 1 до 25000.

MaxConnections

Необязательный

System.Int32

Параметр MaxConnections указывает общее число подключений, принимаемых определенным сервером. Это значение включает подключения, прошедшие проверку подлинности, и подключения, не прошедшие проверку подлинности. Размер по умолчанию — 2000. Диапазон возможных значений: от 1 до 25000.

MaxConnectionsPerUser

Необязательный

System.Int32

Параметр MaxConnectionsPerUser указывает максимальное число подключений, принимаемых сервером клиентского доступа от отдельного пользователя. Значение по умолчанию — 16. Диапазон возможных значений: от 1 до 25000.

MessageRetrievalMimeFormat

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Параметр MessageRetrievalMimeFormat указывает формат сообщений, получаемых с сервера. Возможные значения:

  • 0:TextOnly

  • 1:HtmlOnly

  • 2:HtmlAndTextAlternative

  • 3:TextEnrichedOnly

  • 4:TextEnrichedAndTextAlternative

  • 5:BestBodyFormat

  • 6:Tnef

OwaServerUrl

Необязательный

System.Uri

Параметр OwaServerUrl указывает сервер клиентского доступа, с которого считываются данные календаря для экземпляров элементов пользовательского календаря Microsoft Office Outlook Web App.

PreAuthenticatedConnectionTimeout

Необязательный

Microsoft.Exchange.Data.EnhancedTimeSpan

Параметр PreAuthenticatedConnectionTimeout указывает период времени, по истечении которого простаивающее подключение, не прошедшее проверку подлинности, будет закрыто. По умолчанию установлено значение 60 секунд. Диапазон возможных значений: от 10 до 3600 секунд.

ProtocolLogEnabled

Необязательный

System.Boolean

Параметр ProtocolLogEnabled указывает, включено ли ведение журнала протокола. Дополнительные сведения см. в разделе Настройка ведения журнала для протоколов POP3 и IMAP4

ProxyTargetPort

Необязательный

System.Int32

Параметр ProxyTargetPort указывает порт на фоновом сервере Exchange Server 2003, которому служба Microsoft Exchange IMAP4, работающая на сервере клиентского доступа, ретранслирует команды.

Server

Необязательный

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server указывает отдельный сервер клиентского доступа в организации, для которого задаются параметры IMAP4.

ShowHiddenFoldersEnabled

Необязательный

System.Boolean

Параметр ShowHiddenFoldersEnabled указывает, являются ли скрытые папки видимыми. Если значение этого параметра равно $true, скрытые папки будут видны. Значение по умолчанию: $false.

SSLBindings

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр SSLBindings указывает, задает ли команда IP-адрес и номер порта, используемые для связи в сеансе SSL. Это многозначное свойство. Введите значение в следующем формате: <IP-адрес>:<Номер порта>.

SuppressReadReceipt

Необязательный

System.Boolean

Параметр SuppressReadReceipt указывает, следует ли останавливать отправку дублирующихся уведомлений о прочтении отправителям IMAP4, использующим в своей почтовой программе IMAP4 параметр отправлять уведомления о прочтении отправляемых сообщений. По умолчанию этому параметру присвоено значение $false. По умолчанию отправители IMAP4, использующие параметр отправлять уведомления о прочтении отправляемых сообщений, получают уведомления о прочтении в следующих условиях:

  • Когда отправленные ими сообщения загружаются получателем.

  • Когда получатель открывает сообщение.

Допустимые значения этого параметра:

  • $false   Уведомление о прочтении отправляется пользователям IMAP4 при каждой загрузке сообщения получателем. Уведомление о прочтении также отправляется пользователям IMAP4 при открытии сообщения.

  • $true   Уведомления о прочтении отправляются пользователям IMAP4, использующим в своей почтовой программе параметр отправлять уведомления о прочтении отправляемых сообщений, только при открытии сообщения получателем.

UnencryptedOrTLSBindings

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр UnencryptedOrTLSBindings указывает IP-адрес и номер порта для связи через шифрованное TLS-подключение или незашифрованное подключение. Это многозначное свойство. Введите значение в следующем формате: <IP-адрес>:<Номер порта>.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

X509CertificateName

Необязательный

System.String

Параметр X509CertificateName указывает имя узла в SSL-сертификате из поля Связанный субъект. Это многозначное свойство, которое содержит IP-адрес и параметр порта. Введите значение в следующем формате: <IP-адрес>:<Номер порта>.

Подробное описание

Командлет Set-ImapSettings можно запускать для одного сервера клиентского доступа с установленной службой Microsoft Exchange IMAP4 или для всех серверов клиентского доступа Exchange, на которых установлена служба Microsoft Exchange IMAP4.

Дополнительные сведения см. в разделе Настройка IP-адресов и портов для доступа по протоколам POP3 и IMAP4

Запись «Параметры IMAP4» в разделе Разрешения клиентского доступа. 

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Примеры

ПРИМЕР 1

В этом примере для сервера клиентского доступа с именем CAS01 задается обычный текст или TLS-подключение. В этом примере для подключения используется IP-адрес 10.0.0.0 и номер порта 995.

Скопировать код 
Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings 10.0.0.0:995

ПРИМЕР 2

В этом примере включается ведение журнала протокола IMAP4. В нем также задается каталог журнала протокола IMAP4: C:\Imap4Logging.

Скопировать код 
Set-ImapSettings -ProtocolLogEnabled $true -LogFileLocation "C:\Imap4Logging"

ПРИМЕР 3

В этом примере для ведения журнала протокола IMAP4 задается создание новых файлов журнала по достижении размера 2 МБ.

Скопировать код 
Set-ImapSettings -LogPerFileSizeQuota 2000000

ПРИМЕР 4

В этом примере для ведения журнала протокола IMAP4 задается создание новых файлов журнала каждый час.

Скопировать код 
Set-ImapSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly