次の方法で共有


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 は、次の正常性状態を報告します。

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

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

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'

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

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

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

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

パラメーター

-ApplicationName

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

型:Uri
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ConsiderWarningAsError

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

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DeployedApplicationsFilter

正常性の状態に基づいて、DeployedApplicationHealthState 子のフィルターを指定します。 この値は、HealthStateFilterのメンバーに対するメンバーまたはビットごとの操作 取得されます。 フィルターに一致する子のみが返されます。 すべての子は、アプリケーションの集計された正常性状態を評価するために使用されます。 指定しない場合は、すべてのエントリが返されます。

型:HealthStateFilter
指定可能な値:Default, None, Ok, Warning, Error, All
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DeployedApplicationsHealthStateFilter

このパラメーターは非推奨になりました。 代わりに、DeployedApplicationsFilter パラメーターを指定します。

型:Int64
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EventsFilter

正常性状態に基づいてアプリケーションで報告される HealthEvent オブジェクトのコレクションのフィルターを指定します。 値は、HealthStateFilterのメンバーに対するメンバーまたはビットごとの操作から取得できます。 フィルターに一致するイベントのみが返されます。 すべてのイベントは、アプリケーションの集計された正常性状態を評価するために使用されます。 指定しない場合は、すべてのエントリが返されます。

型:HealthStateFilter
指定可能な値:Default, None, Ok, Warning, Error, All
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EventsHealthStateFilter

このパラメーターは非推奨になりました。 代わりに、EventsFilter パラメーターを指定します。

型:Int64
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExcludeHealthStatistics

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaxPercentUnhealthyDeployedApplications

クラスター内のノードにデプロイされた異常なアプリケーション インスタンスの許容される最大許容割合を指定します。 正常性状態エラーが許容されるよりも多くのデプロイ済みアプリケーションがある場合、アプリケーションの正常性状態はエラーになります。 このパラメーターを指定しない場合、正常性評価では、アプリケーション マニフェストで指定された値が使用されます。

型:Byte
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaxPercentUnhealthyPartitionsPerService

異常なサービス パーティションの許容される最大割合を指定します。 正常性状態エラーが許容されるパーティションよりも多い場合、サービスの正常性状態はエラーになります。 このパラメーターを指定しない場合、正常性評価では、アプリケーション マニフェストで指定された値が使用されます。

型:Byte
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaxPercentUnhealthyReplicasPerPartition

異常なパーティション レプリカの許容される最大割合を指定します。 正常性状態エラーが許容されるレプリカよりも多い場合、パーティションの正常性状態はエラーになります。 このパラメーターを指定しない場合、正常性評価では、アプリケーション マニフェストで指定された値が使用されます。

型:Byte
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaxPercentUnhealthyServices

アプリケーション内の異常なサービスの許容される最大割合を指定します。 正常性状態エラーが許容されるサービスよりも多い場合、アプリケーションの正常性状態はエラーになります。 このパラメーターを指定しない場合、正常性評価では、アプリケーション マニフェストで指定された値が使用されます。

型:Byte
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicesFilter

正常性状態に基づいて、serviceHealthState 子 フィルターを指定します。 値は、HealthStateFilterのメンバーに対するメンバーまたはビットごとの操作から取得できます。 フィルターに一致する子のみが返されます。 すべての子は、アプリケーションの集計された正常性状態を評価するために使用されます。 指定しない場合は、すべてのエントリが返されます。

型:HealthStateFilter
指定可能な値:Default, None, Ok, Warning, Error, All
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicesHealthStateFilter

このパラメーターは非推奨になりました。 代わりに、ServicesFilter パラメーターを指定します。

型:Int64
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

System.Uri

出力

System.Object