Share via


Get-ServiceFabricApplicationHealth

取得 Service Fabric 應用程式的健全狀況。

Syntax

Get-ServiceFabricApplicationHealth
   [-ApplicationName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyDeployedApplications <Byte>]
   [-MaxPercentUnhealthyServices <Byte>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ServicesHealthStateFilter <Int64>]
   [-ServicesFilter <HealthStateFilter>]
   [-DeployedApplicationsHealthStateFilter <Int64>]
   [-DeployedApplicationsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

Get-ServiceFabricApplicationHealth Cmdlet 會取得 Service Fabric 應用程式的健全狀態。 Service Fabric 會報告下列健全狀況狀態:

  • 正常。 實體符合健康情況指導方針。
  • 錯誤。 實體不符合健康情況指導方針。
  • 警告。 實體符合健康情況指導方針,但遇到一些問題。

如果在健康狀態存放區中找不到實體,此 Cmdlet 會傳回錯誤。

在 Service Fabric 叢集上執行任何作業之前,請使用 Connect-ServiceFabricCluster Cmdlet 建立叢集的連線。

範例

範例 1:取得應用程式的健康情況

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist

此命令會查詢具名應用程式的健康情況。

範例 2:使用自訂健康情況原則取得應用程式的健康情況,並傳回篩選

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ConsiderWarningAsError $True -EventsFilter Error -ServicesFilter 'Error,Warning' -DeployedApplicationsFilter 'Warning,Error'

此命令會查詢具名應用程式的健康情況。 命令會指定健康情況原則的值,並使用篩選只傳回 Error 事件,以及具有 Error 或 Warning 健康狀態的子系。

範例 3:取得應用程式的健康情況,並排除健康情況統計資料

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ExcludeHealthStatistics

此命令會查詢具名應用程式的健康情況。 傳回的應用程式健康情況不包含健康情況統計資料。

參數

-ApplicationName

指定 Service Fabric 應用程式的統一資源識別項 (URI) 。 Cmdlet 會取得您指定 URI 的應用程式健康情況資訊。

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

-ConsiderWarningAsError

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

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

-DeployedApplicationsFilter

根據健康情況狀態,指定 DeployedApplicationHealthState 子系的篩選準則。 此值是從 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

-DeployedApplicationsHealthStateFilter

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

Type:Int64
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

-MaxPercentUnhealthyDeployedApplications

指定叢集中節點上所部署狀況不良應用程式實例的最大容許百分比。 如果已部署的應用程式比容許的健康狀態錯誤還多,則應用程式的健全狀況狀態為錯誤。 如果您未指定此參數,健康情況評估會使用應用程式資訊清單中提供的值。

Type:Byte
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

-MaxPercentUnhealthyServices

指定應用程式中狀況不良服務的最大容許百分比。 如果健康狀態錯誤超過容許的服務,應用程式的健康情況狀態就會發生錯誤。 如果您未指定此參數,健康情況評估會使用應用程式資訊清單中提供的值。

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

-ServicesFilter

根據健全狀況狀態指定 ServiceHealthState 子系的篩選。 您可以從 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

-ServicesHealthStateFilter

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

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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