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