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'

このコマンドは、指定されたサービスの正常性を照会します。 正常性ポリシーの値を提供します。 フィルターを使用して、エラー イベントと、エラーまたは警告の正常性状態を持つ子のみを返します。

例 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

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

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