Set-IMAPSettings (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-11

Set-IMAPSettings 指令程式可讓您為已安裝 Client Access server role 及執行 IMAP4 服務的 Microsoft Exchange Server 2007 伺服器，設定特定的網際網路訊息存取通訊協定 4rev1 版 (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 Client Access Server，設定特定的 IMAP4 設定。您可以對已安裝 IMAP4 服務的單一 Client Access Server，或對所有已安裝 IMAP4 服務的 Exchange 2007 Client Access Server 執行此指令程式。

若要執行 Set-IMAPSettings 指令程式，必須對您使用的帳戶委派下列項目：

  • Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組

如需管理 Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

AuthenticatedConnectionTimeout

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

此參數可指定在關閉閒置的驗證連線前，所等待的時間長度。預設設定為 1800 秒。可能值從 30 至 86,400 秒。

Banner

選用

System.String

此參數可指定在建立 Client Access Server 的連線後，所顯示的橫幅字串。

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 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。

Instance

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

Instance 參數指定傳送給此命令，供此命令使用的 Active Directory 物件執行個體。

LoginType

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

此參數可指定執行 IMAP4 服務之 Client Access Server 所使用的驗證設定。可能的值如下：

  • 1:PlainTextLogin

  • 2:PlainTextAuthentication

  • 3:SecureLogin

MaxCommandSize

選用

System.Int32

此參數指定單一命令的大小上限。預設大小為 40 個位元組。可能值從 40 至 1024 個位元組。

MaxConnectionFromSingleIP

選用

System.Int32

此參數指定特定的伺服器會接受來自單一 IP 位址的連線數。預設值為 20。可能值從 1 到 1000。

MaxConnections

選用

System.Int32

指定已指定的伺服器會接受的連線總數。這包含已驗證與未驗證的連線。預設大小為 2,000 個位元組。可能值從 1 至 25,000。

MaxConnectionsPerUser

選用

System.Int32

此參數指定 Client Access Server 會接受來自特定使用者的最大連線數。預設值為 10。可能值從 1 到 1000。

MessageRetrievalMimeFormat

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

此參數會指定從伺服器擷取的郵件格式。可能的值如下：

  • 0：純文字

  • 1：僅限 HTML

  • 2：HTML 及文字

  • 3：僅限豐富型文字

  • 4：UUEncode

  • 5：UUEncodeBinHex

  • 6：最佳內文格式

OwaServerUrl

選用

System.String

此參數會指定 Client Access Server，從中擷取自訂 Outlook Web Access 行事曆項目之執行個體的行事曆資訊。

PreAuthenticatedConnectionTimeout

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

此參數可指定在關閉未驗證的閒置連線前，所等待的時間長度。預設設定為 60 秒。可能值從 10 至 3600 秒。

ProxyTargetPort

選用

System.Int32

此參數可指定 Exchange Server 2003 後端伺服器上的通訊埠，Client Access Server 上的 IMAP4 服務會將命令轉送至該後端伺服器。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

此參數會在您的組織中，指定您正在指定 IMAP 設定的個別 Client Access Server。

ShowHiddenFoldersEnabled

選用

System.Boolean

如果指定此參數，則會看到隱藏的資料夾。預設值為 $false。

SSLBindings

選用

Microsoft.Exchange.Data.MultiValuedProperty

如果指定此參數，則指令程式會傳回可與安全通訊端層 (SSL) 工作階段通訊的 IP 通訊埠。

UnencryptedOrTLSBindings

選用

Microsoft.Exchange.Data.MultiValuedProperty

此參數可指定 IP 通訊埠，透過傳輸層安全性 (TLS) 加密的連線或未加密的連線進行通訊。

X509CertificateName

選用

System.String

此參數從 [關聯的主旨] 欄位指定 SSL 憑證中的主機名稱。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列程式碼範例會在名為 CAS01 的 Client Access Server 上設定 TLS 的 IPAddress。

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