Есть предложения? Экспорт (0) Печать
Развернуть все
Свернуть оглавление
Развернуть оглавление
Развернуть Свернуть

Set-IMAPSettings

 

Applies to: Exchange Server 2016

Этот командлет доступен только в локальной Exchange Server 2016.

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

Сведения о наборах параметров в разделе "Синтаксис" ниже см. в статье Exchange cmdlet syntax.

Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-EnableGSSAPIAndNTLMAuth <$true | $false>] [-EnforceCertificateErrors <$true | $false>] [-ExtendedProtectionPolicy <None | Allow | Require>] [-ExternalConnectionSettings <MultiValuedProperty>] [-InternalConnectionSettings <MultiValuedProperty>] [-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>]

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

Set-ImapSettings -Server "MBX01" -UnencryptedOrTLSBindings 10.0.0.0:995

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

Set-ImapSettings -ProtocolLogEnabled $true -LogFileLocation "C:\Imap4Logging"

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

Set-ImapSettings -LogPerFileSizeQuota 2000000

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

Set-ImapSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly

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

Для запуска этого командлета необходимо получить соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в статье Запись "Параметры IMAP4" в разделе Разрешения клиентов и мобильных устройств.

 

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

AuthenticatedConnectionTimeout

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

Microsoft.Exchange.Data.EnhancedTimeSpan

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

Чтобы указать значение, введите его как промежуток времени: дд.чч:мм:сс, где дд = дни, чч = часы, мм = минуты и сс = секунды.

Для этого параметра допускается диапазон значений от 00:00:30 до 1:00:00. Значение по умолчанию — 00:30:00 или 30 минут.

Banner

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

System.String

Параметр Banner указывает текстовую строку, отображаемую после установления подключения IMAP4. Значение по умолчанию: The Microsoft Exchange IMAP4 service is ready..

CalendarItemRetrievalOption

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

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

  • 0 или iCalendar

  • 1 или intranetUrl

  • 2 или InternetUrl

  • 3 или Custom

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

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm указывает, необходимо ли показать запрос на подтверждение или скрыть его. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение для продолжения.

  • В разрушительных командлетах (например, Remove-*) предусмотрена пауза, которая включается, когда необходимо подтвердить команду для продолжения работы. Вот точный синтаксис, который необходимо использовать, чтобы пропустить запрос на подтверждение для этих командлетов: -Confirm:$false.

  • В большинстве командлетов (например, New-* и Set-*) не предусмотрена пауза. Для этих командлетов можно указать параметр Confirm без значения. В таком случае будет добавлена пауза для подтверждения команды перед продолжением.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает контроллер домена, который используется этим командлетом для считывания и записи данных в Служба каталогов Active Directory. Контроллер домена определяется по его полному доменному имени (FQDN). Например, dc01.contoso.com.

EnableExactRFC822Size

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

System.Boolean

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

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

EnableGSSAPIAndNTLMAuth

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

System.Boolean

Параметр EnableGSSAPIAndNTLMAuth указывает, могут ли подключения использовать встроенную проверку подлинности Windows (NTLM) с помощью программного интерфейса Generic Security Services (GSSAPI). Этот параметр применяется к подключениям, для которых отключен протокол Transport Layer Security (TLS). По умолчанию для этого параметра установлено значение $true. Отключить NTLM для подключений IMAP4 можно, установив для этого параметра значение $false. Поддержка проверки подлинности NTLM для подключений IMAP4 доступна в Exchange 2010 с пакетом обновления 1 (SP1) или более поздней версии.

EnforceCertificateErrors

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

System.Boolean

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

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

ExtendedProtectionPolicy

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ExtendedProtectionTokenCheckingMode

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

  • None   Расширенная защита для проверки подлинности не будет использоваться.

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

  • Require   Расширенная защита для проверки подлинности будет требоваться для всех подключений IMAP4. Если подключающийся узел не поддерживает расширенную защиту для проверки подлинности, подключение будет отклонено.

Расширенная защита для проверки подлинности повышает уровень защиты и качество обработки учетных данных при проверке подлинности сетевых подключений, устанавливаемых с использованием встроенной проверки подлинности Windows. Встроенная проверка подлинности Windows также называется NTLM. При использовании встроенной проверки подлинности Windows настоятельно рекомендуется использовать расширенную защиту для проверки подлинности. Для использования расширенной защиты для проверки пользователя компьютер-клиент и компьютер-сервер должны удовлетворять определенным требованиям. К ним относятся требования к операционной системе и требования к обновлениям безопасности. Помимо этого, клиентская программа IMAP4 должна поддерживать использование расширенной защиты для проверки подлинности.

ExternalConnectionSettings

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

Microsoft.Exchange.Data.MultiValuedProperty

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

Введите значение в следующем формате: <HostName>:<Port>:[<TLS | SSL>]. Значение типа шифрования необязательно.

Чтобы вводить несколько значений и перезаписывать существующие записи, используйте следующий синтаксис: <значение1>,<значение2>.... Если значения содержат пробелы или требуют кавычек по другой причине, используйте следующий синтаксис: "<значение1>","<значение2>"....

Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="<значение1>","<значение2>"...; Remove="<значение1>","<значение2>"...}.

InternalConnectionSettings

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

Microsoft.Exchange.Data.MultiValuedProperty

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

По умолчанию для этого параметра установлено значение <ServerFQDN>:993:SSL,<ServerFQDN>:143:TLS.

LogFileLocation

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

System.String

Параметр LogFileLocation указывает расположение файлов журнала протокола IMAP4. Расположение по умолчанию: %ExchangeInstallPath%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 указывает метод проверки подлинности для подключений IMAP4. Допустимые значения:

  • 1 или PlainTextLogin.

  • 2 или PlainTextAuthentication.

  • 3 или SecureLogin. Это значение по умолчанию.

LogPerFileSizeQuota

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

Microsoft.Exchange.Data.Unlimited

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

MaxCommandSize

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

System.Int32

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

MaxConnectionFromSingleIP

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

System.Int32

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

MaxConnections

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

System.Int32

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

MaxConnectionsPerUser

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

System.Int32

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

MessageRetrievalMimeFormat

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Параметр MessageRetrievalMimeFormat указывает кодировку MIME для сообщений. Допустимые значения:

  • 0 или TextOnly.

  • 1 или HtmlOnly.

  • 2 или HtmlAndTextAlternative.

  • 3 или TextEnrichedOnly.

  • 4 или TextEnrichedAndTextAlternative.

  • 5 или BestBodyFormat. Это значение по умолчанию.

  • 6 или Tnef.

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

OwaServerUrl

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

System.Uri

Параметр OwaServerUrl указывает, где можно получить данные календаря для экземпляров пользовательских элементов календаря Outlook в Интернете.

PreAuthenticatedConnectionTimeout

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

Microsoft.Exchange.Data.EnhancedTimeSpan

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

Чтобы указать значение, введите его как промежуток времени: дд.чч:мм:сс, где дд = дни, чч = часы, мм = минуты и сс = секунды.

Допустимы значения от 00:00:30 до 1:00:00. Значение по умолчанию — 00:01:00 (одна минута).

ProtocolLogEnabled

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

System.Boolean

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

ProxyTargetPort

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

System.Int32

Параметр ProxyTargetPort указывает порт внутренней службы IMAP4 Microsoft Exchange, ожидающий передачи данных от клиентов, которые передаются из службы IMAP4 Microsoft Exchange. По умолчанию значение равно 1993.

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server определяет сервер Exchange, на котором следует выполнить эту команду. Можно использовать любое уникальное значение, определяющее сервер. Например:

  • Имя

  • Полное доменное имя

  • Различающееся имя

  • Устаревшее различающееся имя Exchange

Если вы не используете этот параметр, команда выполняется на локальном сервере.

ShowHiddenFoldersEnabled

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

System.Boolean

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

SSLBindings

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

Microsoft.Exchange.Data.MultiValuedProperty

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

SuppressReadReceipt

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

System.Boolean

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

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

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

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

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

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

UnencryptedOrTLSBindings

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

Microsoft.Exchange.Data.MultiValuedProperty

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

X509CertificateName

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

System.String

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

Типы ввода, поддерживаемые этим командлетом, см. в разделе Типы ввода и вывода командлета. Если поле "Тип ввода" для командлета пустое, этот командлет не поддерживает ввод данных.

Типы возврата (также называемые типами вывода), поддерживаемые этим командлетом, см. в разделе Типы ввода и вывода командлета. Если поле "Тип вывода" пустое, командлет не возвращает данные.

 
Показ:
© 2016 Microsoft