你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-ServiceFabricServiceHealth

获取 Service Fabric 服务的运行状况。

语法

Get-ServiceFabricServiceHealth
   [-ServiceName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-PartitionsHealthStateFilter <Int64>]
   [-PartitionsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

说明

Get-ServiceFabricServiceHealth cmdlet 获取 Service Fabric 服务的运行状况。 如果指定运行状况存储中不存在的服务,此 cmdlet 将返回异常。

在 Service Fabric 群集上执行任何操作之前,请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。

示例

示例 1:查询服务的运行状况

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1

此命令获取指定服务的运行状况。

示例 2:使用自定义运行状况策略获取服务的运行状况并返回筛选器

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ConsiderWarningAsError $True -EventsFilter Error -PartitionsFilter 'Warning,Error'

此命令查询指定服务的运行状况。 它为运行状况策略提供值。 它使用筛选器仅返回 Error 事件,以及错误或警告运行状况状态的子项。

示例 3:查询服务的运行状况并排除运行状况统计信息

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ExcludeHealthStatistics

此命令获取指定服务的运行状况。 返回的服务运行状况不包括服务运行状况统计信息。

参数

-ConsiderWarningAsError

指示是否在运行状况评估期间将警告运行状况报告视为错误。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EventsFilter

指定基于运行状况的实体报告的 HealthEvent 集合的筛选器。 可以从成员或对 HealthStateFilter的成员执行按位操作获取该值。 仅返回与筛选器匹配的事件。 所有事件都用于评估聚合的运行状况状态。 如果未指定,则返回所有条目。

类型:HealthStateFilter
接受的值:Default, None, Ok, Warning, Error, All
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EventsHealthStateFilter

此参数已弃用。 请改为指定 EventsFilter 参数。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExcludeHealthStatistics

指示运行状况统计信息是否应包含在查询结果中。 如果指定,则不会返回运行状况统计信息作为查询结果的一部分。 否则,查询结果包括服务运行状况统计信息,其中包含有关此服务的分区数和副本处于“确定”、“警告”和“错误”状态的信息。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MaxPercentUnhealthyPartitionsPerService

指定服务中不正常分区的最大容忍百分比。 如果分区的运行状况错误多于容忍,则服务的运行状况状态为错误。

类型:Byte
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MaxPercentUnhealthyReplicasPerPartition

指定不正常分区副本的最大容忍百分比。 如果有多个副本出现运行状况错误,则分区的运行状况状态为错误。

类型:Byte
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PartitionsFilter

根据运行状况指定 PartitionHealthState 子级的筛选器。 可以从成员或对 HealthStateFilter的成员执行按位操作获取该值。 仅返回与筛选器匹配的子级。 所有子级用于评估实体聚合运行状况。 如果未指定,则返回所有条目。

类型:HealthStateFilter
接受的值:Default, None, Ok, Warning, Error, All
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PartitionsHealthStateFilter

此参数已弃用。 请改为指定 PartitionsFilter 参数。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServiceName

指定 Service Fabric 服务的 URI。

类型:Uri
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-TimeoutSec

指定操作的超时期限(以秒为单位)。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

System.Uri

输出

System.Object