Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет Set-PopSettings позволяет указывать параметры протокола POP3 для сервера Microsoft Exchange Server 2010 с установленной ролью сервера клиентского доступа и работающей службой Microsoft Exchange POP3.
Синтаксис
Set-PopSettings [-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>]
[-MessageRetrievalSortOrder <Ascending | Descending>]
[-OwaServerUrl <Uri>] [-PreAuthenticatedConnectionTimeout
<EnhancedTimeSpan>] [-ProtocolLogEnabled <$true |
$false>] [-ProxyTargetPort <Int32>] [-Server
<ServerIdParameter>] [-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 указывает тип элемента календаря, который возвращается при обращении к календарю по протоколу POP3. Возможны следующие значения:
При использовании значения «3. Custom» необходимо указать параметр OWAServerUrl. |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
|||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
|||
EnableExactRFC822Size |
Необязательный |
System.Boolean |
Параметр EnableExactRFC822Size позволяет вычислить точный
размер каждого сообщения MIME, которое может быть получено с
сервера. Если для этого параметра установлено значение
|
||
EnforceCertificateErrors |
Необязательный |
System.Boolean |
Параметр EnforceCertificateErrors указывает, следует ли
принудительно применять допустимые сертификаты SSL (Secure Sockets
Layer). Чтобы использовать этот параметр, укажите сервер
клиентского доступа назначения, для которого необходимо применить
допустимые сертификаты SSL. Если для параметра
EnforceCertificateErrors указано значение
Значение по умолчанию — |
||
ExternalConnectionSettings |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ExternalConnectionSettings указывает имя сайта, порта и типа шифрования, которые сервер Exchange использует при подключении POP3-клиентов, находящихся вне корпоративной сети, к своей электронной почте. Введите значение в следующем формате: <Имя_узла>:<Порт>:<Тип шифрования>. Компонент многозначного значения <Тип шифрования> является необязательным. Для параметра <Тип шифрования> допустимыми значениями являются TLS (Transport Layer Security) или SSL. |
||
InternalConnectionSettings |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр InternalConnectionSettings указывает имя узла, порта и типа шифрования, которые используются при подключении POP3-клиентов, находящихся в корпоративной сети, к своей электронной почте. Этот параметр также используется для указания имени узла, порта и типа шифрования при переадресации подключения пользователя на другой сервер клиентского доступа. Введите значение в следующем формате: <Имя_узла>:<Порт>: <Тип шифрования>. Компонент многозначного значения <Тип шифрования> является необязательным. Для параметра <Тип шифрования> допустимыми значениями являются TLS или SSL. |
||
LiveIdBasicAuthReplacement |
Необязательный |
System.Boolean |
|||
LogFileLocation |
Необязательный |
System.String |
Параметр LogFileLocation указывает расположение файлов журнала протокола POP3. По умолчанию файлы журнала протокола POP3 расположены в каталоге C:\Program Files\Microsoft\Exchange Server\V14\Logging\Pop3. |
||
LogFileRollOverSettings |
Необязательный |
Microsoft.Exchange.Diagnostics.LogFileRollOver |
Параметр LogFileRollOverSettings определяет, как часто в ходе ведения журнала протокола POP3 создаются новые файлы журналов. По умолчанию новый файл журнала создается каждый час. Возможные значения:
Этот параметр применяется только в случае, если параметр
LogPerFileSizeQuota имеет значение |
||
LoginType |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions |
Параметр LoginType указывает параметр проверки подлинности, который используется для сервера клиентского доступа, на котором работает служба Microsoft Exchange POP3. Возможные значения:
|
||
LogPerFileSizeQuota |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр LogPerFileSizeQuota указывает максимальный
размер файла журнала протокола POP3 в байтах. По умолчанию для
этого параметра установлено значение |
||
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 указывает формат сообщений, получаемых с сервера. Возможные значения:
|
||
MessageRetrievalSortOrder |
Необязательный |
Microsoft.Exchange.Data.SortOrder |
Параметр MessageRetrievalSortOrder указывает порядок сортировки полученных сообщений. Можно установить значение 0 (по возрастанию) или 1 (по убыванию). |
||
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 POP3, работающая на сервере клиентского доступа, ретранслирует команды. |
||
Server |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Параметр Server указывает отдельный сервер клиентского доступа в организации, для которого указываются параметры POP3. |
||
SSLBindings |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр SSLBindings указывает, задает ли команда IP-адрес и номер порта для сеанса SSL. Это многозначное свойство. Введите значение в следующем формате: <IP-адрес>:<Номер порта>. |
||
SuppressReadReceipt |
Необязательный |
System.Boolean |
Параметр SuppressReadReceipt указывает, следует ли
останавливать отправку дублирующихся уведомлений о прочтении
отправителям POP3, использующим в своей почтовой программе POP3
параметр отправлять уведомления о прочтении отправляемых
сообщений. По умолчанию этому параметру присвоено значение
Допустимые значения этого параметра:
|
||
UnencryptedOrTLSBindings |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр UnencryptedOrTLSBindings указывает IP-адрес и номер порта для связи через шифрованное TLS-подключение или незашифрованное подключение. Это многозначное свойство. Введите значение в следующем формате: <IP-адрес>:<Номер порта>. |
||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
|||
X509CertificateName |
Необязательный |
System.String |
Параметр X509CertificateName указывает имя узла в SSL-сертификате из поля Связанный субъект. Это многозначное свойство, которое содержит IP-адрес и параметр порта. Введите значение в следующем формате: <IP-адрес>:<Номер порта>. |
Подробное описание
Командлет Set-PopSettings можно запустить для одного сервера клиентского доступа с установленной службой Microsoft Exchange POP3 или для всех серверов клиентского доступа Exchange, на которых установлена служба Microsoft Exchange POP3.
Дополнительные сведения см. в разделе Настройка IP-адресов и портов для доступа по протоколам POP3 и IMAP4
Запись «Параметры POP3» в разделе Разрешения клиентского доступа.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Примеры
ПРИМЕР 1
В этом примере для сервера клиентского доступа с именем CAS01 задается обычный текст или TLS-подключение. В этом примере для подключения используется IP-адрес 10.0.0.0 и номер порта 993.
Скопировать код | |
---|---|
Set-PopSettings -Server "CAS01" -UnencryptedOrTLSBindings 10.0.0.0:993 |
ПРИМЕР 2
В этом примере включается ведение журнала протокола POP3. В нем также задается каталог журнала протокола POP3: C:\Pop3Logging.
Скопировать код | |
---|---|
Set-PopSettings -ProtocolLogEnabled $true -LogFileLocation "C:\Pop3Logging" |
ПРИМЕР 3
В этом примере для ведения журнала протокола POP3 задается создание новых файлов журнала по достижении размера 2 МБ.
Скопировать код | |
---|---|
Set-PopSettings -LogPerFileSizeQuota 2000000 |
ПРИМЕР 4
В этом примере для ведения журнала протокола POP3 задается создание новых файлов журнала каждый час.
Скопировать код | |
---|---|
Set-PopSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly |