Schnellübersicht

XOAP Geräte sind Endpunkte, an denen die XOAP-Konnektor Ist installiert und registriert in Ihrem Arbeitsbereich. Sobald die Geräte verbunden sind, werden sie im Inventarmodul sichtbar und können verwendet werden, um Abfragen und Befehle auszuführen, Inventardaten zu sammeln und (falls während der Installation aktiviert) an Image Management Workflows teilzunehmen.

Ein Gerät hinzufügen (XOAP-Connector installieren)

1. Gehen Sie zu Inventar → Geräte und klicken Sie + Gerät hinzufügen.
2. In der Downloaden Sie den XOAP-Connector Im Abschnitt „Zielplattform“ wählen Sie die Zielplattform (Windows / macOS / Linux) aus und klicken Sie auf „Weiter“. Herunterladen.
3. Unter Registrieren und den XOAP-Connector starten, wählen Sie die Option API-Schlüssel Das sollte für die Registrierung verwendet werden.
4. Kopieren Sie den erstellten Installationsbefehl und führen Sie ihn auf dem Zielgerät aus:
   • Windows: ausführen. Windows PowerShell als Administrator
   • Linux/macOS: Starten Sie den Befehl mit entsprechenden Rechten (z. B. unter Verwendung von sudo, falls erforderlich).
5. Nach Abschluss der Installation wird der Connector-Dienst automatisch gestartet.
6. Sobald das Gerät verbunden ist, wird es angezeigt Inventar → Geräte mit einem Online-Status.

Ein Gerät löschen

1. Unter Inventar → Geräte, Klicken Sie auf Aktionsmenü (⋮) nahe am Gerät.
2. Wählen Sie Löschen.
3. Bestätigen Sie die Löschung.

Weitere nützliche Informationen

Voraussetzung für die API-Schlüssel

Um ein Gerät zu registrieren, müssen Sie zunächst eine API-Schlüssel in XOAP (unter Verbindungen). Der Installer verwendet diese Schlüsselnummer, um das Gerät in Ihrem Arbeitsbereich zu registrieren.

Serviceverhalten

Der XOAP-Connector läuft als Dienstprogramm (Windows) / Daemon (Linux/Mac).

Image Management Flagge

Wenn das Gerät für Image Management, Installieren Sie den Anschluss mit dem –imagemanagement Flag, um die erforderliche Funktionalität während der Registrierung zu ermöglichen.

Anforderungen an die Konnektivität

Das Gerät muss in der Lage sein, die XOAP-Backends (HTTPS/443, direkt oder über einen Proxy) zu erreichen, um sich zu registrieren und verbunden zu bleiben.

Geräte vs. Knoten

Ein einziger Endpunkt kann erscheinen beide als ein Gerät in Bestandsaufnahme (XOAP-Anschluss installiert) und als Node in Configuration Management (registriert über die Konfiguration). Es handelt sich um ergänzende Ansichten – die eine schließt die andere nicht aus.

Option für die Massenbereitstellung (PSADT + Application Management)

Die XOAP-Konnektor Der Installer kann als Paket bereitgestellt werden. PSAppDeployToolkit (PSADT) Paketiert und bereitgestellt über Application Management an:

• Bereits erfolgreich verwaltet Knotenpunkte, und
• Neue Endpunkte im Rahmen der Onboarding-Verfahren.

Technische Dokumentation

Die Geräte Seite in Bestandsaufnahme Liste der Endpunkte, an denen die XOAP-Konnektor Ist installiert und in einen Arbeitsbereich registriert. Sobald die Verbindung hergestellt ist, können Geräte die Inventurfunktionen ausführen (z. B. Abfragen via osquery) und unterstützt operative Aktionen wie das Ausführen von Befehlen/Skripten, das Übertragen von Dateien und die Installation von Anwendungen.

Eine Einrichtung kann gleichzeitig in mehreren XOAP-Bereichen verwaltet werden:

• Das gleiche Endpunkt kann als Node in Configuration Management und als Gerät in Bestandsaufnahme. Dies sind verschiedene Funktionsbereiche und Verwerfen Sie einander nicht.

Voraussetzungen

• API-Schlüssel muss in XOAP Connections Bevor Sie den XOAP-Connector installieren bzw. registrieren.
• Für die Installation des Connectors und die Einrichtung des Diensts sind lokale Administrator-/Administrator-Rechte erforderlich.

Installation und Registrierung des XOAP-Connectors

Unter Inventar → Geräte → Agent hinzufügen, Wählen Sie die Plattform und den API-Schlüssel aus. XOAP generiert einen Installationsbefehl, der das Gerät in den richtigen Workspace registriert.

Windows (PowerShell als Administrator):

.\XOAP.Connector.Installer.exe –install –apiKey APIKEY –workspace WORKSPACEID

Linux (unter sudo ausgeführt):

./XOAP.Connector.Installer –install –apiKey APIKEY –workspace WORKSPACEID

Image Management Flagge

Wenn das Gerät für Image Management diesen Zweck verwendet werden soll, installieren Sie den Stecker mit dem Image Management Aufkleber:

.\XOAP.Connector.Installer.exe –install –apiKey APIKEY –workspace WORKSPACEID –ImageManagement

Wenn Image Management die Funktion während der Installation nicht aktiviert ist, funktioniert das Gerät weiterhin für die Inventarfunktionen, aber Image Management bestimmte Funktionen sind möglicherweise nicht verfügbar.

Start-up-Service

Nach der Installation wird der XOAP Connector-Dienst automatisch gestartet. Falls erforderlich, kann er auch manuell gestartet werden:

Start-Service XOAPConnector

Was während der Installation des XOAP-Connectors installiert wird

Während der Installation wird das Installationsprogramm XOAP Connector Erkennt zuerst vorhandene Komponenten und installiert nur das, was fehlt oder erforderlich ist. Wenn eine Komponente bereits installiert ist und der erwartete Standard erfüllt, wird dieser Schritt übersprungen.

Komponenten, die vom Installateur bearbeitet werden

1) Binäre Dateien für den XOAP-Connector

• Lädt das neueste Releasepaket des XOAP-Connectors herunter und extrahiert es in:
  • C:\Program Files\XOAP\Connector
• Erstellt/aktualisiert die Konfiguration des Connectors im Rahmen der Registrierung (API-Schlüssel + Arbeitsbereich).

2) XOAP-Connector-Windows-Dienst

• Installiert einen Windows-Dienst mit dem Namen XOAPConnector
• Startet den Dienst nach der Installation (und konfiguriert ihn typischerweise für eine automatische Startoption).

3) Installer-Persistenzdateien

• Die Installations- und Supportdateien werden weiterhin unter:
  • C:\Program Files\XOAP\Installer

4) osquery (Abhängigkeit von Inventory/Queries)

• Erkennt die Installation und die Version von osquery.
• Falls fehlende (oder ältere als erforderlich) Versionen vorhanden sind, werden osquery (MSI)-Downloads und -Installationen angeboten.
• Wenn die bereits installiert ist und die Version gleich oder älter ist als die erforderliche, wird die Installation übersprungen.

5) Unterstützendes Werkzeug (vorbereitete Installationsprogramme / Voraussetzungen)

Der Installer kann Voraussetzungen bereitstellen, die von XOAP-Workflows verwendet werden (abhängig von der Verwendung des Szenarios bzw. der Funktion):

• Verpacker (in Verbindung mit Image Management-bezogenen Workflows allgemein erforderlich)
• Azure CLI (verwendet bei der Interaktion mit Azure-Workflows)
• Initialisierung von WinGet Möglicherweise kann es zur Unterstützung der Voraussetzung für die Handhabung unter Windows ausgeführt werden.

Temporäre Download-Standorte

Heruntergeladene Pakete (z. B. Connector ZIP und osquery MSI) werden normalerweise unter dem Pfad „staging“ abgelegt:

• C:\Users\\AppData\Local\Temp…

Aktualisieren und Deinstallieren (optionaler Betriebskommandos)

Je nachdem, wie Ihre Distribution bzw. Installationssoftware aufgebaut ist, kann das Connector-Tool Lifecycle-Operationen wie folgt unterstützen:

Aktualisierung

\XOAP.Connector-Installer.exe – Update

Deinstallieren

.\XOAP.Connector-Installer.exe – Deinstallation

Aktivitäten des Geräts in „Inventar“

Aus dem Menü der Geräteaktionen (⋮) Sie können auf einem angeschlossenen Gerät Aktionen durchführen, wie zum Beispiel:

• Agentenprotokoll anzeigen: Öffnet die Verbindungslaufzeitprotokolle für die Fehlerbehebung.
• Kommandos ausführen: Ausführt einen Befehl aus der Befehlsbibliothek auf dem Gerät.
• Abfragen ausführen: Ausführt eine osquery-basierte Inventarabfrage auf dem Gerät.
• Skript ausführenLädt ein Skript auf dem Gerät aus.
  • Skripts werden aus der XOAP-Ressourcen Bereich (Skripts müssen zunächst als Ressourcen vorhanden sein).
• Anwendungen installierenZuweisung und Auslösen von App-Installationen (je nach Ihrer Application Management Konfiguration).
• Datei übertragen:
  • Herunterladen: Einen Dateivorgang vom Gerät in das XOAP übertragen (optional können Sie ihn in „Ressourcen“ speichern).
  • Hochladen: Laden Sie eine Datei entweder aus den XOAP-Ressourcen oder von Ihrem lokalen Rechner auf das Gerät hoch.
• Löschen: Entfernt das Gerät aus der Inventarliste (die Deinstallation des Geräts erfolgt separat und ist ein eigenständiger Vorgang).

Weitere Informationen

Geräte vs. Knoten

Ein Gerät kann als Gerät (Bestandsliste) und ein Node (Configuration Management) gleichzeitig.

Masseninstallation

Der XOAP-Connector kann verpackt werden (zum Beispiel als PSAppDeployToolkit (PSADT) Paket) und in großem Maßstab implementiert Application Management für bestehende verwaltete Nodes – und wird auch als standardisiertes Installationsprogramm für neue Geräte verwendet.

Image Management Unterstützung

Wenn eine Vorrichtung dazu bestimmt ist, an Image Management, Installieren Sie –imagemanagement von Anfang an, um sicherzustellen, dass die korrekten Funktionen aktiviert sind.

Auf der Maschine können die Protokolle des lokalen XOAP-Connectors im Ereignisprotokoll / Windows-Log / Anwendung angezeigt werden.

The post Devices appeared first on XOAP.

Schnellübersicht

XOAP Abfragen Suchen Sie nach SQL-basierten Abfragen, die direkt auf verwalteten Geräten ausgeführt werden, um Bestands- und Betriebsinformationen zu sammeln. Wenn die XOAP-Konnektor Ist installiert, wird es auch installiert. osquery, Die XOAP-Anfragen verwenden diesen osquery-Motor, um SQL-Anweisungen am Endpunkt auszuführen und die Ergebnisse an XOAP zurückzugeben.

Erstellen Sie eine neue Abfrage

1. Unter Bestandsliste → Abfragen, klicken + Anfrag hinzufügen.
2. Geben Sie einen Abfrage-Name.
3. Wählen Sie das Ziel aus OS.
4. (Optional) Hinzufügen Tags und ein Beschreibung.
5. Unter Kommandos, Fügen Sie die SQL-Anforderung ein, die auf dem Gerät ausgeführt werden soll.
6. Klicken Sie auf Hinzufügen Um die Abfrage zu erstellen.

Eine Abfrage bearbeiten

1. Öffnen Sie die Detailinformationen der Abfrage (z. B. über die Schaltfläche „Details“). Details Option/Symbol).
2. Klicken Sie auf bearbeiten.
3. Aktualisieren Sie die Metadaten der Abfrage (Name, Betriebssystem, Tags, Beschreibung) und/oder die Kommandos.
4. Speichern Sie Ihre Änderungen.

Eine Abfrage löschen

1. Wählen Sie in der Liste „Abfragen“ die Abfrage (oder mehrere Abfragen) aus.
2. Löschen Sie es mithilfe des Befehls Löschen Option/Symbol.
3. Bestätigen Sie die Löschung.

Weitere nützliche Informationen

OS-Kompatibilität

Nicht alle Abfragen funktionieren auf allen Betriebssystemen. Als Best-Practice empfiehlt es sich, den Betriebssystembereich in dem Abfrage-Name anzugeben (z. B. WIN_, LINUX_, MAC_ oder ALL_), damit klar ist, ob eine Abfrage OS-spezifisch oder universell ist.

Halten Sie Abfragen effizient

Wählen Sie gezielte Filter und begrenzen Sie die Ergebnisgröße, wo immer möglich. Heikle Abfragen (große Tabellen, viele Joins oder umfangreiche Scans) können die Belastung der Endpunkte erhöhen und die Datenerfassung verlangsamen.

Technische Dokumentation

Abfragen In XOAP sind SQL-Anweisungen, die auf Endpunkten ausgeführt werden Um Inventar- und sicherheitsrelevante Informationen (Software, Benutzer, Prozesse, Dienste, Browser-Erweiterungen, lokale Gruppen usw.) abzurufen. XOAP nutzt diese Abfragen, um strukturierte Daten von Geräten zu sammeln und diese zentral im Inventar-Modul darzustellen.

osquery ist ein Open-Source-Endpunkt-Agent, der Daten des Betriebssystems über eine API bereitstellt. SQL-Schnittstelle. Intern verarbeitet es OS-Informationen in virtuelle “Tabellen” (z. B. Prozesse, Benutzer, Dienste, Programme, Chrome-Erweiterungen), die mithilfe der Standard-SQL-Syntax abfragbar sind. Das Ergebnis ist eine konsistente, abfragbare Inventarstruktur auf allen unterstützten Plattformen.

Wenn die XOAP-Konnektor ist auf einem Gerät installiert, osquery wird als Teil der Installation bereitgestellt. XOAP löst dann die konfigurierten SQL-Abfragen am Endpunkt mithilfe des Connectors aus und sammelt die Ergebnisse erneut in XOAP für Berichterstellung und Analyse.

Hochvolumiger Fluss:

1. Sie definieren eine Query (SQL + Metadaten des Ziel-Betriebssystems) in XOAP.
2. Das XOAP-Plugin löst die Ausführung auf ausgewählten Endpunkten mithilfe des XOAP-Connectors aus.
3. osquery führt die SQL-Anweisung lokal aus und gibt die Ergebnisse als Zeilen zurück.
4. XOAP verarbeitet die zurückgegebenen Daten und zeigt sie in Inventory an.

Hier sind einige einfache osquery-SQL-Beispiele, die Sie als Vorlagen verwenden können:

Grundinformationen zum System

SELECT hostname, cpu_type, cpu_subtype, physical_memory

Aus system_info;

Liste lokaler Benutzer

SELECT username, uid, description

VOM Nutzern

ORDER BY username;

Installierte Software (Windows-spezifisch)

SELECT name, version, install_location, publisher

Aus Programmen

ORDER BY Name;

Das Schema der osquery-Tabellen ist auf https://osquery.io/schema/5.21.0/

The post Queries appeared first on XOAP.

Schnellübersicht

Befehlsbibliothek ist ein zentrales Repository für wiederverwendbare Befehle, die auf verwalteten Geräten ausgeführt werden können. Es ermöglicht Ihnen, gemeinsame operative Aufgaben (z. B. Fehlerbehebung, Datenerhebung, schnelle Überprüfungen) standardisieren zu können, indem Befehle an einem Ort gespeichert und in der gesamten Umgebung wiederverwendet werden. Befehle können für verschiedene Laufzeiten erstellt werden, wie z. B. PowerShell, PowerShell Core, Bash/Shell, oder CMD.

Eine neue Befehlsfunktion hinzufügen

1. Klicken Sie auf + Befehl hinzufügen.
2. Geben Sie einen Kommandoname.
3. Wählen Sie die Option „ Typ (z. B. PowerShell Core, PowerShell, Bash/Shell, CMD).
4. (Optional) Hinzufügen Tags und ein Beschreibung.
5. Kopieren oder schreiben Sie die Kommandos Inhalt.
6. Klicken Sie auf Hinzufügen um den Befehl zu erstellen.

Ein Befehl bearbeiten

1. Öffnen Sie den Befehl (z. B. über die Details / Symbol für das Auge).
2. In der Aktuelle Version Panel, klicken bearbeiten.
3. Aktualisieren Sie den Befehlsinhalt und/oder die Metadaten nach Bedarf.
4. Die Änderungen speichern (eine neue Version wird erstellt).

Ein Befehl löschen

1. Klick auf den Löschen (Müll-)Symbol neben dem Befehl.
2. Die Löschung bestätigen.

Weitere nützliche Informationen

OS-Kompatibilität

Einige Befehlstypen sind OS-spezifisch. Verwenden Tags (z. B. Windows, Linux) und/oder Namenskonventionen, um die Zielplattform eindeutig anzugeben.

Vorzugsweise nicht-interaktive Befehle

Verwenden Sie keine Anweisungen und Interaktionen mit der Benutzeroberfläche; Befehle sollten unbeaufsichtigt ausgeführt werden.

Halten Sie die Ausgabe lesbar

Zur Vereinfachung der Fehlerbehebung und der Überprüfung sollten klare, strukturierte Ausgaben zurückgegeben werden (und Fehlerbehandlung integriert sein).

Technische Dokumentation

Die Befehlsbibliothek ist das zentrale Store von XOAP Verknüpfte und wiederverwendbare Befehle Dieses Tool kann auf verwalteten Geräten über die XOAP Inventory/Connector-Ausführungsebene ausgeführt werden. Es ist für operative Aufgaben wie Fehlerbehebung, Validierungskontrollen, Protokollaufzeichnung und leichte Sanierungsmaßnahmen konzipiert.

Ein Befehl in der Bibliothek wird definiert durch:

• Metadaten (Name, Beschreibung, Tags)
• Auslaufzeitart (PowerShell, PowerShell Core, Bash/Shell, CMD)
• Kommandobereich (der eigentliche Skript-/Kommandotext)
• Informationen zur Version (Versionennummer und Nachricht)

Befehle werden auf Geräten ausgeführt, die die XOAP-Konnektor Installiert.

Kommandotypen (Runtime)

Wenn Sie einen Befehl erstellen, wählen Sie eine Typ das definiert den Interpreter/Runtime, der auf dem Gerät verwendet wird:

• PowerShell
  Ausführung unter Windows PowerShell (typischerweise 5.1 unter Windows).
• PowerShell Core
  Ausführung unter PowerShell 7+ (unter Windows und Mac OS X, wenn verfügbar).
• Bash/Shell
  Ausführung mithilfe eines Shell-Befehls unter Linux/macOS (typischerweise /bin/bash oder /bin/sh, abhängig vom Gerät).
• CMD
  Ausführung unter Windows unter Verwendung des Befehlszeilentools (cmd.exe).

Verhaltensweisen bei der Versionierung

Die Befehle sind Versionierte Artefakte. Jede Änderung der Befehlsdefinition (insbesondere des Befehlskörpers) sollte als neue Version behandelt werden, damit Sie:

• Verfolgen Sie, wer was geändert hat und warum
• Rollen Sie sicher vorwärts
• Halten Sie operative Aktionen in allen Umgebungen reproduzierbar.

Bestes Beispiel: Verwenden Sie kurze, aussagekräftige Versionsnachrichten (z. B. “Servicefilter hinzufügen”, “Pfadangabe korrekt zitieren”, “Support für PS7”).

Felder und ihre Bedeutung

In der Kommandos hinzufügen Dialog:

• Kommandoname
  Ein einzigartiger, menschlich lesbarer Identifikator. Verwenden Sie ein konsistentes Namensschema wie:
  windows-check-service-status / linux-journalctl-last-50
• Typ
  Der Laufzeit-/Interpreter, der zum Ausführen des Befehls auf dem Zielgerät verwendet wird.
• Tags
  Verwendet zur Filterung und Organisation (OS, Zweck, Team, Umgebung).
• Beschreibung (optional)
  Kurze Erklärung der Absicht, der erwarteten Ergebnisse und etwaiger Voraussetzungen.
• Kommandos
  Der Inhalt des Skripts bzw. der Befehle. Dies sollte nicht-interaktiv sein und sicher sein, dass es wiederholt ausgeführt werden kann.

Ausführungsmodell und Ergebnis

Befehle werden remote ausgeführt und liefern die folgende Rückmeldung:

• Ausgangscode (Erfolg/Misserfolg)
• Standardausgabe (Ergebnisse)
• Standardfehler (Fehler)

Empfohlene Muster

• Zurück Lesbarer Output für den Menschen Zusätzlich einfache strukturierte Ausgaben, sofern möglich (Key/Value-Zeilen).
• Verwenden Sie explizite Ausgabecode:
  • 0 = Erfolg
  • Nicht-Null = Versagen oder partieller Versagen
• Fehler werden an stderr geschrieben und die stdout wird für normale Ergebnisse beibehalten.

Operationelle und Sicherheitsaspekte

Nur nicht-interaktive Version

• Verwenden Sie keine Aufforderungen (Lesen-Host, Pause, interaktive Bestätigung).
• Angenommen, der Befehl wird unbeaufsichtigt ausgeführt.

Idempotenz

• Ich bevorzuge Befehle, die mehrfach ausgeführt werden können, ohne schädliche Nebenwirkungen.
• Bei Befehlen zur Fehlerbehebung ist vor dem Ändern des Zustands der aktuelle Status zu prüfen.

Protokollierung

• Bei Problemlösungsvorgängen sollten Kontextinformationen (Hostname, Zeitstempel, relevante Versionen) angegeben werden.

Best Practices für das Erstellen einer wartungsfähigen Bibliothek

• Namenskonvention: os-purpose-action (z. B. windows-inventory-installed-software)
• Kennzeichnung: OS + Team + Kategorie (z. B. Windows, Sicherheit, Fehlerbehebung)
• Geringer Umfang: Ein Befehl = ein Ziel. Vermeiden Sie “alles tun”-Skripte.
• Dokumentanforderungen: Benötigte Tools, Module, Berechtigungen oder Pfade.
• Test für Piloten: Validieren Sie die Funktion auf einer kleinen Anzahl von Geräten, bevor sie umfassend eingesetzt wird.
• Ich bevorzuge PowerShell Core für die Cross-Plattform-Funktionalität: Wenn Ihre Flotte dies unterstützt, vereinfacht dies die Wiederverwendung.

Beispiele (einfache, sichere Befehle)

PowerShell (Windows) – Liste des Servicezustands

Get-Service -Name “WinRM” | Select-Object Name, Status, StartType

PowerShell (Windows) – letzte 50 Ereignisprotokollfehler (System)

Get-WinEvent -LogName System -MaxEvents 50 |
  Where-Object { $_.LevelDisplayName -in “Error”,”Critical” } |
  Select-Object TimeCreated, Id, ProviderName, Message

CMD (Windows) – grundlegende Netzwerkinformationen

ipconfig /all

Bash (Linux) – Zusammenfassung der Festplattennutzung

df -h

Fehlerbehebung

Wenn ein Befehl nicht ausgeführt werden kann oder unerwartete Ergebnisse liefert, sind die häufigsten Ursachen:

• Fehlend Typ Ausgewählt (z. B. Bash-Befehl unter Windows)
• Der Runtime ist nicht installiert (z. B. fehlt PowerShell 7 für die “PowerShell Core”-Befehle)
• Unterschiede in den Betriebssystemen (Verläufe, Tools, Service-Manager)
• Das Kommando ist interaktiv oder erfordert ein TTY

Empfehlung: Beginnen Sie mit diagnostischen Befehlen zur Leseeinheit, fügen Sie dann Sanierungsmaßnahmen erst nach der Validierung und nach einer klaren Zustimmung hinzu.

The post Commands library appeared first on XOAP.