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 |
指定可能な値: | 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