Get-SPEnterpriseSearchStatus

检索搜索组件的诊断信息。

语法

Get-SPEnterpriseSearchStatus
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Component <String>]
   [-Constellation]
   [-Detailed]
   [-DetailSearchRuntime]
   [-HealthReport]
   [-JobStatus]
   [-Primary]
   [-Text]
   [<CommonParameters>]

说明

此 cmdlet 检索 Search Service 应用程序的活动拓扑中所有或指定的搜索组件的诊断信息。

如果未指定任何可选参数,则 cmdlet 将检索搜索服务应用程序中所有搜索组件的运行状况。 每个搜索组件将具有下列状态之一:

  • 活动:搜索组件正常运行
  • 已降级:搜索组件处于无法正确执行所有操作的状态。 已降级状态通常是因与重新启动或网络问题相关的临时状况导致的。
  • 失败:搜索组件未运行。 此状态指示组件无法正确执行操作。
  • 未知:无法访问组件。 未知状态通常是因硬件或通信问题导致的。

如果您已为搜索拓扑中的某个分区定义多个索引组件,则此 cmdlet 将指明对该分区起重要作用的索引组件。

可以使用 cmdlet 输出以下附加信息:

  • 列出搜索组件启动的后台活动(批处理作业)的状态
  • 列出搜索组件启动的后台活动(批处理作业)的状态
  • 列出索引组件的详细诊断信息
  • 调试可能由 Microsoft 用于详细的问题解决方法的信息

如果不想循环访问脚本中的输出,请使用 Text 参数。 如果不使用 Text 参数,则 cmdlet 将输出一组具有以下属性的对象:

  • string Name:搜索组件、运行状况报告项或 constellation 属性的名称
  • string State:搜索组件的状态
  • string Level:在使用 HealthReport 参数时,该属性指示每个运行状况报告项的重要性级别(错误、警告、信息、详细)
  • string Message:以文本字符串形式提供的附加信息
  • ReadOnlyDictionary<字符串,字符串>详细信息:提供其他诊断信息的字典名称/值对

有关 SharePoint 产品Windows PowerShell的权限和最新信息,请参阅 中的https://go.microsoft.com/fwlink/p/?LinkId=251831联机文档。

示例

------------------示例 1------------------

Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -Text

此示例检索包含有关默认搜索服务应用程序的所有搜索组件的诊断信息的列表。

------------------示例 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 Subscription Edition

-Component

指定搜索组件的名称。 此参数仅与 HealthReport 和 Primary 参数结合使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Constellation

指定是否应提供搜索拓扑的内部诊断信息。 此参数应仅用于调试。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Detailed

指定 HealthReport 参数的详细信息的级别。 在使用此参数时,cmdlet 也将输出详细诊断信息。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DetailSearchRuntime

指定是否应提供搜索运行时的内部诊断信息。 此参数应仅用于调试。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-HealthReport

指定是否应提供搜索组件的诊断信息。 在使用此参数时,必须使用 Component 参数指定组件名称。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-JobStatus

指定是否应提供“Search Analytics”和“Usage Analytics”计时器作业的状态信息。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Primary

指定管理组件是否具有重要作用。 在使用此参数时,必须使用 Component 参数指定组件名称。 如果管理组件具有重要作用,则返回 true。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SearchApplication

指定包含搜索组件的 Search Service 应用程序。

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition