Send-ServiceFabricDeployedServicePackageHealthReport
Sendet einen Integritätsbericht für ein bereitgestelltes Service Fabric-Dienstpaket.
Syntax
Send-ServiceFabricDeployedServicePackageHealthReport
[-ApplicationName] <Uri>
[-ServiceManifestName] <String>
[-NodeName] <String>
[[-ServicePackageActivationId] <String>]
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Send-ServiceFabricDeployedServicePackageHealthReport sendet einen Integritätsbericht für ein bereitgestelltes Service Fabric-Dienstpaket.
Das bereitgestellte Dienstpaket muss bereits im Integritätsspeicher vorhanden sein. Um zu überprüfen, ob der Dienst vorhanden ist, verwenden Sie das Cmdlet Get-ServiceFabricDeployedServicePackageHealth . Geben Sie den Anwendungsnamen, den Dienstpaketnamen und den Knotennamen an. Alternativ können Sie das Cmdlet Get-ServiceFabricDeployedApplicationHealth verwenden. Geben Sie den Namen und den Knotennamen der Anwendung an, und überprüfen Sie den Abschnitt zum Status des bereitgestellten Dienstpakets, um das Dienstpaket zu finden.
Das Cmdlet sendet den Bericht nach einem Intervall, das vom HealthReportSendIntervalInSec-Parameter des Cmdlets Connect-ServiceFabricCluster angegeben wird. Die Clusterverbindung muss während dieser Zeit lebendig gehalten werden. Der Befehl wird auf dem Client ohne Verweis auf die Ausführung im Integritätsspeicher ausgewertet. Der Bericht wird möglicherweise nicht im Integritätsspeicher angewendet, auch wenn der Befehl Erfolg zurückgibt. Beispielsweise kann der Integritätsspeicher den Bericht aufgrund eines ungültigen Parameters wie etwa einer veralteten Sequenznummer ablehnen.
Um festzustellen, ob der Bericht im Integritätsspeicher angewendet wurde, verwenden Sie das Cmdlet Get-ServiceFabricDeployedServicePackageHealth , und überprüfen Sie, ob der Bericht im HealthEvents-Abschnitt angezeigt wird.
Um Service Fabric-Cluster zu verwalten, starten Sie Windows PowerShell mithilfe der Option "Als Administrator ausführen". Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster und dann das Cmdlet Get-ServiceFabricClusterConnection eine Verbindung mit dem Cluster her.
Beispiele
Beispiel 1: Bericht über fehlerintegrität mit unendlicher TTL
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"
Dieser Befehl sendet einen Integritätsbericht für ein bereitgestelltes Dienstpaket für die Anwendung namens fabric:/MyApplication auf dem Knoten mit dem Namen Node01 für das Dienstmanifest mit dem Namen MyServiceManifest. Der Integritätsbericht enthält Informationen zur Integritätseigenschaft Memory in einem Fehlerstatus aus der Quelle MyWatchdog mit unendlicher TTL. Die Beschreibung wird nicht angegeben, und die Sequenznummer wird automatisch festgelegt.
Beispiel 2: Warnung melden, die für die angegebene TTL gültig ist, und entfernen Sie sie, wenn sie abläuft.
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -ServiceManifestName MyServiceManifest -NodeName "Node01" -HealthProperty "CustomSetup" -HealthState Warning -SourceId MyWatchdog -RemoveWhenExpired -Description "The setup has completed with some warnings." -TimeToLiveSec 10
Dieser Befehl sendet einen Integritätsbericht über ein bereitgestelltes Dienstpaket für die Anwendung namens fabric:/MyApplication für das Dienstmanifest mit dem Namen MyServiceManifest auf dem Knoten "Node01". Der Integritätsbericht enthält Informationen zur Integritätseigenschaft CustomSetup in einem Warnungsstatus aus der Quelle MyWatchdog mit 10 Sekunden TTL. Nachdem der Bericht abläuft, wird er aus dem Integritätsspeicher entfernt und wirkt sich nicht mehr auf die Integritätsbewertung aus. Dieser Befehl enthält auch eine Beschreibung der Warnung.
Parameter
-ApplicationName
Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an. Das Cmdlet sendet einen Integritätsbericht für die Anwendung mit dem von Ihnen angegebenen URI.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
Gibt lesbare Informationen zu der Bedingung an, die den Bericht ausgelöst hat. Die Parameter SourceId, HealthProperty und HealthState beschreiben den Bericht vollständig.
Die maximale Zeichenlänge für die Beschreibung beträgt 4096 Zeichen. Wenn die bereitgestellte Zeichenfolge länger ist, wird sie automatisch abgeschnitten. Wenn die Beschreibung abgeschnitten wurde, endet die Beschreibung mit einer Markierung, "[Abgeschnitten]", um benutzern anzugeben, dass die Abgeschnittenheit aufgetreten ist. Die Gesamtzeichenfolgengröße beträgt 4096 Zeichen, sodass weniger als 4096 Zeichen aus der ursprünglichen Zeichenfolge aufbewahrt werden.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthProperty
Gibt die Eigenschaft des Berichts an. Zusammen mit dem SourceId-Parameter identifiziert diese Eigenschaft den Bericht eindeutig. Der Bericht überschreibt alle vorherigen Berichte mit den gleichen Werten für die Parameter SourceId und HealthProperty für dieselbe Entität.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Gibt ein HealthState-Objekt an, das den gemeldeten Integritätsstatus darstellt.
Type: | HealthState |
Accepted values: | Invalid, Ok, Warning, Error, Unknown |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Immediate
Gibt an, ob der Bericht sofort an den Integritätsspeicher gesendet werden soll. Dies ist für kritische Berichte hilfreich, die schnellstmöglich gesendet werden sollen. Falls nicht angegeben, wird der Bericht basierend auf den Einstellungen des Integritätsclients gesendet. Aus diesem Grund wird der Bericht entsprechend der HealthReportSendInterval-Konfiguration batchweise verarbeitet. Dies ist die empfohlene Einstellung, da der Integritätsclient die Optimierung von Meldungen des Integritätsberichts für den Integritätsspeicher sowie die Verarbeitung von Integritätsberichten ermöglicht. Standardmäßig legt der Powershell Fabric-Client HealthReportSentInterval auf 0 fest, sodass Berichte sofort gesendet werden.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeName
Gibt den Namen eines Service Fabric-Knotens an. Das Cmdlet sendet einen Integritätsbericht für ein Dienstpaket, das auf dem von Ihnen angegebenen Knoten bereitgestellt wird.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RemoveWhenExpired
Gibt an, dass der Bericht beim Ablauf aus dem Integritätsspeicher entfernt wird. Wenn Sie diesen Parameter nicht angeben, wird die Entität im Fehlerzustand betrachtet, wenn die Berichtszeit abläuft. Die Berichte, die bei Ablauf abgelaufen entfernt werden, können für Bedingungen verwendet werden, die nur für einen Bestimmten Zeitraum gültig sind, oder für das Löschen von Berichten aus dem Integritätsspeicher.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SequenceNumber
Gibt die Sequenznummer an, die dem Integritätsbericht zugeordnet ist. Wenn Sie keinen Wert für diesen Parameter angeben, wird die Sequenznummer automatisch festgelegt. Wenn Sie eine Sequenznummer angeben, muss dieser Wert höher als jede vorherige Sequenznummer sein, die auf derselben SourceId und HealthProperty festgelegt ist, oder der Bericht wird aufgrund der Veraltetkeit abgelehnt.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceManifestName
Gibt den Namen eines Service Fabric-Dienstmanifests an. Zusammen mit ApplicationName und NodeName identifiziert dieser Wert eindeutig die bereitgestellte Dienstpaketintegritätsentität.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePackageActivationId
Die Aktivierungs-ID des bereitgestellten ServicePackage. Dies kann mithilfe der Abfrage Get-ServiceFabricDeployedServicePackage abgerufen werden.
Wenn ServicePackageActivationMode zum Zeitpunkt des Erstellens des Diensts (using New-ServiceFabricService
) SharedProcess angegeben ist (oder wenn er nicht angegeben ist, in diesem Fall ist es standardmäßig auf SharedProcess festgelegt), ist der Wert von 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].
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Gibt den Bezeichner der Quelle an, die den Bericht ausgelöst hat.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeToLiveSec
Gibt die Zeit für Live (TTL) des Berichts in Sekunden an. Wenn die TTL abläuft, wird der Bericht aus dem Integritätsspeicher entfernt, wenn der Parameter RemoveWhenExpired angegeben wird. Andernfalls wird die Entität aufgrund des abgelaufenen Berichts bei Fehler ausgewertet. Der Standardwert ist Unendlich.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
System.Uri
System.String
System.Fabric.Health.HealthState
System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Management.Automation.SwitchParameter
System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Ausgaben
System.Object