Поделиться через


Командлет Set-IMAPSettings (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-11

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

Синтаксис

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

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

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

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

  • роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

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

Параметры

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

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.

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

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

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

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: только форматированный текст

  • 4:UUEncode

  • 5:UUEncodeBinHex

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

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-подключение или нешифрованное подключение.

X509CertificateName

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

System.String

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953