Freigeben über


Get-ServiceFabricDeployedServicePackageHealth

Ruft den Status eines Service Fabric-Dienstpakets ab.

Syntax

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

Beschreibung

Das cmdlet Get-ServiceFabricDeployedServicePackageHealth ruft den Status eines Service Fabric-Dienstpakets ab, das auf einem angegebenen Knoten bereitgestellt wird. Service Fabric meldet die folgenden Integritätszustände:

  • OKAY. Die Entität erfüllt Integritätsrichtlinien.
  • Fehler. Die Entität erfüllt keine Integritätsrichtlinien.
  • Warnung. Die Entität erfüllt Integritätsrichtlinien, aber es gab ein Problem.

Wenn die Anwendung nicht auf dem angegebenen Knoten bereitgestellt wird, gibt dieses Cmdlet den Fehler zurück. Wenn das bereitgestellte Dienstpaket nicht vorhanden ist, gibt dieses Cmdlet den Fehler zurück.

Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Abrufen des Status eines bereitgestellten Dienstpakets

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

Dieser Befehl fragt den Status des angegebenen bereitgestellten Dienstpakets ab.

Beispiel 2: Abrufen des Status eines bereitgestellten Dienstpakets mit benutzerdefinierten Integritätsrichtlinien und Rückgabefiltern

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

Dieser Befehl fragt den Status des angegebenen bereitgestellten Dienstpakets mit dem Filter für benutzerdefinierte Integritätsrichtlinien und Fehlerereignisse ab.

Parameter

-ApplicationName

Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an. Das Cmdlet ruft Integritätsinformationen für das bereitgestellte Dienstpaket der von Ihnen angegebenen Anwendung ab.

Typ:Uri
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConsiderWarningAsError

Gibt an, ob ein Warnungsstatusbericht während der Integritätsauswertung als Fehler behandelt werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EventsFilter

Gibt den Filter für die Auflistung von HealthEvent- Objekten an, die auf dem Dienstpaket basierend auf dem Integritätszustand gemeldet wurden. Der Wert kann aus Membern oder bitweisen Vorgängen für Elemente von HealthStateFilterabgerufen werden. Es werden nur Ereignisse zurückgegeben, die dem Filter entsprechen. Alle Ereignisse werden verwendet, um den Aggregierten Integritätsstatus des Dienstpakets auszuwerten. Wenn nicht angegeben, werden alle Einträge zurückgegeben.

Typ:HealthStateFilter
Zulässige Werte:Default, None, Ok, Warning, Error, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EventsHealthStateFilter

Dieser Parameter ist veraltet. Geben Sie stattdessen den EventsFilter Parameter an.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeName

Gibt den Namen eines Service Fabric-Knotens an. Das Cmdlet ruft Integritätsinformationen für das Dienstpaket für den von Ihnen angegebenen Knoten ab.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServiceManifestName

Gibt den Namen eines Service Fabric-Dienstmanifests an. Das Cmdlet ruft Integritätsinformationen für das von Ihnen angegebene Dienstmanifest ab.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServicePackageActivationId

Die Aktivierungs-ID der bereitgestellten ServicePackage. Dies kann mithilfe der Abfrage Get-ServiceFabricDeployedServicePackageabgerufen werden.

Wenn ServicePackageActivationMode zum Zeitpunkt des Erstellens des Diensts (mit New-ServiceFabricService) SharedProcess- ist (oder wenn er nicht angegeben ist, in diesem Fall wird standardmäßig SharedProcess), dann ist der Wert ServicePackageActivationId immer eine leere Zeichenfolge und muss nicht angegeben werden. Weitere Informationen zur Aktivierungs-ID des Dienstpakets finden Sie unter [Service Fabric Hosting Model][1].

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.Uri

System.String

Ausgaben

System.Object