Get-ServiceFabricApplicationHealth

Service Fabric アプリケーションの正常性を取得します。

構文

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>]

説明

Get-ServiceFabricApplicationHealth コマンドレットは、Service Fabric アプリケーションの正常性状態を取得します。 Service Fabric では、次の正常性状態が報告されます。

  • OK です。 エンティティは正常性ガイドラインを満たしています。
  • エラー。 エンティティは正常性ガイドラインを満たしていません。
  • 警告。 エンティティは正常性ガイドラインを満たしていますが、いくつかの問題が発生しました。

エンティティが正常性ストアに見つからない場合、このコマンドレットはエラーを返します。

Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例 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'

このコマンドは、名前付きアプリケーションの正常性を照会します。 このコマンドは正常性ポリシーの値を指定し、フィルターを使用してエラー イベントと、エラーまたは警告の正常性状態を持つ子のみを返します。

例 3: アプリケーションの正常性を取得し、正常性統計を除外する

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

このコマンドは、名前付きアプリケーションの正常性を照会します。 返されたアプリケーションの正常性には、正常性統計は含まれません。

パラメーター

-ApplicationName

Service Fabric アプリケーションの Uniform Resource Identifier (URI) を指定します。 コマンドレットは、指定した URI を持つアプリケーションの正常性情報を取得します。

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

-ConsiderWarningAsError

このコマンドレットが、正常性評価中に警告正常性レポートをエラーと見なすかどうかを示します。

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

正常性統計をクエリ結果に含める必要があるかどうかを示します。 指定した場合、正常性統計はクエリ結果の一部として返されません。 それ以外の場合、クエリ結果にはアプリケーションの正常性統計が含まれます。これには、このアプリケーションのサービス、パーティション、レプリカの数に関する情報が含まれます。この状態は OK、警告、エラーです。

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