Vorschau · Entwicklungsstand 1.6.1

Windows-Sicherheitsstatus

Wofür ist das gedacht?

Zustandsabfrage: Windows-Sicherheitsstatus. 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. Administratorrechte sind erforderlich.

Windows-Sicherheitsstatus verstehen

1
Zweck
Zustandsabfrage: Windows-Sicherheitsstatus. 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. Administratorrechte sind erforderlich.
2
Beispiel
Wähle security.status im Step „Windows-Zustand abfragen“ und verbinde einen unten beschriebenen Ergebniswert mit einer Bedingung.
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

Ergebnis	Bedeutung
Exists	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
Is Enabled	Ob die abgefragte Funktion/Hardware vom System als aktiviert gemeldet wird. Einzelwert dieses Ergebnisses.
On Off State	Ein-/Aus-Zustand der entsprechenden Gerätefunktion gemäß Ergebnisvertrag. Einzelwert dieses Ergebnisses.
Status	Vom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses.
Captured At	Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
Error Code	Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Error Message	Lesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

Beispiel

Wähle security.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: security.status

Felder und Zusammenhänge auf einen Blick

1
ExistsErgebnis: exists · Wert
Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert
2
Is EnabledErgebnis: is_enabled · Wert
Ob die abgefragte Funktion/Hardware vom System als aktiviert gemeldet wird
3
On Off StateErgebnis: on_off_state · Wert
Ein-/Aus-Zustand der entsprechenden Gerätefunktion gemäß Ergebnisvertrag
4
StatusErgebnis: status · Wert
Vom zuständigen Windows-Dienst gemeldeter Zustand
5
Captured AtErgebnis: captured_at · Wert
Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis
6
Error CodeErgebnis: error_code · Wert
Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt
7
Error MessageErgebnis: error_message · Wert
Lesbare Diagnose der Windows-Operation

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

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`exists`	`Boolean`	`Single`	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
`is_enabled`	`Boolean`	`Single`	Ob die abgefragte Funktion/Hardware vom System als aktiviert gemeldet wird. Einzelwert dieses Ergebnisses.
`on_off_state`	`Enum` `["Unknown", "Off", "On"]`	`Single`	Ein-/Aus-Zustand der entsprechenden Gerätefunktion gemäß Ergebnisvertrag. Einzelwert dieses Ergebnisses. `Unknown` Die vorhandenen Daten erlauben keinen eindeutigeren Zustand. `Off` Der abgefragte Schalter ist ausgeschaltet. `On` Der abgefragte Schalter ist eingeschaltet.
`status`	`Enum` `["Success", "Unsupported", "AccessDenied", "Timeout", "Failed"]`	`Single`	Vom 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_at`	`DateTime`	`Single`	Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
`error_code`	`Text`	`OptionalSingle`	Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`error_message`	`Text`	`OptionalSingle`	Lesbare 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