Get-ServiceFabricDeployedServicePackageHealth

  • リファレンス
モジュール:
ServiceFabric

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) を指定します。 コマンドレットは、指定したアプリケーションのデプロイ済みサービス パッケージの正常性情報を取得します。

型:Uri
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-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

-NodeName

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

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServiceManifestName

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

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServicePackageActivationId

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

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TimeoutSec

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

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

System.Uri

System.String

出力

System.Object