匯出 (0) 列印
全部展開
Expand Minimize

Set-ImapSettings

 

適用版本: Exchange Server 2013

上次修改主題的時間: 2014-03-05

內部部署 Exchange Server 2013 才有提供此 Cmdlet。

使用 Set-ImapSettings Cmdlet,可設定已安裝 Client Access server role 且正在執行 Microsoft Exchange IMAP4 服務和 Microsoft Exchange Server 2013 的伺服器之特定 IMAP4 設定。

如需下方<語法>一節中的參數集的詳細資訊,請參閱語法

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>] [-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>] [-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 連線設為 Client Access Server CAS01。在此範例中,連線會使用 10.0.0.0 這個 IP 位址與通訊埠號碼 995。

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

此範例會開啟 IMAP4 通訊協定記錄。其也會將 IMAP4 通訊協定記錄目錄變更為 C:\Imap4Logging。

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

此範例會將 IMAP4 通訊協定記錄變更為在記錄檔達到 2 MB 時建立新的記錄檔。

Set-ImapSettings -LogPerFileSizeQuota 2000000

此範例會將 IMAP4 通訊協定記錄變更為每小時建立一個新的記錄檔。

Set-ImapSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly

您可以對已安裝 Microsoft Exchange IMAP4 服務的單一 Client Access server,或對所有已安裝 Microsoft Exchange IMAP4 服務的 Exchange Client Access server 執行 Set-ImapSettings Cmdlet。

您必須已獲指派權限,才能執行此指令程式。雖然這個指令程式的所有參數都已列於本主題中,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。若要查看您需要的權限,請參閱用戶端和行動裝置權限主題中的「IMAP4 設定」項目。

 

參數 必要 類型 描述

AuthenticatedConnectionTimeout

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

AuthenticatedConnectionTimeout 參數會指定在關閉閒置的驗證連線前所等待的時間長度。

若要指定值,請輸入時間範圍值:dd.hh:mm:ss,其中 d = 天數,h = 時數,m = 分鐘數,而 s = 秒數。

這個參數的有效輸入是 00:00:301:00:00。預設設定為 00:30:00 或 30 分鐘。

Banner

選用

System.String

Banner 參數會指定在建立與 Client Access Server 的連線後所顯示的橫幅字串。

CalendarItemRetrievalOption

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

CalendarItemRetrievalOption 參數會指定使用 IMAP4 存取行事曆時所傳回的行事曆項目類型。預設值為 iCalendar。您可使用數值或文字字串來指定此參數的值。下列是可用的值:

  • 0iCalendar

  • 1intranetUrl

  • 2InternetUrl

  • 3Custom

如果使用 3Custom,則必須指定 OwaServerUrl參數設定。

Confirm

選用

System.Management.Automation.SwitchParameter

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

DomainController

選用

Microsoft.Exchange.Data.Fqdn

DomainController 參數會指定將此組態變更寫入至 Active Directory 之網域控制站的完整網域名稱 (FQDN)。

EnableExactRFC822Size

選用

System.Boolean

EnableExactRFC822Size 參數會計算可從伺服器擷取之每個 MIME 郵件的確切大小。當您將此參數設為 $true 時,儲存在 Exchange 伺服器上的 MIME 郵件確切大小,可供依賴知道每個 MIME 郵件確切大小的 POP3 或 IMAP4 用戶端程式使用。

注意事項附註:
依預設,此參數設為 $false。如果您未將此選項設成 $true,Exchange 伺服器傳回給 POP3 和 IMAP4 用戶端程式的每個 MIME 郵件大小可能會與該郵件的實際大小稍有不同。將此選項設為 $true 可能對效能有不利影響,因此應該僅在大多數使用者都使用需要知道 MIME 郵件確切大小的用戶端時,才使用此選項。

EnableGSSAPIAndNTLMAuth

選用

System.Boolean

EnableGSSAPIAndNTLMAuth 參數會指定連接是否可以透過一般安全性服務應用程式設計介面 (GSSAPI) 來使用整合式 Windows 驗證 (NTLM)。此設定適用於停用傳輸層安全 (TLS) 的連接。依預設,此參數設為 $true。您可以將參數值設定為 $false 來停用適用於 IMAP4 連接的 NTLM。NTLM 驗證不支援 Microsoft Exchange Server 2010 量產發行 (RTM) 版本的 IMAP4 連線。在 Exchange 2010 Service Pack 1 (SP1) 中,則重新支援適用於 IMAP4 連接的 NTLM 驗證。

EnforceCertificateErrors

選用

System.Boolean

EnforceCertificateErrors 參數會指定是否強制執行有效的安全通訊端層 (SSL) 憑證。若要使用此參數,請指定要強制執行有效 SSL 憑證的目的 Client Access Server。如果 EnforceCertificateErrors 參數設為 $true,而且 Proxy 的目標憑證無效,則 Proxy 登入嘗試會失敗。

預設值是 $false

ExtendedProtectionPolicy

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.ExtendedProtectionTokenCheckingMode

ExtendedProtectionPolicy 參數會指定您要在 IMAP4 連接上使用 Extended Protection for Authentication 的方式。依預設,此參數設為 None。可能的值為:

  • None   將不會使用 Extended Protection for Authentication。

  • Allow   唯有當連接 IMAP4 連接支援時才使用 Extended Protection for Authentication。否則會建立沒有 Extended Protection for Authentication 的連線。

  • Require   所有 IMAP4 連接都需要 Extended Protection for Authentication。如果連接主機不支援 Extended Protection for Authentication,則會拒絕連線。

Extended Protection for Authentication 會在使用整合式 Windows 驗證驗證網路連線時,加強認證的保護和處理。整合式 Windows 驗證也稱為 NTLM。如果是使用整合式 Windows 驗證,強烈建議您使用 Extended Protection for Authentication。若要使用 Extended Protection for Authentication,用戶端和伺服器電腦必須符合特定的需求。其中包括作業系統需求和安全性更新需求。此外,IMAP4 用戶端程式必須支援 Extended Protection for Authentication 的使用。

ExternalConnectionSettings

選用

Microsoft.Exchange.Data.MultiValuedProperty

ExternalConnectionSettings 參數會指定當 IMAP4 用戶端連線至來自公司網路外部的電子郵件時,Exchange 使用的主機名稱、通訊埠和加密類型。

使用下列格式輸入值:<主機名稱>:<通訊埠>:<加密類型>。多重值的 <加密類型> 部份是選用的。<加密類型> 的有效值為 TLS (傳輸層安全性) 或 SSL。

InternalConnectionSettings

選用

Microsoft.Exchange.Data.MultiValuedProperty

InternalConnectionSettings 參數會指定當 IMAP4 用戶端連線至來自公司網路內部的電子郵件時,所使用的主機名稱、通訊埠和加密類型。此設定也用來指定使用者連線轉寄至其他 Client Access Server 時所使用的主機名稱、通訊埠和加密類型。

使用下列格式輸入值:<主機名稱>:<通訊埠>:<加密類型>。多重值的 <加密類型> 部份是選用的。<加密類型> 的有效值為 TLS 或 SSL。若伺服器名稱為 Server01 且網域為 Contoso.com,則預設值則為 Server01.Contoso.com:993:SSL, Server01.Contoso.com:143:TLS

LiveIdBasicAuthReplacement

選用

System.Boolean

將保留此參數供 Microsoft 內部使用。

LogFileLocation

選用

System.String

LogFileLocation 參數會指定 IMAP4 通訊協定記錄檔的位置。根據預設,IMAP4 通訊協定記錄檔位於 C:\Program Files\Microsoft\Exchange Server\V15\Logging\Imap4 目錄中。

LogFileRollOverSettings

選用

Microsoft.Exchange.Diagnostics.LogFileRollOver

LogFileRollOverSettings 參數指定 IMAP4 通訊協定記錄建立新記錄檔的頻率。預設是每天建立一個新記錄檔。您可使用數值或文字字串來指定此參數的值。可能的值為:

  • 1Hourly

  • 2Daily

  • 3Weekly

  • 4Monthly

此設定僅在 LogPerFileSizeQuota 參數的值設定為 0 時適用。

LoginType

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

LoginType 參數會指定用於執行 Microsoft Exchange IMAP4 服務之 Client Access Server 的驗證設定。預設值為 SecureLogin。您可使用數值或文字字串來指定此參數的值。可能的值為:

  • 1PlainTextLogin

  • 2PlainTextAuthentication

  • 3SecureLogin

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 參數會指定 Client Access Server 接受來自特定使用者的最大連線數。預設值為 16。可能值從 1 到 2147483647。

MessageRetrievalMimeFormat

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

MessageRetrievalMimeFormat 參數會指定從伺服器擷取之郵件的格式。預設值為 BestBodyFormat。您可使用數值或文字字串來指定此參數的值。可能的值為:

  • 0TextOnly

  • 1HtmlOnly

  • 2HtmlAndTextAlternative

  • 3TextEnrichedOnly

  • 4TextEnrichedAndTextAlternative

  • 5BestBodyFormat

  • 6Tnef

如需詳細資訊,請參閱設定 POP3 和 IMAP4 郵件擷取格式選項

OwaServerUrl

選用

System.Uri

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

PreAuthenticatedConnectionTimeout

選用

Microsoft.Exchange.Data.EnhancedTimeSpan

PreAuthenticatedConnectionTimeout 參數會指定在關閉未驗證的閒置連線前所等待的時間長度。

若要指定值,請輸入時間範圍值:dd.hh:mm:ss,其中 d = 天數,h = 時數,m = 分鐘數,而 s = 秒數。

此參數的有效輸入為 00:00:301:00:00。預設參數值為 00:01:00 或一分鐘。

ProtocolLogEnabled

選用

System.Boolean

ProtocolLogEnabled 參數會指定是否啟用通訊協定記錄。如需詳細資訊,請參閱設定 POP3 及 IMAP4 的通訊協定記錄

ProxyTargetPort

選用

System.Int32

ProxyTargetPort 參數會指定 Exchange Server 2003 後端伺服器上的通訊埠,讓 Client Access Server 上的 Microsoft Exchange IMAP4 服務將命令轉送至該通訊埠。預設通訊埠為 9933。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

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 參數會指定透過 TLS 加密的連線或不加密的連線進行通訊的 IP 位址和通訊埠號碼。此為多重值內容。使用下列格式輸入值:<IP 位址>:<通訊埠號碼>。預設值為 0.0.0.0:143

WhatIf

選用

System.Management.Automation.SwitchParameter

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

X509CertificateName

選用

System.String

X509CertificateName 參數會從 [關聯的主旨] 欄位指定 SSL 憑證中的主機名稱。此為同時包含 IP 位址與通訊埠設定的多重值內容。使用下列格式輸入值:<IP 位址>:<通訊埠號碼>。

若要查看此 Cmdlet 可接受的輸入類型,請參閱 Cmdlet 輸入和輸出類型。如果 Cmdlet 的 [輸入類型] 欄位是空的,表示 Cmdlet 不接受輸入資料。

若要查看此 Cmdlet 可接受的傳回類型 (也就是所謂的輸出類型),請參閱 Cmdlet 輸入和輸出類型。如果 [輸出類型] 欄位是空的,表示 Cmdlet 不會傳回資料。

 
本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2014 Microsoft