Get-SPEnterpriseSearchStatus

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

语法

Default (默认值)

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

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

在使用 Global 参数时,所有对象均包含在全局存储中。 如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Component

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Constellation

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Detailed

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DetailSearchRuntime

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-HealthReport

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-JobStatus

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Primary

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SearchApplication

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SearchServiceApplicationPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Text

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定是否应采用易于读取的格式输出此 cmdlet 中的打印输出。 如果未使用此参数,则此 cmdlet 将输出 SearchStatusInfo 对象。

在使用此参数时,输出将打印到控制台且无法传输到一个文件或另一个程序。

参数属性

类型: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