Vorschau · Entwicklungsstand 1.6.1

Windows-Update-Status

Wofür ist das gedacht?

Zustandsabfrage: Windows-Update-Status. Liest den aktuellen vom System angebotenen Zustand und stellt die hier aufgeführten typisierten Werte bereit. Wähle die Funktion im Windows-Auswahldialog; die verfügbaren Parameter stehen unten. Der Katalog verlangt keine erhöhte Ausführung; einzelne Systemzugriffe können dennoch Rechte voraussetzen.

Windows-Update-Status verstehen
  1. 1
    Zweck

    Zustandsabfrage: Windows-Update-Status. Liest den aktuellen vom System angebotenen Zustand und stellt die hier aufgeführten typisierten Werte bereit. Wähle die Funktion im Windows-Auswahldialog; die verfügbaren Parameter stehen unten. Der Katalog verlangt keine erhöhte Ausführung; einzelne Systemzugriffe können dennoch Rechte voraussetzen.

  2. 2
    Beispiel

    Wähle windows_update.status im Step „Windows-Zustand abfragen“ und verbinde einen unten beschriebenen Ergebniswert mit einer Bedingung.

  3. 3
    Hinweise

    Verfügbarkeit und Ereignisevidenz hängen von Windows-Version, installiertem Gerät/Dienst und Rechten ab. Die Abfrage ist ein zeitlicher Snapshot. Nur die im Katalog gesetzten Unterstützungsmerkmale verwenden: eine reine Änderungsfunktion liefert keinen eigenen Abfragevertrag, eine reine Abfrage ist kein Ereignistrigger. Bei Windows-Einstellungen den Erfolg und Fehlercode im Step-Ergebnis prüfen.

Orientierung für die Bedienung. Technische Verträge stehen im Entwicklerbereich am Seitenende.

Ergebniswerte verwenden

ErgebnisBedeutung
Pending RestartOb Windows Update noch einen Neustart verlangt. Einzelwert dieses Ergebnisses.
StatusVom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses.
Captured AtZeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
Error CodeMaschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Error MessageLesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

Beispiel

Wähle windows_update.status im Step „Windows-Zustand abfragen“ und verbinde einen unten beschriebenen Ergebniswert mit einer Bedingung.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Verfügbarkeit und Ereignisevidenz hängen von Windows-Version, installiertem Gerät/Dienst und Rechten ab. Die Abfrage ist ein zeitlicher Snapshot. Nur die im Katalog gesetzten Unterstützungsmerkmale verwenden: eine reine Änderungsfunktion liefert keinen eigenen Abfragevertrag, eine reine Abfrage ist kein Ereignistrigger. Bei Windows-Einstellungen den Erfolg und Fehlercode im Step-Ergebnis prüfen.

Entwickler- und Agenten-Doku JSON, Feldnamen, Typen und Verträge

Dieser Bereich erklärt die Bearbeitung von Textdateien und die technischen Verträge. Zur Entwickler-Doku

Identifier: windows_update.status

Felder und Zusammenhänge auf einen Blick
  1. 1
    Pending RestartErgebnis: pending_restart · Wert

    Ob Windows Update noch einen Neustart verlangt

  2. 2
    StatusErgebnis: status · Wert

    Vom zuständigen Windows-Dienst gemeldeter Zustand

  3. 3
    Captured AtErgebnis: captured_at · Wert

    Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis

  4. 4
    Error CodeErgebnis: error_code · Wert

    Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt

  5. 5
    Error MessageErgebnis: error_message · Wert

    Lesbare Diagnose der Windows-Operation

Schematische Übersicht: Beschriftungen und Werte aus der Referenz, keine nachgezeichnete Bedienoberfläche.

Ergebnisvertrag

ErgebnisTyp / OptionenAnzahlErklärung
pending_restartBooleanSingleOb Windows Update noch einen Neustart verlangt. Einzelwert dieses Ergebnisses.
statusEnum
["Success", "Unsupported", "AccessDenied", "Timeout", "Failed"]
SingleVom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses.
Success
Windows-Aufruf erfolgreich. Erst anschließend den fachlichen Ergebniswert auswerten.
Unsupported
Funktion auf diesem Zielsystem nicht unterstützt.
AccessDenied
Windows verweigert den Zugriff; kein negativer fachlicher Zustand, sondern fehlende Berechtigung.
Timeout
Windows-Aufruf überschritt seine Zeitgrenze; daraus keinen Systemzustand ableiten.
Failed
Lauf wegen Fehler fehlgeschlagen.
captured_atDateTimeSingleZeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
error_codeTextOptionalSingleMaschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
error_messageTextOptionalSingleLesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag