Set-IMAPSettings

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2009-05-15

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

詳細描述

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 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 設定。

Confirm

選用

System.Management.Automation.SwitchParameter

Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在命令中加入 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 服務之 Client Access Server 所使用的驗證設定。可能的值如下：

  • 1:PlainTextLogin
  • 2:PlainTextAuthentication
  • 3:SecureLogin

MaxCommandSize

選用

System.Int32

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

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:Text Only
  • 1:HTML Only
  • 2:HTML and Text
  • 3:Rich Text Only
  • 4：最佳內文格式

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) 加密的連線或未加密的連線進行通訊。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

X509CertificateName

選用

System.String

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

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

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

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.