Test-ExchangeSearch
內部部署 Exchange 才有提供此 Cmdlet。
使用 Test-ExchangeSearch Cmdlet 來測試 Exchange 搜尋目前是否已啟用，並及時為新的電子郵件訊息編製索引。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Identity
Test-ExchangeSearch
[[-Identity] <MailboxIdParameter>]
[-Archive]
[-Confirm]
[-DomainController <Fqdn>]
[-IndexingTimeoutInSeconds <Int32>]
[-MonitoringContext]
[-WhatIf]
[<CommonParameters>]
Database
Test-ExchangeSearch
[-MailboxDatabase <DatabaseIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-IndexingTimeoutInSeconds <Int32>]
[-MonitoringContext]
[-WhatIf]
[<CommonParameters>]
Server
Test-ExchangeSearch
[-Server <ServerIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-IndexingTimeoutInSeconds <Int32>]
[-MonitoringContext]
[-WhatIf]
[<CommonParameters>]
Description
Test-ExchangeSearch Cmdlet 會在指定的信箱中建立隱藏的郵件和附件，只有 Exchange 搜尋才能看見。 命令會等候訊息編製索引，然後搜尋內容。 它會報告成功或失敗，視是否在 IndexingTimeoutInSeconds 參數中設定的間隔之後找到訊息而定。
您可以使用 Verbose 參數來取得 Cmdlet 在測試中執行之每個步驟的詳細資訊。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Test-ExchangeSearch -Identity john@contoso.com
此範例會針對指定信箱所在的信箱資料庫測試 Exchange 搜尋結果。
範例 2
Test-ExchangeSearch -Identity john@contoso.com -Verbose
此範例會針對指定信箱所在的信箱資料庫測試 Exchange 搜尋結果。 詳細資訊參數可用來顯示詳細資訊。
參數
-Archive
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
封存 參數會指定針對 Identity 參數所指定信箱使用者的封存信箱執行測試。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
Identity 參數會指定您要測試 Exchange 搜尋的信箱。 您可以使用可唯一識別信箱的任何值。 例如：
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- Domain\Username
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
您無法搭配MailboxDatabase 或 Server 參數使用此參數。
參數屬性
| 類型: | MailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IndexingTimeoutInSeconds
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
IndexingTimeoutInSeconds 參數會指定在將新電子郵件訊息新增至測試信箱，以及等候在搜尋結果中傳回電子郵件訊息之間的等待時間上限，以秒為單位。 預設值為 120 秒。 如果未指定此參數，則會使用預設間隔。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MailboxDatabase
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
此參數只能在 2010 和 2013 Exchange Server 運作。
MailboxDatabase 參數會指定要測試 Exchange 搜尋的信箱資料庫。 您可以使用唯一識別資料庫的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
您無法將此參數與 Identity 或 Server 參數搭配使用。
參數屬性
| 類型: | DatabaseIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Database
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-MonitoringContext
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
MonitoringContext 參數在結果中會納入相關的監視事件與效能計數器。 您不需要使用此參數指定值。
一般而言，當輸出傳遞至 Microsoft System Center Operations Manager (SCOM) 時，您會在結果中包含監視事件和性能計數器。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
Server 參數會為您要測試 Exchange 搜尋的收件者指定 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- Exchange Legacy DN
您無法搭配MailboxDatabase或Identity 參數使用此參數。
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
適用：Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。