Test-ImapConnectivity
適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間： 2010-08-18
使用 Test-ImapConnectivity 指令程式可驗證 IMAP4 服務是否如預期般執行。Test-ImapConnectivity 指令程式可用來針對相同 Active Directory 站台之 Exchange 2007 伺服器上的所有信箱，測試指定 Client Access Server 上的所有 IMAP4 功能。
語法
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
使用 Test-ImapConnectivity 指令程式可驗證 IMAP4 服務是否如預期般執行。Test-ImapConnectivity 指令程式可用來測試指定 Client Access Server 上的 IMAP4 功能。
若要執行 Test-PopConnectivity 指令程式以測試 Client Access Server 上的 IMAP4 功能，您使用的帳戶必須得到目標伺服器上之 Exchange Server 系統管理員角色和本機 Administrators 群組中之成員資格的委派。
如需管理 Exchange Server 2007 所需之權限、委派角色以及權利的相關資訊，請參閱權限考量。
參數
| 參數 | 必要 | 類型 | 描述 | ||
|---|---|---|---|---|---|
ClientAccessServer |
選用 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
此參數可指定要測試的 Client Access Server 名稱。此參數請勿搭配 URL 參數使用。 |
||
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。 |
||
ConnectionType |
選用 |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
此參數指定用來連接至 Client Access Server 的連線類型。 |
||
DomainController |
選用 |
Microsoft.Exchange.Data.Fqdn |
若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在指令程式中加入 DomainController 參數。 |
||
LightMode |
選用 |
System.Management.Automation.SwitchParameter |
不會針對 Test-ImapConnectivity 指令程式實作這個參數。使用這個參數不會變更指令程式的行為。
|
||
MailboxCredential |
選用 |
System.Management.Automation.PSCredential |
這個參數包含用於單一 URL 測試的信箱認證。 |
||
MailboxServer |
選用 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
此參數可指定要測試的 Mailbox Server 名稱。如未指定，則會測試本機 Active Directory 站台上的所有 Mailbox Server。 |
||
MonitoringContext |
選用 |
System.Management.Automation.SwitchParameter |
如果包含此參數，工作將會透過 Microsoft Operations Manager (MOM) 排程來執行。執行含有此參數而不具 MOM 的工作，將導致此工作失敗。如果排除此參數，則必須由系統管理員以互動方式執行工作。 |
||
PerConnectionTimeout |
選用 |
System.Int32 |
此參數指定每個連線等候測試作業完成的時間量 (以秒為單位)。PerConnectionTimeout 的預設值為 24 秒。指定的 Timeout 值必須大於 0 秒，小於 120 秒。建議您一律將此參數值設為大於或等於 5 秒。 |
||
PortClientAccessServer |
選用 |
System.Int32 |
此參數指定用來連線至您要與 Test-ImapConnectivity 指令程式一起使用的 Client Access Server 的通訊埠。 |
||
ResetTestAccountCredentials |
選用 |
System.Management.Automation.SwitchParameter |
ResetTestAccountCredentials 參數會重設用來執行此命令之測試帳戶的密碼。如果您使用 Microsoft System Center Operations Manager 來管理 Exchange 環境，則測試帳戶的密碼通常每隔七天會重設一次。只要安全上有需要，隨時都可以使用此標幟強制進行密碼重設。 |
||
Timeout |
選用 |
System.UInt32 |
此參數指定要等候測試作業完成的時間量 (以秒為單位)。Timeout 的預設值為 30 秒。指定的 Timeout 值必須大於 0 秒，小於 1 小時 (3600 秒)。建議您一律將此參數值設為大於或等於 5 秒。 |
||
TrustAnySSLCertificate |
選用 |
System.Management.Automation.SwitchParameter |
如果使用此參數，將不會回報安全通訊端層 (SSL) 憑證驗證失敗。此參數會使 Test-ImapConnectivity 指令程式檢查 IMAP4 服務，而不會在憑證與 Client Access Server 的 URL 不相符時產生錯誤。 |
||
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。 |
.gif "note")
附註：輸入類型
傳回類型
錯誤
| 錯誤 | 描述 |
|---|---|
|
|
範例
第一個程式碼範例使用使用者 contoso\kweku 的認證，測試 Client Access Server Contoso12 的 IMAP4 連線。
第二個程式碼範例測試名為 Contoso12 之特定 Client Access Server 的 IMAP4 連線，而且會測試所有 Exchange 2007 信箱。
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12
若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.