Get-ServiceFabricServiceHealth
Service Fabric サービスの正常性を取得します。
構文
Get-ServiceFabricServiceHealth
[-ServiceName] <Uri>
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyPartitionsPerService <Byte>]
[-MaxPercentUnhealthyReplicasPerPartition <Byte>]
[-EventsHealthStateFilter <Int64>]
[-EventsFilter <HealthStateFilter>]
[-PartitionsHealthStateFilter <Int64>]
[-PartitionsFilter <HealthStateFilter>]
[-ExcludeHealthStatistics]
[-TimeoutSec <Int32>]
[<CommonParameters>] 説明
Get-ServiceFabricServiceHealth コマンドレットは、Service Fabric サービスの正常性を取得します。 正常性ストアに存在しないサービスを指定すると、このコマンドレットは例外を返します。
Service Fabric クラスターで操作を実行する前に、Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。
例
例 1: サービスの正常性を照会する
PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1このコマンドは、指定されたサービスの正常性を取得します。
例 2: カスタム正常性ポリシーを使用してサービスの正常性を取得し、フィルターを返す
PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ConsiderWarningAsError $True -EventsFilter Error -PartitionsFilter 'Warning,Error'このコマンドは、指定されたサービスの正常性を照会します。 正常性ポリシーの値を提供します。 フィルターを使用して、Error イベントと、エラーまたは警告の正常性状態の子のみを返します。
例 3: サービスの正常性を照会し、正常性統計を除外する
PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ExcludeHealthStatisticsこのコマンドは、指定されたサービスの正常性を取得します。 返されるサービス正常性には、サービス正常性の統計情報は含まれません。
パラメーター
-ConsiderWarningAsError
正常性評価中に警告正常性レポートをエラーとして扱うかどうかを示します。
| 型: | Boolean |
| 配置: | 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 |
-MaxPercentUnhealthyPartitionsPerService
サービス内の異常なパーティションの許容される最大割合を指定します。 正常性状態エラーが許容されるパーティションよりも多い場合、サービスの正常性状態はエラーになります。
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaxPercentUnhealthyReplicasPerPartition
異常なパーティション レプリカの許容される最大割合を指定します。 正常性状態エラーが許容されるレプリカよりも多い場合、パーティションの正常性状態はエラーになります。
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionsFilter
正常性状態に基づいて、PartitionHealthState 子のフィルターを指定します。 値は、HealthStateFilterのメンバーに対するメンバーまたはビットごとの操作から取得できます。 フィルターに一致する子のみが返されます。 すべての子は、エンティティの集計された正常性状態を評価するために使用されます。 指定しない場合は、すべてのエントリが返されます。
| 型: | HealthStateFilter |
| 指定可能な値: | Default, None, Ok, Warning, Error, All |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionsHealthStateFilter
このパラメーターは非推奨になりました。 代わりに、PartitionsFilter パラメーターを指定します。
| 型: | Int64 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServiceName
Service Fabric サービスの URI を指定します。
| 型: | Uri |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
System.Uri
出力
System.Object