Get-SPEnterpriseSearchStatus
擷取搜尋元件的診斷資訊。
Syntax
Get-SPEnterpriseSearchStatus
-SearchApplication <SearchServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Component <String>]
[-Constellation]
[-Detailed]
[-DetailSearchRuntime]
[-HealthReport]
[-JobStatus]
[-Primary]
[-Text]
[<CommonParameters>]
Description
此 Cmdlet 會擷取 Search Service 應用程式使用中拓撲中所有或指定搜尋元件的診斷資訊。
如果您未指定任何選擇性參數,此 Cmdlet 會擷取 Search Service 應用程式內所有搜尋元件的健康情況狀態。 每個搜尋元件都會有下列其中一種狀態:
- 作用中:搜尋元件執行正常
- 已降級:搜尋元件處於無法正確執行所有作業的狀態。 狀態降低的原因通常是與重新開機或網路問題相關的暫時性情況。
- 失敗:搜尋元件未執行。 此狀態表示元件無法正確執行作業。
- 未知:無法連線到元件。 未知狀態的原因通常是硬體或通訊問題。
如果您已在搜尋拓撲中定義多個資料分割的索引元件,此 Cmdlet 會指出哪個索引元件具有此資料分割的主要角色。
您可以使用 Cmdlet 輸出下列其他資訊:
- 列出搜尋元件) 起始 (批次作業的背景活動狀態
- 列出搜尋元件) 起始 (批次作業的背景活動狀態
- 列出索引元件的詳細診斷資訊
- Microsoft可使用的偵錯資訊,以取得詳細的問題解決方式
如果您不想逐一查看腳本中的輸出,請使用 Text 參數。 如果您未使用 Text 參數,此 Cmdlet 會輸出一組具有下列屬性的物件:
- 字串名稱:搜尋元件的名稱、健康情況報告專案或星座屬性
- 字串狀態:搜尋元件的狀態
- 字串層級:當您使用 HealthReport 參數時,此屬性會指出每個健康情況報告專案的重要性層級 (錯誤、警告、資訊、詳細資訊)
- 字串訊息:以文字字串形式提供的其他資訊
- ReadOnlyDictionary < 字串,字串 > 詳細資料:提供其他診斷資訊的字典名稱/值組
如需 SharePoint 產品Windows PowerShell的許可權和最新資訊,請參閱 線上檔: https://go.microsoft.com/fwlink/p/?LinkId=251831 。
範例
------------------範例 1------------------
Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -Text
此範例會擷取清單,其中包含預設 Search Service 應用程式之所有搜尋元件的診斷資訊。
------------------範例 2------------------
Get-SPEnterpriseSearchStatus -SearchApplication 'Search Service Application' -JobStatus -Text
此範例會擷取搜尋分析計時器工作的背景活動作業狀態。
------------------範例 3------------------
Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -HealthReport -Component IndexComponent1 -Text
此範例會擷取名為 IndexComponent1 之索引元件的診斷資訊。
參數
-AssignmentCollection
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。
使用 Global 參數時,所有物件會包含在全域儲存區內。 若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Component
指定搜尋元件的名稱。 此參數僅用於與 HealthReport 和 Primary 參數關聯。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Constellation
指定是否應該提供搜尋拓撲的內部診斷資訊。 這個參數應該只用于偵錯。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Detailed
指定 HealthReport 參數的詳細資料層級。 使用此參數時,Cmdlet 也會輸出詳細資訊診斷資訊。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-DetailSearchRuntime
指定是否應該提供搜尋執行時間的內部診斷資訊。 這個參數應該只用于偵錯。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-HealthReport
指定是否應該提供搜尋元件的診斷資訊。 使用此參數時,您必須使用 Component 參數指定元件名稱。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-JobStatus
指定是否應該提供搜尋分析和流量分析計時器工作的狀態資訊。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Primary
指定管理員元件是否具有主要角色。 使用此參數時,您必須使用 Component 參數指定元件名稱。 如果管理員元件具有主要角色,則會傳回 true。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SearchApplication
指定包含搜尋元件的搜尋服務應用程式。
Type: | SearchServiceApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Text
指定是否應該以方便閱讀的格式輸出此 Cmdlet 的列印輸出。 如果未使用,此 Cmdlet 會輸出 SearchStatusInfo 物件。
使用此參數時,輸出會列印到主控台,而且無法透過管道傳送至檔案或其他程式。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |