Get-ServiceFabricDeployedApplicationHealth
ノード上の 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 は、次の正常性状態を報告します。
- わかりました。 エンティティは正常性ガイドラインを満たしています。
- エラー。 エンティティが正常性ガイドラインを満たしていません。
- 警告。 エンティティは正常性ガイドラインを満たしていますが、問題が発生しました。
指定したノードにアプリケーションがデプロイされていない場合、このコマンドレットはエラーを返します。
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 にデプロイされた名前付きアプリケーションの正常性を照会します。 正常性ポリシーの値を指定します。 フィルターを使用して、Error イベントと、エラーまたは警告の正常性状態の子のみを返します。
例 3: デプロイされたアプリケーションの正常性を取得し、正常性統計と正常性イベントを除外する
PS C:\> Get-ServiceFabricDeployedApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -NodeName "Node01" -ExcludeHealthStatistics -EventsFilter None
このコマンドは、Node01 という名前のノードにデプロイされた名前付きアプリケーションの正常性を照会します。 返されるデプロイされたアプリケーションの正常性には、正常性統計も正常性イベントも含まれません。
パラメーター
-ApplicationName
Service Fabric アプリケーションの URI (Uniform Resource Identifier) を指定します。 このコマンドレットは、指定した 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