Get-MailboxSearch

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

使用 Get-MailboxSearch Cmdlet 來檢視進行中、完成或停止的信箱搜尋。

注意：自 2020 年 10 月起，*-MailboxSearch Cmdlet 已在 Exchange Online PowerShell 中淘汰。請改用安全 & 性合規性 PowerShell 中的 *-ComplianceSearch Cmdlet。如需詳細資訊，請參閱淘汰舊版電子檔探索工具。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-MailboxSearch
   [[-Identity] <SearchObjectIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-MailboxSearch
   [[-Identity] <EwsStoreObjectIdParameter>]
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-MailboxSearch
   -InPlaceHoldIdentity <String>
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

在內部部署 Exchange 中，信箱搜尋可用來執行In-Place電子檔探索，或將使用者置於In-Place保留。使用 Get-MailboxSearch Cmdlet 來擷取任一類型信箱搜尋的詳細資料。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-MailboxSearch -ResultSize "unlimited"

此範例會擷取所有信箱搜尋的清單。

範例 2

Get-MailboxSearch "Project Hamilton" | Format-List

此範例會擷取信箱搜尋 Project Hamilton 的所有屬性。

Identity 參數是一個位置參數。位置參數可在沒有標籤 (識別) 的情況下使用。如需位置參數的詳細資訊，請參閱關於參數。

範例 3

(Get-Mailbox Mark).InPlaceHolds

Get-MailboxSearch -InPlaceHoldIdentity 9953d0f0fd03415e949d4b41c5a28cbb

此範例會擷取放置使用者的In-Place保留。第一個命令會輸出In-Place保留的 GUID。最後一個命令會根據放置使用者之In-Place保留的 GUID 來擷取信箱搜尋。

參數

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 參數會指定搜尋查詢的名稱。如果未提供名稱，則會傳回所有信箱搜尋查詢。

若要在Exchange Online中改善此 Cmdlet 的效能，如果您未指定信箱搜尋的名稱，則不會傳回某些信箱搜尋屬性。這些屬性包括：

SourceMailboxes
來源
SearchQuery
ResultsLink
PreviewResultsLink
錯誤

若要檢視這些屬性，您必須提供信箱搜尋的名稱。

Type:	SearchObjectIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-InPlaceHoldIdentity

InPlaceHoldIdentity 參數會指定In-Place保留的 GUID。使用此參數來搜尋放置使用者的In-Place保留。使用者所放置之所有In-Place保留的 GUID 都會新增至使用者的 InPlaceHolds 屬性。您可以使用 Get-Mailbox Cmdlet 來擷取屬性。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。預設值為 1000。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ShowDeletionInProgressSearches

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

輸入

Input types

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

輸出

Output types

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