Share via


Get-ServiceFabricServiceHealth

取得 Service Fabric 服務的健康情況。

Syntax

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

Description

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 事件,以及具有 Error 或 Warning 健康狀態的子系。

範例 3:查詢服務的健康情況,並排除健康情況統計資料

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

此命令會取得指定服務的健康情況。 傳回的服務健康情況不包含服務健康情況統計資料。

參數

-ConsiderWarningAsError

指出是否要在健康情況評估期間將警告健康情況報告視為錯誤。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsFilter

根據健康情況狀態,指定實體所報告 HealthEvent 集合的篩選。 您可以從 HealthStateFilter成員的成員或位作業取得此值。 只會傳回符合篩選條件的事件。 所有事件都會用來評估彙總的健康情況狀態。 如果未指定,則會傳回所有項目。

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsHealthStateFilter

此參數已被取代。 請改為指定 EventsFilter 參數。

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeHealthStatistics

指出健康情況統計資料是否應該包含在查詢結果中。 如果指定,則不會傳回健康情況統計資料做為查詢結果的一部分。 否則,查詢結果會包含服務健康情況統計資料,其中包含此服務有多少資料分割和複本處於 [確定]、[警告] 和 [錯誤] 狀態的相關資訊。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyPartitionsPerService

指定服務中狀況不良資料分割的最大容許百分比。 如果健康狀態錯誤超過容許的分割區,服務的健康情況狀態就會發生錯誤。

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyReplicasPerPartition

指定狀況不良資料分割複本的最大容許百分比。 如果有多個複本具有健全狀況狀態錯誤,則分割區的健全狀況狀態是錯誤。

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartitionsFilter

根據健全狀況狀態指定 PartitionHealthState 子系的篩選準則。 您可以從 HealthStateFilter成員的成員或位作業取得此值。 只會傳回符合篩選準則的子系。 所有子系都用來評估實體匯總健康狀態。 如果未指定,則會傳回所有項目。

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartitionsHealthStateFilter

此參數已被取代。 請改為指定 PartitionsFilter 參數。

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

指定 Service Fabric 服務的 URI。

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

指定作業的逾時期間,以秒為單位。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

System.Uri

輸出

System.Object