Set-POPSettings (RTM)
适用于: Exchange Server 2007
上一次修改主题: 2007-06-11
通过 Set-POPSettings cmdlet 可以为运行 Microsoft Exchange Server 2007 且安装了客户端访问服务器角色以及运行 POP3 服务的服务器指定邮局协议版本 3 (POP3) 设置。
语法
Set-PopSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-DomainController <Fqdn>] [-Instance <Pop3AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat>] [-MessageRetrievalSortOrder <Ascending | Descending>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-X509CertificateName <String>]
详细说明
使用 Set-POPSettings cmdlet 可以为客户端访问服务器设置特定的 POP3 属性。可以在安装了 POP3 服务的单个客户端访问服务器上或组织中安装了客户端访问服务器角色和 POP3 服务的所有 Exchange 2007 计算机上运行该 cmdlet。
若要运行 Set-POPSettings cmdlet,必须为您使用的帐户委派以下角色:
- Exchange Server 管理员角色和目标服务器的本地 Administrators 组
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项。
参数
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
AuthenticatedConnectionTimeout |
可选 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
此参数指定在关闭经过身份验证的空闲连接之前要等待的时间。默认设置为 1800 秒。可能的值从 30 秒到 86,400 秒。 |
Banner |
可选 |
System.String |
此参数指定在与客户端访问服务器建立连接之后显示的标题字符串。 |
CalendarItemRetrievalOption |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions |
此参数指定在使用 POP3 访问日历时返回的日历项类型。可以使用下列值:
如果使用 3:Custom,则必须指定 OWAServerUrl 设置。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定用于从 Active Directory 目录服务检索数据域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。 |
Instance |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.Pop3AdConfiguration |
Instance 参数指定通过管道传递给此命令供其使用的 Active Directory 对象实例。 |
LoginType |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions |
此参数指定用于正在运行 POP3 服务的客户端访问服务器的身份验证设置。可能的值如下:
|
MaxCommandSize |
可选 |
System.Int32 |
此参数指定单个命令的最大大小。默认大小为 40 字节。可能的值从 40 字节到 1024 字节。 |
MaxConnectionFromSingleIP |
可选 |
System.Int32 |
此参数指定特定服务器将从单个 IP 地址接受的连接数。默认值为 20。可能的值从 1 到 1000。 |
MaxConnections |
可选 |
System.Int32 |
此参数指定所指定服务器将接受的连接总数。这包括通过身份验证和未通过身份验证的连接。 默认大小为 2,000 字节。可能的值从 1 字节到 25,000 字节。 |
MaxConnectionsPerUser |
可选 |
System.Int32 |
此参数指定客户端访问服务器将从特定用户接受的最大连接数。默认值为 10。可能的值从 1 到 1000。 |
MessageRetrievalMimeFormat |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat |
此参数指定从服务器检索的邮件格式。可能的值如下:
|
MessageRetrievalSortOrder |
可选 |
Microsoft.Exchange.Data.SortOrder |
此参数指定检索到的邮件的排序顺序。此值可以是 0(升序)或 1(降序)。 |
OwaServerUrl |
可选 |
System.String |
此参数指定要从其检索自定义 Outlook Web Access 日历项实例的日历信息的客户端访问服务器。 |
PreAuthenticatedConnectionTimeout |
可选 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
此参数指定在关闭未经过身份验证的空闲连接之前要等待的时间。默认设置为 60 秒。可能的值从 10 秒到 3600 秒。 |
ProxyTargetPort |
可选 |
System.Int32 |
该参数指定客户端访问服务器上的 POP3 服务要将命令中继到的 Exchange Server 2003 后端服务器上的端口。 |
Server |
可选 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
该参数指定组织中要为其指定 POP3 设置的单个客户端访问服务器。 |
SSLBindings |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
如果指定了该参数,cmdlet 将返回用于安全套接字层 (SSL) 会话 的 IP 端口。 |
UnencryptedOrTLSBindings |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
此参数指定用于通过传输层安全性 (TLS) 加密连接或未加密连接进行通信的 IP 端口。 |
X509CertificateName |
可选 |
System.String |
该参数指定来自“相关主题”字段的 SSL 证书中的主机名称。 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
|
|
异常
异常 | 说明 |
---|---|
|
|
示例
以下代码示例对名为 CAS01 的客户端访问服务器设置 TLS IP 地址。
Set-PopSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953