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

Синтаксис

Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-Instance <Imap4AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

Параметры

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

AuthenticatedConnectionTimeout

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

Microsoft.Exchange.Data.EnhancedTimeSpan

Данный параметр указывает период времени ожидания перед закрытием неиспользуемого подключения, подлинность которого проверена. Значение параметра по умолчанию равно 1800 секундам. Возможные значения находятся в диапазоне от 30 до 86 400 секунд.

Banner

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

System.String

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

CalendarItemRetrievalOption

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

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

  • 0. Calendar

  • 1. IntranetUrl

  • 2. InternetUrl

  • 3. Custom

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

Confirm

Дополнительно

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, получающего данные из службы каталогов Active Directory, включите в команду параметр DomainController.

EnableExactRFC822Size

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

System.Boolean

Параметр EnableExactRFC822Size позволяет возвращать правильное значение RFC822.SIZE каждого сообщения электронной почты в почтовом ящике.

По умолчанию Exchange 2007 лишь оценивает значение RFC822.SIZE, поскольку для его точного определения Exchange 2007 должен перестроить MIME. Перестройка MIME может привести к снижению производительности, если почтовый ящик содержит сообщения большого размера или с большой степенью вложенности. Однако некоторым клиентам электронной почты требуется точное значение RFC822.SIZE, а не его оценка.

Вычисление точного размера для всех пользователей включается с помощью следующей команды:

Set-ImapSettings -EnableExactRFC822Size:$true

Вычисление точного размера только для определенного пользователя включается с помощью следующей команды:

Set-CASMailbox <IMAP_User_Name> -ImapUseProtocolDefaults:$false -ImapEnableExactRFC822Size:$true

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

С помощью параметра Instance можно указать экземпляр объекта Active Directory, который передается по конвейеру и используется данной командой.

LoginType

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

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

  • 1. PlainTextLogin

  • 2. PlainTextAuthentication

  • 3. SecureLogin

MaxCommandSize

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

System.Int32

Этот параметр определяет максимальный размер одиночной команды. Размер по умолчанию составляет 10 240 байт. Возможные значения находятся в диапазоне от 1024 до 16 384 байт.

MaxConnectionFromSingleIP

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

System.Int32

Этот параметр задает число подключений, принимаемых сервером с одного IP-адреса. Значение по умолчанию равно 20. Возможные значения находятся в диапазоне от 1 до 1000.

MaxConnections

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

System.Int32

Этот параметр задает общее число подключений, принимаемых указанным сервером. Это значение включает подключения, прошедшие проверку подлинности, и подключения, не прошедшие проверку подлинности. Значение по умолчанию составляет 2000 подключений. Возможные значения находятся в диапазоне от 1 до 25 000 байт.

MaxConnectionsPerUser

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

System.Int32

Этот параметр задает максимальное число подключений, принимаемых сервером клиентского доступа от конкретного пользователя. Значение по умолчанию равно 10. Возможные значения находятся в диапазоне от 1 до 1000.

MessageRetrievalMimeFormat

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

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

  • 0. Только текст

  • 1. Только HTML

  • 2. HTML и текст

  • 3. Только в формате RTF

  • 4: наилучший формат для текста сообщения

OwaServerUrl

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

System.String

Данный параметр определяет сервер клиентского доступа, с которого считываются данные календаря, например, элементы пользовательского календаря Outlook Web Access.

PreAuthenticatedConnectionTimeout

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

Microsoft.Exchange.Data.EnhancedTimeSpan

Данный параметр указывает период времени ожидания перед закрытием неиспользуемого подключения, подлинность которого не проверена. Значение параметра по умолчанию равно 60 секундам. Возможные значения находятся в диапазоне от 10 до 3600 секунд.

ProxyTargetPort

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

System.Int32

Данный параметр указывает порт на фоновом сервере Exchange Server 2003, на который служба IMAP4 на сервере клиентского доступа будет ретранслировать команды.

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

ShowHiddenFoldersEnabled

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

System.Boolean

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

SSLBindings

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

Microsoft.Exchange.Data.MultiValuedProperty

Если этот параметр задан, командлет возвращает IP-порт для использования при связи в течение SSL-сеанса.

UnencryptedOrTLSBindings

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр указывает IP-порт для связи через шифрованное TLS-подключение или нешифрованное подключение.

WhatIf

Дополнительно

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

X509CertificateName

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

System.String

Этот параметр указывает имя узла в SSL-сертификате из поля Связанный объект.

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

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

Для выполнения командлета Set-IMAPSettings используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере кода задается IP-адрес для TLS-подключения на сервере клиентского доступа с именем CAS01.

Копировать код
Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953