Get-ServiceFabricDeployedServicePackageHealth

Service Fabric サービス パッケージの正常性を取得します。

構文

Get-ServiceFabricDeployedServicePackageHealth
   [-ApplicationName] <Uri>
   [-ServiceManifestName] <String>
   [-NodeName] <String>
   [-ConsiderWarningAsError <Boolean>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ServicePackageActivationId <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

説明

Get-ServiceFabricDeployedServicePackageHealth コマンドレットは、指定されたノードにデプロイされた Service Fabric サービス パッケージの正常性を取得します。 Service Fabric は、次の正常性状態を報告します。

  • OK です。 エンティティは正常性ガイドラインを満たしています。
  • エラー。 エンティティは正常性ガイドラインを満たしていません。
  • 警告。 エンティティは正常性ガイドラインを満たしていますが、いくつかの問題が発生しました。

指定したノードにアプリケーションがデプロイされていない場合、このコマンドレットはエラーを返します。 デプロイされたサービス パッケージが存在しない場合、このコマンドレットはエラーを返します。

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

例 1: デプロイされたサービス パッケージの正常性を取得する

PS C:\> Get-ServiceFabricDeployedServicePackageHealth -ApplicationName fabric:/myapp/persistenttodolist -NodeName "Node01" -ServiceManifestName "ServicePackageA"

このコマンドは、指定されたデプロイ済みサービス パッケージの正常性を照会します。

例 2: カスタム正常性ポリシーを使用してデプロイされたサービス パッケージの正常性を取得し、フィルターを返す

PS C:\> Get-ServiceFabricDeployedServicePackageHealth -ApplicationName fabric:/myapp/persistenttodolist -NodeName "Node01" -ServiceManifestName "ServicePackageA" -ConsiderWarningAsError $True -EventsFilter Error

このコマンドは、カスタム正常性ポリシーとエラー イベント フィルターを使用して、指定されたデプロイ済みサービス パッケージの正常性を照会します。

パラメーター

-ApplicationName

Service Fabric アプリケーションの Uniform Resource Identifier (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

-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

-NodeName

Service Fabric ノードの名前を指定します。 コマンドレットは、指定したノードのサービス パッケージの正常性情報を取得します。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServiceManifestName

Service Fabric サービス マニフェストの名前を指定します。 コマンドレットは、指定したサービス マニフェストの正常性情報を取得します。

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

-ServicePackageActivationId

デプロイされた ServicePackage のアクティブ化 ID。 これは、 Get-ServiceFabricDeployedServicePackage クエリを使用して取得できます。

サービスの作成時に指定した ServicePackageActivationModeNew-ServiceFabricServiceSharedProcess (または指定されていない場合は既定で SharedProcess) の場合、ServicePackageActivationId の値は常に空の文字列であり、指定する必要はありません。 サービス パッケージのアクティブ化 ID の詳細については、[Service Fabric ホスティング モデル][1] を参照してください。

Type:String
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.String

出力

System.Object