Vorschau · Entwicklungsstand 1.6.1

Windows-Zustand abfragen

Wofür ist das gedacht?

Wähle eine Windows-Funktion mit Zustandsabfrage. Ihr konkreter Ergebnisvertrag bestimmt die verfügbaren Werte; ein Wechsel der Funktion kann bestehende nachfolgende Referenzen ungültig machen. Nutze beispielsweise Netzwerkstatus, Leerlauf oder laufende Prozesse für eine Bedingung.

Einstellungen in der Oberfläche

Beispielwerte dienen zur Orientierung. Passe Pfade, Quellen und Geräte an deinen Arbeitsplatz an. Ein ausgeschaltetes Häkchen und die Zahl 0 sind ebenfalls gültige Beispielwerte.

Einstellung	Bedeutung und Bedienung	Beispielwert
Windows-Funktion	Windows-Funktion und dazugehörige Parameter im Editor. Wähle eine Funktion, die die gewünschte Abfrage/Änderung tatsächlich unterstützt.	Systemlautstärke · 50

Ergebniswerte verwenden

Ergebnis	Bedeutung
Is Connected	Ob die Verbindung zum Zeitpunkt der Abfrage hergestellt war. Einzelwert dieses Ergebnisses.
Connectivity	Vom Netzwerkprovider gemeldete Verbindungsqualität beziehungsweise Konnektivität. Einzelwert dieses Ergebnisses.
Connection Type	Art der ermittelten Netzwerkverbindung, soweit vom System verfügbar. Einzelwert dieses Ergebnisses.
Name	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Count	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
Items	Liste abgefragter Objekte, zum Beispiel Geräte, Monitore, Drucker oder Laufwerke. Mitglieder besitzen die in dieser Referenz aufgeführten Unterwerte. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
Items / Count	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. 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

process.running mit name=notepad abfragen und is_running als Bedingung verwenden.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Prüfe die in dieser Referenz beschriebenen aktiven Pflichtfelder, kompatible Wertequellen und die Voraussetzungen auf dem Zielrechner. Ungültige Quellen oder Typen sind Fehler; eine gültige, aber nicht verfügbare optionale Quelle kann gemäß Eingabevertrag zum Überspringen führen. Ein Fehler beendet die Start-/Hauptphase; die vorgesehene Endphase wird zum Aufräumen behandelt. Der Verlauf zeigt den tatsächlich belegten Status.

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_state_query

Felder und Zusammenhänge auf einen Blick

1
Windows-Funktioncapability · Object · {"capability_id": "network.connectivity", "parameters": {}}
Windows-Funktion und dazugehörige Parameter im Editor
2
Is ConnectedErgebnis: is_connected · Wert
Ob die Verbindung zum Zeitpunkt der Abfrage hergestellt war
3
ConnectivityErgebnis: connectivity · Wert
Vom Netzwerkprovider gemeldete Verbindungsqualität beziehungsweise Konnektivität
4
Connection TypeErgebnis: connection_type · Wert
Art der ermittelten Netzwerkverbindung, soweit vom System verfügbar
5
NameErgebnis: name · Wert
Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts
6
CountErgebnis: count · Wert
Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar
7
ItemsErgebnis: items · Wert
Liste abgefragter Objekte, zum Beispiel Geräte, Monitore, Drucker oder Laufwerke
8
Items / CountErgebnis: items.count · Wert
Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar
9
StatusErgebnis: status · Wert
Vom zuständigen Windows-Dienst gemeldeter Zustand
10
Captured AtErgebnis: captured_at · Wert
Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis
11
Error CodeErgebnis: error_code · Wert
Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt
12
Error MessageErgebnis: error_message · Wert
Lesbare Diagnose der Windows-Operation

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

Feldtypen, Standards und Regeln

Wert	Typ	Standard laut Vertrag	Optionen und Regeln	Erklärung
Windows-Funktion `capability`	`Object`	`{"capability_id": "network.connectivity", "parameters": {}}`	Pflichtfeld	Windows-Funktion und dazugehörige Parameter im Editor. Wähle eine Funktion, die die gewünschte Abfrage/Änderung tatsächlich unterstützt.

JSON-Felder und verschachtelte Einstellungen

Technische Feldnamen des Modells. Die Einstellungsfelder oben beschreiben die UI; die JSON-Vorlage zeigt die tatsächliche Schreibweise. Bei aktuellen inputs/localValues stammen aktive Werte aus den Referenzen. Die Modell-Standardwerte und Enum-Namen sind keine universelle JSON-Schreibweise.

Feld	Modelltyp	Modell-Standard / Optionen	Erklärung
`id`	`String`	`Nicht angegeben`	Stabile Identität dieses Eintrags. In einem Job müssen Step-IDs eindeutig sein; beim Kopieren eines eigenständigen Jobs/Makros eine neue Objekt-GUID erzeugen und interne Referenzen gezielt anpassen.
`inputs`	Dictionary`2	`Nicht angegeben`	Zuordnung von UI-Feld-ID zu typisierter Wertequelle. Bei vorhandenen inputs serialisiert der kanonische Job-Serializer settings nicht zusätzlich. Leere inputs mit settings bleiben als Legacy-/direkte Konfiguration lesbar.
`inputs.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`inputs.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`inputs.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`inputs.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`inputs.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`inputs.provider_id`	`String`	`Nicht angegeben`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`inputs.schema_id`	`String`	`Nicht angegeben`	Versionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
`inputs.source_id`	`String`	`Nicht angegeben`	Anbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
`inputs.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`is_enabled`	`Boolean`	`true`	true führt den Step aus; false deaktiviert ihn. Blockmarker können in der UI nicht beliebig deaktiviert werden, weil ihre Struktur erhalten bleiben muss.
`settings`	`WindowsStateQuerySettings`	`Nicht angegeben`	Direkte beziehungsweise ältere Step-Konfiguration. Für neue referenzbasierte Dateien inputs und localValues verwenden; die UI migriert gespeicherte Literalwerte in lokale Quellen.
`settings.parameters`	Dictionary`2	`Nicht angegeben`	Benannte Parameter der Windows-Funktion beziehungsweise bereinigte Diagnoseparameter im Log. Parameternamen sind stabil und keine UI-Labels.
`settings.query_type`	`String`	`network.connectivity`	Stabile Kennung der Windows-Zustandsabfrage. Nach einem Wechsel nachfolgende Ergebnisbindungen erneut prüfen.

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`is_connected`	`Boolean`	`Single`	Ob die Verbindung zum Zeitpunkt der Abfrage hergestellt war. Einzelwert dieses Ergebnisses.
`connectivity`	`Enum` `["Unknown", "Disconnected", "LocalNetwork", "Internet"]`	`Single`	Vom Netzwerkprovider gemeldete Verbindungsqualität beziehungsweise Konnektivität. Einzelwert dieses Ergebnisses. `Unknown` Die vorhandenen Daten erlauben keinen eindeutigeren Zustand. `Disconnected` Verbindung getrennt beziehungsweise Sitzung nicht verbunden; Bedeutung ergibt sich aus dem jeweiligen Ergebnisfeld. `LocalNetwork` Windows meldet lokale Netzwerkkonnektivität ohne belegten Internetzugang. `Internet` Windows meldet Internetkonnektivität.
`connection_type`	`Enum` `["Unknown", "Ethernet", "WiFi", "Mobile", "Virtual"]`	`Single`	Art der ermittelten Netzwerkverbindung, soweit vom System verfügbar. Einzelwert dieses Ergebnisses. `Unknown` Die vorhandenen Daten erlauben keinen eindeutigeren Zustand. `Ethernet` Kabelgebundene Ethernet-Verbindung. `WiFi` Drahtlose WLAN-Verbindung. `Mobile` Mobilfunkverbindung. `Virtual` Virtueller Netzwerkadapter beziehungsweise virtuelle Verbindung.
`name`	`Text`	`OptionalSingle`	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`count`	`Integer`	`Single`	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
`items`	`Text`	`Collection`	Liste abgefragter Objekte, zum Beispiel Geräte, Monitore, Drucker oder Laufwerke. Mitglieder besitzen die in dieser Referenz aufgeführten Unterwerte. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`items.count`	`Integer`	`Single`	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
`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

JSON-Vorlage für Textdateien und Agenten

Strukturelle Defaultvorlage direkt vom App-Serializer. Leere Pflichtwerte und Ziele vor Verwendung ergänzen; diese Vorlage ist kein vollständig validierter Ablauf. Bei neuen Jobs den aktuellen inputs/localValues-Vertrag verwenden.

Dateiformate und Regeln · JSON herunterladen

{
  "type": "windows_state_query",
  "settings": {
    "query_type": "network.connectivity",
    "parameters": {}
  },
  "id": "6e1150cf-6454-7283-17b2-4a12a6c84fb9",
  "inputs": {},
  "is_enabled": true
}