Командлет 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. Возможны следующие значения.
При использовании значения «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. Возможные значения:
|
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 |
Этот параметр указывает формат сообщений, полученных с сервера. Возможные значения:
|
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 |
Если этот параметр задан, будут видны скрытые папки. Значение по
умолчанию: |
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 |