> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/analysieren-and-exportieren/advanced-search/advanced-search-syntax.md).

# Beispiele für die erweiterte Suche

Abfrageregeln, Operatoren und alle durchsuchbaren Spalten mit ihren Aliasen für die erweiterte Suche in den Tabellen „Benutzer“, „Gruppen“, „Geräte“ und „Pakete“.&#x20;

## Regeln für Abfragen

Eine Abfrage besteht aus reinen Suchbegriffen und Spaltenfiltern, getrennt durch Leerzeichen. Die Regeln:

* **Tokenisierte Suche**:\
  Suchbegriffe werden automatisch tokenisiert, um die Treffergenauigkeit zu verbessern. Wenn man zum Beispiel `lu sk` liefert Treffer wie **Luke Skywalker**. Die Suche verwendet immer einen **starts-with** Ansatz statt einer Volltext- oder "contains"-Suche. Das bedeutet, dass eine Suche nach `walk` würde **nicht** zurückgeben **Skywalker**.
* **Logisches UND**:\
  Alle Filter werden mit logischem **UND**. Jede Bedingung muss erfüllt sein.\
  Beispiel: `Luke Skywalker country:france` sucht nach Luke Skywalker, bei dem die **Land** mit „france“ beginnt.
* **Spaltenbezogene Suche**:\
  Verwenden Sie `column:` um innerhalb einer bestimmten Spalte zu suchen.\
  Beispiel: `country:france` sucht nach Einträgen, bei denen die **Land** mit „france“ beginnt.
* **Operatoren**:
  * `:` → **startsWith** Suche\
    Beispiel: `name:jo` stimmt mit „John“, „Joanna“ usw. überein.
  * `=` → **entspricht** Suche\
    Beispiel: `city=Stuttgart` stimmt exakt mit „Stuttgart“ überein
  * `!=` oder `!:` → **Negation**\
    Beispiel: `city!=Stuttgart` schließt exakt „Stuttgart“ aus, `city!:Stutt` schließt jede Stadt aus, die mit „Stutt“ beginnt. Beide schließen außerdem Einträge aus, bei denen die Spalte leer ist.
* **Besonderes Verhalten**:
  * **Umlaut-Ersetzung**:\
    Umlaute werden in reinen Suchbegriffen normalisiert (z. B., **Björn** kann durch die Suche nach **Bjorn**). Spaltenbezogene Suchen normalisieren Umlaute nicht, daher verwenden Sie `city:München` anstelle von `city:Munchen`.
  * **Unicode-Unterstützung**:\
    Unicode-Zeichen werden in Suchbegriffen unterstützt.
  * **Klammern () werden ignoriert** bei startsWith-Suchen.
  * **Suche nach leeren Werten**:
    * `zip:""` sucht nach leeren Werten
    * `zip:` sucht nach beliebigen Werten
* **Unterstützte Spalten**:\
  Siehe [Unterstützte Spalten](#supported-columns) für jede Spalte und jeden Alias, nach denen Sie suchen können.

## Unterstützte Spalten

Jede der folgenden Tabellen listet die Spalten auf, die Sie in einer spaltenbezogenen Suche verwenden können (`column:value`). Sie können entweder den Spaltennamen oder einen seiner Aliase verwenden, und Groß- und Kleinschreibung spielt keine Rolle, also `upn:`, `UPN:` und `userPrincipalName:` suchen alle in derselben Spalte.

{% hint style="warning" %}
Wenn RealmJoin einen Spaltennamen nicht erkennt, wird dieser Teil der Abfrage ignoriert und die übrigen Filter werden trotzdem angewendet. Wenn Ihre Ergebnisse ungefiltert aussehen, prüfen Sie den Spaltennamen auf Tippfehler.
{% endhint %}

Die **Typ** Die Spalte gibt an, welche Werte eine Spalte akzeptiert:

* **Text**: `:` stimmt mit Werten überein, die mit Ihrer Eingabe beginnen, `=` stimmt mit dem gesamten Wert überein. Groß- und Kleinschreibung spielt keine Rolle.
* **Ja/Nein**: verwenden Sie `wahr` oder `falsch`, zum Beispiel `enabled:false`. `:` und `=` verhalten sich hier gleich.
* **Zahl**: verwenden Sie `=` für einen exakten Wert, zum Beispiel `installFailedDeviceCount=0`Mit `:`, eine Zahl stimmt mit jedem Wert überein, der mit denselben Ziffern beginnt, also `installFailedDeviceCount:1` stimmt auch mit 10 oder 12 überein.
* **Code**: der Wert wird als Zahl gespeichert. Die Codes stehen neben der Spalte.
* **Datum**: Datumswerte werden in UTC gespeichert als `YYYY-MM-DD hh:mm:ss`. Suchen Sie mit dem Anfang eines Datums, zum Beispiel `created:2025` für das ganze Jahr oder `created:2025-03-14` für einen Tag. Vergleiche wie „vor“ oder „nach“ einem Datum werden nicht unterstützt.
* **ID**: eine Entra-Objekt-ID (GUID). Verwenden Sie `:` den Anfang der ID, oder fügen Sie eine vollständige ID allein (ohne Spaltennamen) ein, um dieses Objekt direkt zu finden. In der Tabelle Geräte wird eine eingefügte ID mit der Geräte-ID abgeglichen.
* **Mehrwertig**: die Spalte enthält mehrere durch Leerzeichen getrennte Werte. Siehe [Mehrwertige Spalten](#multi-value-columns).

Ein reiner Suchbegriff ohne Spaltennamen durchsucht nur einige der Textspalten. Sie sind unter jeder Tabelle aufgeführt.

### Benutzer

| Spalte              | Aliase                   | Typ     | Beschreibung                                                 |
| ------------------- | ------------------------ | ------- | ------------------------------------------------------------ |
| `id`                |                          | ID      | Entra-Objekt-ID                                              |
| `displayName`       | `Name`                   | Text    | Anzeigename                                                  |
| `userPrincipalName` | `upn`                    | Text    | Benutzerprinzipalname                                        |
| `mail`              |                          | Text    | Primäre E-Mail-Adresse                                       |
| `Vorname`           | `firstName`, `first`     | Text    | Vorname                                                      |
| `Nachname`          | `lastName`, `last`       | Text    | Nachname                                                     |
| `jobTitle`          | `job`, `title`           | Text    | Jobtitel                                                     |
| `Abteilung`         | `dept`                   | Text    | Department                                                   |
| `city`              |                          | Text    | City                                                         |
| `postalCode`        | `postcode`, `zip`, `plz` | Text    | Postleitzahl                                                 |
| `Land`              |                          | Text    | Land, wie in Entra eingegeben                                |
| `Nutzungsort`       | `location`               | Text    | Verwendungsort (zweistelliger Ländercode, zum Beispiel `DE`) |
| `preferredLanguage` | `language`, `lang`       | Text    | Bevorzugte Sprache, zum Beispiel `de-DE`                     |
| `accountEnabled`    | `aktiviert`              | Ja/Nein | Ob das Konto aktiviert ist                                   |
| `userType`          | `type`                   | Code    | `1` = Member, `2` = Guest, `0` = Unknown                     |
| `createdDateTime`   | `created`                | Datum   | Wann das Konto erstellt wurde                                |

Reine Suchbegriffe stimmen mit dem Anzeigenamen, der E-Mail, der UPN, dem Vornamen, dem Nachnamen, dem Jobtitel, der Abteilung, der Stadt, dem Land und dem Verwendungsort überein.

### Gruppen

| Spalte               | Aliase                 | Typ     | Beschreibung                                                                  |
| -------------------- | ---------------------- | ------- | ----------------------------------------------------------------------------- |
| `id`                 |                        | ID      | Entra-Objekt-ID                                                               |
| `displayName`        | `Name`                 | Text    | Gruppenname                                                                   |
| `Beschreibung`       | `desc`                 | Text    | Beschreibung                                                                  |
| `createdDateTime`    | `created`              | Datum   | Wann die Gruppe erstellt wurde                                                |
| `expirationDateTime` | `expiration`           | Datum   | Wann die Gruppe abläuft (Microsoft 365 groups mit einer Ablaufrichtlinie)     |
| `isTeamsEnabled`     | `teams`                | Ja/Nein | Ob die Gruppe ein Team ist                                                    |
| `isSecurity`         | `Sicherheit`           | Ja/Nein | Ob die Gruppe eine Security Group ist                                         |
| `isStatic`           | `statisch`             | Ja/Nein | `wahr` für zugewiesene Mitgliedschaft, `falsch` für dynamische Mitgliedschaft |
| `isRealmJoin`        | `realmJoin`, `rj`      | Ja/Nein | Ob die Gruppe eine RealmJoin-Gruppe ist                                       |
| `isOnPremises`       | `onPremises`, `onPrem` | Ja/Nein | Ob die Gruppe aus der lokalen Umgebung synchronisiert wird                    |

Reine Suchbegriffe stimmen mit dem Gruppennamen und der Beschreibung überein.

### Geräte

| Spalte                             | Aliase                                        | Typ        | Beschreibung                                                                                                               |
| ---------------------------------- | --------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                                               | ID         | Entra-Objekt-ID                                                                                                            |
| `deviceId`                         |                                               | ID         | Geräte-ID                                                                                                                  |
| `displayName`                      | `Name`                                        | Text       | Gerätename                                                                                                                 |
| `operatingSystem`                  | `os`                                          | Text       | Betriebssystem, wie es in der Tabelle angezeigt wird, zum Beispiel `Windows 11 (24H2)`                                     |
| `operatingSystemFamily`            | `osFamily`, `family`, `osFam`, `fam`          | Code       | `1` = Windows, `2` = macOS, `3` = Linux, `4` = Android, `5` = iOS, `6` = iPadOS, `7` = Printer, `8` = Other, `0` = Unknown |
| `operatingSystemVersion`           | `osVersion`, `osVer`                          | Text       | Betriebssystem-Versionsnummer                                                                                              |
| `Hersteller`                       | `manu`                                        | Text       | Hersteller                                                                                                                 |
| `model`                            |                                               | Text       | Modell                                                                                                                     |
| `Seriennummer`                     | `serial`, `sn`                                | Text       | Seriennummer                                                                                                               |
| `accountEnabled`                   | `aktiviert`                                   | Ja/Nein    | Ob das Gerät in Entra aktiviert ist                                                                                        |
| `isCompliant`                      | `konform`, `compliance`                       | Ja/Nein    | Ob das Gerät konform ist                                                                                                   |
| `createdDateTime`                  | `created`                                     | Datum      | Wann das Gerät registriert wurde                                                                                           |
| `lastSeen`                         | `last`                                        | Datum      | Letzte Aktivität: vom RealmJoin-Agenten gemeldet, falls installiert, andernfalls die ungefähre letzte Anmeldung von Entra  |
| `version`                          | `rjVersion`, `ver`, `rj`                      | Text       | Installierte Version des RealmJoin-Agenten (ohne den Agenten leer)                                                         |
| `intuneLastSyncDateTime`           | `intuneSync`, `intuneLastSync`, `lastSync`    | Datum      | Letzter Intune-Sync                                                                                                        |
| `registeredOwnerDisplayName`       | `ownerDisplayName`, `ownerName`, `Eigentümer` | Text       | Anzeigename des registrierten Besitzers                                                                                    |
| `registeredOwnerUserPrincipalName` | `ownerUserPrincipalName`                      | Text       | UPN des registrierten Besitzers                                                                                            |
| `registeredOwnerId`                | `ownerId`                                     | ID         | Objekt-ID des registrierten Besitzers                                                                                      |
| `ethernetMacAddress`               | `ethMac`, `ethernetMac`                       | Text       | Von Intune gemeldete Ethernet-MAC-Adresse                                                                                  |
| `wiFiMacAddress`                   | `wifiMac`, `wlanMac`                          | Text       | Von Intune gemeldete Wi-Fi-MAC-Adresse                                                                                     |
| `macAddresses`                     | `mac`, `macAddress`                           | Mehrwertig | Alle bekannten MAC-Adressen: Intune Ethernet und Wi-Fi sowie jeder vom RealmJoin-Agenten gemeldete Netzwerkadapter         |

Reine Suchbegriffe stimmen mit dem Gerätenamen, Betriebssystem, OS-Version, Hersteller, Modell, Seriennummer, Besitzernamen, Besitzer-UPN und MAC-Adressen überein.

Sie können MAC-Adressen mit oder ohne Trennzeichen eingeben (`:`, `-` oder `.`), zum Beispiel `mac:E8-62-BE` oder `mac:E862BE`.

### Pakete

| Spalte                             | Aliase         | Typ     | Beschreibung                                                                                                                                                                                                                           |
| ---------------------------------- | -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                | Text    | App- oder Paket-ID                                                                                                                                                                                                                     |
| `displayName`                      | `Name`         | Text    | App-Name                                                                                                                                                                                                                               |
| `packageId`                        | `Paket`, `pkg` | Text    | Paket-ID                                                                                                                                                                                                                               |
| `type`                             |                | Code    | `1` = RealmJoin (legacy), `2` = Intune (unmanaged), `3` = Intune (basic), `5` = Intune (managed), `6` = RealmJoin (basic), `7` = RealmJoin (managed)                                                                                   |
| `Untertyp`                         |                | Text    | App-Untertyp, wie in der Tabelle angezeigt                                                                                                                                                                                             |
| `version`                          |                | Text    | Version                                                                                                                                                                                                                                |
| `Vorschau`                         |                | Ja/Nein | Ob das Paket ein Vorabversionspaket ist (veraltet)                                                                                                                                                                                     |
| `statusLatestVersion`              |                | Text    | Neueste im App-Store verfügbare Version                                                                                                                                                                                                |
| `statusCurrentPreviewVersion`      |                | Text    | Derzeit in der Vorschau verfügbare Version                                                                                                                                                                                             |
| `statusUpgradeAction`              |                | Code    | Verfügbare Upgrade-Aktion: `0` = keine, `1` = Haupt-App aktualisieren, `2` = Vorschau-App aktualisieren, `4` = Vorschau-App erstellen, `8` = Vorschau auf Hauptversion anwenden. Kombinierte Aktionen addieren sich, zum Beispiel `3`. |
| `statusUpgradeActionPlanned`       |                | Code    | Geplante Upgrade-Aktion, dieselben Codes wie `statusUpgradeAction`                                                                                                                                                                     |
| `statusUpgradeActionSchedule`      |                | Datum   | Wann die geplante Upgrade-Aktion ausgeführt wird                                                                                                                                                                                       |
| `automationAutoDeployMain`         |                | Ja/Nein | Automatische Bereitstellung der Haupt-App                                                                                                                                                                                              |
| `automationAutoDeployPreview`      |                | Ja/Nein | Automatische Bereitstellung der Vorschau-App                                                                                                                                                                                           |
| `notifyTechnicalApplicationOwners` |                | Ja/Nein | Ob technische Anwendungsverantwortliche benachrichtigt werden                                                                                                                                                                          |
| `technicalApplicationOwners`       |                | Text    | Technische Anwendungsverantwortliche, getrennt durch `;`                                                                                                                                                                               |
| `installSource`                    |                | Text    | Quelle der Installationszahlen: `RealmJoin` oder `Intune`                                                                                                                                                                              |
| `installInstalledDeviceCount`      |                | Zahl    | Geräte mit installierter App                                                                                                                                                                                                           |
| `installFailedDeviceCount`         |                | Zahl    | Geräte mit fehlgeschlagener Installation                                                                                                                                                                                               |
| `installPendingDeviceCount`        |                | Zahl    | Geräte mit ausstehender Installation (nur Intune)                                                                                                                                                                                      |
| `installNotInstalledDeviceCount`   |                | Zahl    | Geräte ohne die App (nur Intune)                                                                                                                                                                                                       |
| `installFailureScore`              |                | Zahl    | Fehlerwert der App-Installationen                                                                                                                                                                                                      |
| `installSyncedAt`                  |                | Datum   | Wann die Installationszahlen zuletzt aktualisiert wurden                                                                                                                                                                               |

Reine Suchbegriffe stimmen mit dem App-Namen, Typ, Untertyp und der Paket-ID überein.

Die Spalten `versionParsed`, `statusLatestVersionParsed`, `statusCurrentPreviewVersionParsed`, `order` und `preReleasePartnerId` sind ebenfalls durchsuchbar, enthalten aber interne Werte. Verwenden Sie stattdessen die obigen Spalten.

### Mehrwertige Spalten

Eine mehrwertige Spalte enthält mehrere durch Leerzeichen getrennte Werte. Derzeit ist das `macAddresses` (`mac`) in der Tabelle Geräte.

In diesen Spalten prüfen die Operatoren `:`, `=`, `!:` und `!=` jeden Wert einzeln und nicht die Spalte als Ganzes:

* `mac:E862` findet Geräte, bei denen **irgendein** die MAC-Adresse mit `E862`.
* `mac=E862BE0A1B2C` findet Geräte, bei denen **irgendein** die MAC-Adresse genau `E862BE0A1B2C`.
* `mac!:E862` findet Geräte, bei denen **nein** die MAC-Adresse mit `E862`.
* `mac!=E862BE0A1B2C` findet Geräte, bei denen **nein** die MAC-Adresse genau `E862BE0A1B2C`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/de/analysieren-and-exportieren/advanced-search/advanced-search-syntax.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
