Get-ServiceFabricReplicaHealth

Service Fabric レプリカの正常性を取得します。

構文

Get-ServiceFabricReplicaHealth
   [-PartitionId] <Guid>
   [-ReplicaOrInstanceId] <Int64>
   [-ConsiderWarningAsError <Boolean>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

説明

Get-ServiceFabricReplicaHealth コマンドレットは、Service Fabric レプリカの正常性を取得します。 指定したレプリカが正常性ストアに存在しない場合、このコマンドレットは例外を返します。

Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例 1: サービス レプリカの正常性を照会する

PS C:\> $ToDoPartition01 = Get-ServiceFabricPartition -ServiceName fabric:/myapp/persistenttodolist/svc1PS
PS C:\> $ToDoPartition01ReplicaList = Get-ServiceFabricReplica -PartitionId $ToDoPartition01.PartitionId
PS C:\> Get-ServiceFabricReplicaHealth -PartitionId $ToDoPartition01.PartitionId -ReplicaOrInstanceId $ToDoPartition01ReplicaList[0].Id

最初のコマンドでは 、Get-ServiceFabricPartition コマンドレットを使用して Service Fabric サービス パーティション オブジェクトを取得し、それを $ToDoPartition 01 変数に格納します。

2 番目のコマンドは、パーティション内のレプリカの一覧を取得し、$ToDoPartition 01ReplicaList 変数に格納します。

3 番目のコマンドは、$ToDoPartition 01 に格納されているパーティション オブジェクトの PartitionID プロパティと、$ToDoPartition 01ReplicaList 内の最初のレプリカの ID を使用して、サービス パーティション レプリカの正常性を取得します。

例 2: カスタム正常性ポリシーを使用してサービス レプリカの正常性を照会し、フィルターを返す

PS C:\> $ReplicaList = Get-ServiceFabricPartition -ServiceName fabric:/myapp/persistenttodolist/svc1PS | Get-ServiceFabricReplica
PS C:\> Get-ServiceFabricReplicaHealth -PartitionId $ReplicaList[0].PartitionId -ReplicaOrInstanceId $ReplicaList[0].ReplicaId -ConsiderWarningAsError $True -EventsFilter Error

この例では、サービス レプリカの正常性を照会します。 正常性ポリシーの値を指定します。 フィルターを使用して Error イベントのみを返します。

例 3: アプリケーション内のすべてのサービスのすべてのパーティションのすべてのレプリカの正常性を取得する

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/MyApplication | Get-ServiceFabricService | Get-ServiceFabricPartition | Get-ServiceFabricReplica | Get-ServiceFabricReplicaHealth

この例では、指定したアプリケーション内のすべてのサービス レプリカの正常性を取得します。

パラメーター

-ConsiderWarningAsError

正常性評価中に警告正常性レポートをエラーとして扱うかどうかを示します。

Type:Boolean
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

-PartitionId

Service Fabric パーティションの ID を指定します。

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReplicaOrInstanceId

Service Fabric ステートフル サービス レプリカまたはステートレス サービス インスタンス ID を指定します。

Type:Int64
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

System.Guid

System.Int64

出力

System.Object