> 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/fr/analyser-et-exporter/advanced-search/advanced-search-syntax.md).

# Exemples de recherche avancée

Consultez les règles de requête, les opérateurs et toutes les colonnes recherchables avec leurs alias pour la recherche avancée dans les tableaux Utilisateurs, Groupes, Appareils et Paquets.

## Règles de requête

Une requête se compose de termes de recherche simples et de filtres de colonne, séparés par des espaces. Les règles :

* **Recherche tokenisée**:\
  Les termes de recherche sont automatiquement tokenisés pour améliorer la précision de la correspondance. Par exemple, en saisissant `lu sk` correspondra à des noms comme **Luke Skywalker**. La recherche utilise toujours une **starts-with** approche plutôt qu'une recherche en texte intégral ou « contains ». Cela signifie qu'une recherche pour `walk` serait **ne** renvoyer **Skywalker**.
* **ET logique**:\
  Tous les filtres sont combinés à l'aide de l'opérateur logique **AND**. Chaque condition doit être satisfaite.\
  Exemple : `Luke Skywalker country:france` recherche Luke Skywalker lorsque le **pays** commence par « france ».
* **Recherche spécifique à une colonne**:\
  Utilisez `column:` pour rechercher dans une colonne spécifique.\
  Exemple : `country:france` recherche des entrées où le **pays** commence par « france ».
* **Opérateurs**:
  * `:` → **startsWith** recherche\
    Exemple : `name:jo` correspond à « John », « Joanna », etc.
  * `=` → **égal à** recherche\
    Exemple : `city=Stuttgart` correspond exactement à « Stuttgart »
  * `!=` ou `!:` → **négation**\
    Exemple : `city!=Stuttgart` exclut exactement « Stuttgart », `city!:Stutt` exclut toutes les villes commençant par « Stutt ». Les deux excluent aussi les entrées où la colonne est vide.
* **Comportement spécial**:
  * **Substitution des trémas**:\
    Les trémas sont normalisés dans les termes de recherche simples (par ex., **Björn** peut être trouvé en recherchant **Bjorn**). Les recherches spécifiques à une colonne ne normalisent pas les trémas, donc utilisez `city:München` plutôt que `city:Munchen`.
  * **Prise en charge d'Unicode**:\
    Les caractères Unicode sont pris en charge dans les termes de recherche.
  * **Les parenthèses () sont ignorées** dans les recherches startsWith.
  * **Recherche de valeur vide**:
    * `zip:""` recherche des valeurs vides
    * `zip:` recherche n'importe quelle valeur
* **Colonnes prises en charge**:\
  Voir [Colonnes prises en charge](#supported-columns) pour chaque colonne et alias que vous pouvez rechercher.

## Colonnes prises en charge

Chaque tableau ci-dessous répertorie les colonnes que vous pouvez utiliser dans une recherche spécifique à une colonne (`column:value`). Vous pouvez utiliser soit le nom de la colonne, soit l'un de ses alias, et la casse n'a pas d'importance, donc `upn:`, `UPN:` et `userPrincipalName:` recherchent tous la même colonne.

{% hint style="warning" %}
Si RealmJoin ne reconnaît pas un nom de colonne, cette partie de la requête est ignorée et les filtres restants s'appliquent quand même. Si vos résultats semblent non filtrés, vérifiez l'orthographe du nom de colonne.
{% endhint %}

Le **Type** La colonne vous indique quelles valeurs une colonne accepte :

* **Texte**: `:` correspond aux valeurs qui commencent par votre saisie, `=` correspond à la valeur entière. La casse n'a pas d'importance.
* **Oui/Non** : utilisez `vrai` ou `false`, par exemple `enabled:false`. `:` et `=` se comportent de la même manière ici.
* **Nombre** : utilisez `=` pour une valeur exacte, par exemple `installFailedDeviceCount=0`. Avec `:`, un nombre correspond à toute valeur qui commence par les mêmes chiffres, donc `installFailedDeviceCount:1` correspond aussi à 10 ou 12.
* **Code** : la valeur est stockée comme un nombre. Les codes sont listés à côté de la colonne.
* **Date** : les dates sont stockées en UTC sous la forme `YYYY-MM-DD hh:mm:ss`. Recherchez avec le début d'une date, par exemple `created:2025` pour toute l'année ou `created:2025-03-14` pour un jour. Les comparaisons telles que « avant » ou « après » une date ne sont pas prises en charge.
* **ID** : un ID d'objet Entra (GUID). Utilisez `:` avec le début de l'ID, ou collez un ID complet seul (sans nom de colonne) pour trouver cet objet directement. Dans la table des appareils, un ID collé est comparé à l'ID de l'appareil.
* **Multi-valeur** : la colonne contient plusieurs valeurs séparées par des espaces. Voir [Colonnes multi-valeurs](#multi-value-columns).

Un terme de recherche simple sans nom de colonne ne recherche que certaines colonnes de texte. Elles sont répertoriées sous chaque tableau.

### Utilisateurs

| Colonne             | Alias                    | Type    | Description                                                            |
| ------------------- | ------------------------ | ------- | ---------------------------------------------------------------------- |
| `id`                |                          | ID      | ID d'objet Entra                                                       |
| `displayName`       | `nom`                    | Texte   | Nom affiché                                                            |
| `userPrincipalName` | `upn`                    | Texte   | Nom principal de l'utilisateur                                         |
| `mail`              |                          | Texte   | Adresse e-mail principale                                              |
| `givenName`         | `firstName`, `first`     | Texte   | Prénom                                                                 |
| `surname`           | `lastName`, `last`       | Texte   | Nom de famille                                                         |
| `jobTitle`          | `job`, `title`           | Texte   | Intitulé du poste                                                      |
| `service`           | `dept`                   | Texte   | Département                                                            |
| `city`              |                          | Texte   | Ville                                                                  |
| `postalCode`        | `postcode`, `zip`, `plz` | Texte   | Code postal                                                            |
| `pays`              |                          | Texte   | Pays, tel qu'entré dans Entra                                          |
| `usageLocation`     | `location`               | Texte   | Emplacement d'utilisation (code pays à deux lettres, par exemple `DE`) |
| `preferredLanguage` | `language`, `lang`       | Texte   | Langue préférée, par exemple `de-DE`                                   |
| `accountEnabled`    | `activé`                 | Oui/Non | Indique si le compte est activé                                        |
| `userType`          | `type`                   | Code    | `1` = Member, `2` = Guest, `0` = Unknown                               |
| `createdDateTime`   | `created`                | Date    | Quand le compte a été créé                                             |

Les termes de recherche simples correspondent au nom d'affichage, au courrier, à l'UPN, au prénom, au nom, au titre du poste, au département, à la ville, au pays et à l'emplacement d'utilisation.

### Groupes

| Colonne              | Alias                  | Type    | Description                                                                     |
| -------------------- | ---------------------- | ------- | ------------------------------------------------------------------------------- |
| `id`                 |                        | ID      | ID d'objet Entra                                                                |
| `displayName`        | `nom`                  | Texte   | Nom du groupe                                                                   |
| `description`        | `desc`                 | Texte   | Description                                                                     |
| `createdDateTime`    | `created`              | Date    | Quand le groupe a été créé                                                      |
| `expirationDateTime` | `expiration`           | Date    | Quand le groupe expire (groupes Microsoft 365  avec une stratégie d'expiration) |
| `isTeamsEnabled`     | `teams`                | Oui/Non | Indique si le groupe est une équipe                                             |
| `isSecurity`         | `sécurité`             | Oui/Non | Indique si le groupe est un Security Group                                      |
| `isStatic`           | `static`               | Oui/Non | `vrai` pour une appartenance attribuée, `false` pour une appartenance dynamique |
| `isRealmJoin`        | `realmJoin`, `rj`      | Oui/Non | Indique si le groupe est un groupe RealmJoin                                    |
| `isOnPremises`       | `onPremises`, `onPrem` | Oui/Non | Indique si le groupe est synchronisé depuis les environnements sur site         |

Les termes de recherche simples correspondent au nom et à la description du groupe.

### Appareils

| Colonne                            | Alias                                      | Type         | Description                                                                                                                  |
| ---------------------------------- | ------------------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                                            | ID           | ID d'objet Entra                                                                                                             |
| `deviceId`                         |                                            | ID           | ID de l’appareil                                                                                                             |
| `displayName`                      | `nom`                                      | Texte        | Nom de l'appareil                                                                                                            |
| `operatingSystem`                  | `os`                                       | Texte        | Système d'exploitation tel qu'affiché dans le tableau, par exemple `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`                       | Texte        | Numéro de version du système d'exploitation                                                                                  |
| `fabricant`                        | `manu`                                     | Texte        | Fabricant                                                                                                                    |
| `model`                            |                                            | Texte        | Modèle                                                                                                                       |
| `serialNumber`                     | `serial`, `sn`                             | Texte        | Numéro de série                                                                                                              |
| `accountEnabled`                   | `activé`                                   | Oui/Non      | Indique si l'appareil est activé dans Entra                                                                                  |
| `isCompliant`                      | `conforme`, `compliance`                   | Oui/Non      | Indique si l'appareil est conforme                                                                                           |
| `createdDateTime`                  | `created`                                  | Date         | Quand l'appareil a été enregistré                                                                                            |
| `lastSeen`                         | `last`                                     | Date         | Dernière activité : signalée par l'agent RealmJoin s'il est installé, sinon la dernière connexion approximative depuis Entra |
| `version`                          | `rjVersion`, `ver`, `rj`                   | Texte        | Version installée de l'agent RealmJoin (vide sans l'agent)                                                                   |
| `intuneLastSyncDateTime`           | `intuneSync`, `intuneLastSync`, `lastSync` | Date         | Dernière synchronisation Intune                                                                                              |
| `registeredOwnerDisplayName`       | `ownerDisplayName`, `ownerName`, `canal`   | Texte        | Nom d'affichage du propriétaire enregistré                                                                                   |
| `registeredOwnerUserPrincipalName` | `ownerUserPrincipalName`                   | Texte        | UPN du propriétaire enregistré                                                                                               |
| `registeredOwnerId`                | `ownerId`                                  | ID           | ID d'objet du propriétaire enregistré                                                                                        |
| `ethernetMacAddress`               | `ethMac`, `ethernetMac`                    | Texte        | Adresse MAC Ethernet signalée par Intune                                                                                     |
| `wiFiMacAddress`                   | `wifiMac`, `wlanMac`                       | Texte        | Adresse MAC Wi-Fi signalée par Intune                                                                                        |
| `macAddresses`                     | `mac`, `macAddress`                        | Multi-valeur | Toutes les adresses MAC connues : Ethernet et Wi-Fi Intune plus chaque adaptateur réseau signalé par l'agent RealmJoin       |

Les termes de recherche simples correspondent au nom de l'appareil, au système d'exploitation, à la version du système d'exploitation, au fabricant, au modèle, au numéro de série, au nom du propriétaire, à l'UPN du propriétaire et aux adresses MAC.

Vous pouvez saisir des adresses MAC avec ou sans séparateurs (`:`, `-` ou `.`), par exemple `mac:E8-62-BE` ou `mac:E862BE`.

### Paquets

| Colonne                            | Alias            | Type    | Description                                                                                                                                                                                                                                                                                          |
| ---------------------------------- | ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                  | Texte   | ID de l'application ou du package                                                                                                                                                                                                                                                                    |
| `displayName`                      | `nom`            | Texte   | Nom de l'application                                                                                                                                                                                                                                                                                 |
| `packageId`                        | `package`, `pkg` | Texte   | ID du package                                                                                                                                                                                                                                                                                        |
| `type`                             |                  | Code    | `1` = RealmJoin (legacy), `2` = Intune (unmanaged), `3` = Intune (basic), `5` = Intune (managed), `6` = RealmJoin (basic), `7` = RealmJoin (managed)                                                                                                                                                 |
| `sous-type`                        |                  | Texte   | Sous-type d'application tel qu'affiché dans le tableau                                                                                                                                                                                                                                               |
| `version`                          |                  | Texte   | Version                                                                                                                                                                                                                                                                                              |
| `aperçu`                           |                  | Oui/Non | Indique si le package est un package de préversion (obsolète)                                                                                                                                                                                                                                        |
| `statusLatestVersion`              |                  | Texte   | Dernière version disponible dans la boutique d'applications                                                                                                                                                                                                                                          |
| `statusCurrentPreviewVersion`      |                  | Texte   | Version actuellement en préversion                                                                                                                                                                                                                                                                   |
| `statusUpgradeAction`              |                  | Code    | Action de mise à niveau disponible : `0` = aucune, `1` = mettre à niveau l'application principale, `2` = mettre à niveau l'application de préversion, `4` = créer l'application de préversion, `8` = appliquer la préversion à la principale. Les actions combinées s'additionnent, par exemple `3`. |
| `statusUpgradeActionPlanned`       |                  | Code    | Action de mise à niveau planifiée, mêmes codes que `statusUpgradeAction`                                                                                                                                                                                                                             |
| `statusUpgradeActionSchedule`      |                  | Date    | Quand l'action de mise à niveau planifiée s'exécute                                                                                                                                                                                                                                                  |
| `automationAutoDeployMain`         |                  | Oui/Non | Déploiement automatique de l'application principale                                                                                                                                                                                                                                                  |
| `automationAutoDeployPreview`      |                  | Oui/Non | Déploiement automatique de l'application de préversion                                                                                                                                                                                                                                               |
| `notifyTechnicalApplicationOwners` |                  | Oui/Non | Indique si les propriétaires techniques de l'application sont notifiés                                                                                                                                                                                                                               |
| `technicalApplicationOwners`       |                  | Texte   | Propriétaires techniques de l'application, séparés par `;`                                                                                                                                                                                                                                           |
| `installSource`                    |                  | Texte   | Source des chiffres d'installation : `RealmJoin` ou `Intune`                                                                                                                                                                                                                                         |
| `installInstalledDeviceCount`      |                  | Nombre  | Appareils avec l'application installée                                                                                                                                                                                                                                                               |
| `installFailedDeviceCount`         |                  | Nombre  | Appareils avec une installation échouée                                                                                                                                                                                                                                                              |
| `installPendingDeviceCount`        |                  | Nombre  | Appareils avec une installation en attente (Intune uniquement)                                                                                                                                                                                                                                       |
| `installNotInstalledDeviceCount`   |                  | Nombre  | Appareils sans l'application (Intune uniquement)                                                                                                                                                                                                                                                     |
| `installFailureScore`              |                  | Nombre  | Score d'échec des installations de l'application                                                                                                                                                                                                                                                     |
| `installSyncedAt`                  |                  | Date    | Quand les chiffres d'installation ont été mis à jour pour la dernière fois                                                                                                                                                                                                                           |

Les termes de recherche simples correspondent au nom de l'application, au type, au sous-type et à l'ID du package.

Les colonnes `versionParsed`, `statusLatestVersionParsed`, `statusCurrentPreviewVersionParsed`, `order` et `preReleasePartnerId` sont également recherchables mais contiennent des valeurs internes. Utilisez plutôt les colonnes ci-dessus.

### Colonnes multi-valeurs

Une colonne multi-valeur contient plusieurs valeurs séparées par des espaces. Actuellement, il s'agit de `macAddresses` (`mac`) dans la table des appareils.

Dans ces colonnes, les opérateurs `:`, `=`, `!:` et `!=` vérifient chaque valeur individuellement, et non la colonne dans son ensemble :

* `mac:E862` trouve des appareils où **n’importe quel** l'adresse MAC commence par `E862`.
* `mac=E862BE0A1B2C` trouve des appareils où **n’importe quel** l'adresse MAC est exactement `E862BE0A1B2C`.
* `mac!:E862` trouve des appareils où **non** l'adresse MAC commence par `E862`.
* `mac!=E862BE0A1B2C` trouve des appareils où **non** l'adresse MAC est exactement `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/fr/analyser-et-exporter/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.
