Send-ServiceFabricReplicaHealthReport
Sendet einen Integritätsbericht für ein Service Fabric-Replikat.
Syntax
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-ReplicaId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-InstanceId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Beschreibung
Das cmdlet Send-ServiceFabricReplicaHealthReport sendet einen Integritätsbericht über eine Dienst fabric-Zustandslose Dienstinstanz oder ein zustandsbehaftetes Dienstreplikat.
Die zustandslose Dienstinstanz oder das statusbehaftete Dienstreplikat müssen bereits im Integritätsspeicher vorhanden sein. Um zu überprüfen, ob es vorhanden ist, verwenden Sie das Cmdlet Get-ServiceFabricReplicaHealth, und geben Sie die Parameter PartitionId und ReplicaOrInstanceId an. Alternativ können Sie das Cmdlet Get-ServiceFabricPartitionHealth mit dem Parameter PartitionId verwenden und dann den Abschnitt "ReplicaHealthStates" überprüfen, um das Replikat 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 aktiv gehalten werden.
Das Cmdlet kann Erfolg zurückgeben, der Bericht wird jedoch asynchron gesendet, sodass die Verarbeitung fehlschlägt. Um festzustellen, ob der Bericht im Integritätsspeicher angewendet wurde, verwenden Sie die Get-ServiceFabricReplicaHealth Cmdlet, und überprüfen Sie, ob der Bericht im Abschnitt "Integritätsereignisse" angezeigt wird.
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: Bericht über die Fehlerintegrität eines zustandsbehafteten Dienstreplikats mit unendlichem TTL
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"Dieser Befehl sendet einen Integritätsbericht für die angegebene Partition für das angegebene zustandsbehaftete Dienstreplikat aus der Quelle MyWatchDog. Der Integritätsbericht enthält Informationen zur Integritätseigenschaft DiskUsage in einem Fehlerstatus mit unendlicher TTL. Dieser Befehl enthält auch eine Beschreibung des Fehlers.
Beispiel 2: Melden des Warnungsstatusberichts zu einer zustandslosen Dienstinstanz, die für die angegebene TTL gültig ist, und entfernen Sie ihn, wenn er abläuft.
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpiredDieser Befehl sendet einen Integritätsbericht für die angegebene zustandslose Dienstinstanz aus der Quelle MyWatchDog. Der Integritätsbericht enthält Informationen zur Integritätseigenschaft Resources in einem Status "Warnung" aus der Quelle "MyWatchdog" mit 10 Sekunden TTL. Der Bericht, der zum Entfernen am Ablauf markiert wurde.
Parameter
-Description
Gibt lesbare Informationen zu der Bedingung an, die den Bericht ausgelöst hat. Die SourceId, HealthPropertyund HealthState Parameter beschreiben den Bericht vollständig.
Die maximale Zeichenfolgenlänge für die Beschreibung beträgt 4096 Zeichen. Wenn die angegebene 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 Abkürzung erfolgt ist. Die Gesamtgröße der Zeichenfolge beträgt 4096 Zeichen, sodass weniger als 4096 Zeichen aus der ursprünglichen Zeichenfolge beibehalten werden.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-HealthProperty
Gibt die Eigenschaft des Berichts an. Zusammen mit dem SourceId Parameter identifiziert diese Eigenschaft den Bericht eindeutig.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-HealthState
Gibt ein HealthState -Objekt an, das den gemeldeten Integritätszustand darstellt.
| Typ: | HealthState |
| Zulässige Werte: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Immediate
Gibt an, ob der Bericht sofort an den Integritätsspeicher gesendet werden soll. Dies ist nützlich für kritische Berichte, die so schnell wie möglich gesendet werden sollten. Wenn nicht angegeben, wird der Bericht basierend auf den Einstellungen des Integritätsclients gesendet. Daher wird sie gemäß der HealthReportSendInterval-Konfiguration batched. Dies ist die empfohlene Einstellung, da der Integritätsclient die Optimierung von Integritätsberichtsmeldungen an 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InstanceId
Gibt die id der zustandslosen Dienstinstanz an. Die Instanz-ID ist nur für zustandslose Dienste gültig. Ein Bericht für ein zustandsbehaftetes Replikat, das InstanceId- anstelle ReplicaId- verwendet, wird vom Integritätsclient akzeptiert, wird jedoch vom Integritätsspeicher abgelehnt.
| Typ: | Int64 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PartitionId
Gibt die ID einer Service Fabric-Partition an.
| Typ: | Guid |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | 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 nach ablaufendem Ablauf 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ReplicaId
Gibt die statusbehaftete Dienstreplikat-ID an. Die Replikat-ID ist nur für zustandsbehaftete Dienste gültig. Ein Bericht für eine zustandslose Instanz, die ReplicaId- anstelle von InstaceId- verwendet, wird vom Integritätsclient akzeptiert, wird jedoch vom Integritätsspeicher abgelehnt.
| Typ: | Int64 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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 für dieselbe Entität für die gleiche SourceId- und HealthProperty-festgelegt ist, oder der Bericht wird aufgrund der Veraltetkeit abgelehnt.
| Typ: | Int64 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-SourceId
Gibt den Bezeichner der Quelle an, die den Bericht ausgelöst hat.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| 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 |
-TimeToLiveSec
Gibt die Zeit für Live (TTL) des Berichts in Sekunden an. Wenn der TTL-Wert abläuft, wird der Bericht aus dem Integritätsspeicher entfernt, wenn der RemoveWhenExpired Parameter angegeben ist. Andernfalls wird die Entität aufgrund des abgelaufenen Berichts bei Fehler ausgewertet. Der Standardwert ist Infinite.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
System.Guid
System.Fabric.Health.HealthState
System.String
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