Get-ServiceFabricDeployedApplicationHealth

  • リファレンス
モジュール:
ServiceFabric

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

構文

Get-ServiceFabricDeployedApplicationHealth
   [-NodeName] <String>
   [-ApplicationName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-DeployedServicePackagesHealthStateFilter <Int64>]
   [-DeployedServicePackagesFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

説明

Get-ServiceFabricDeployedApplicationHealth コマンドレットは、クラスター内のノードにデプロイされた Service Fabric アプリケーションの正常性を取得します。 Service Fabric では、次の正常性状態が報告されます。

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

指定したノードにアプリケーションがデプロイされていない場合、このコマンドレットはエラーを返します。

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

例

例 1: デプロイされたアプリケーションの正常性を取得する

PS C:\> Get-ServiceFabricDeployedApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -NodeName "Node01"

このコマンドは、Node01 という名前のノードにデプロイされた名前付きアプリケーションの正常性を照会します。

例 2: カスタム正常性ポリシーを使用してデプロイされたアプリケーションの正常性を取得し、フィルターを返す

PS C:\> Get-ServiceFabricDeployedApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -NodeName "Node01" -ConsiderWarningAsError $True -EventsFilter Error -DeployedServicePackagesFilter 'Warning,Error'

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

例 3: デプロイされたアプリケーションの正常性を取得し、正常性統計と正常性イベントを除外する

PS C:\> Get-ServiceFabricDeployedApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -NodeName "Node01" -ExcludeHealthStatistics -EventsFilter None

このコマンドは、Node01 という名前のノードにデプロイされた名前付きアプリケーションの正常性を照会します。 返されたデプロイされたアプリケーションの正常性には、正常性統計も正常性イベントも含まれません。

パラメーター

-ApplicationName

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

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

-ConsiderWarningAsError

正常性評価中に警告正常性レポートをエラーとして扱うかどうかを示します。

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

-DeployedServicePackagesFilter

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

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

-DeployedServicePackagesHealthStateFilter

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

型: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

-NodeName

Service Fabric ノードの名前を指定します。 コマンドレットは、指定したノードにデプロイされたアプリケーションの正常性情報を取得します。

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

-TimeoutSec

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

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

入力

System.String

System.Uri

出力

System.Object