> 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/ja/toekusupto/advanced-search/advanced-search-syntax.md).

# 詳細検索の例

Users、Groups、Devices、Packages テーブルの詳細検索で、クエリルール、演算子、および検索可能なすべての列とそのエイリアスを確認できます。

## クエリ ルール

クエリは、空白で区切られた通常の検索語と列フィルターで構成されます。ルールは次のとおりです:

* **トークン化検索**:\
  検索語は一致精度を高めるために自動的にトークン化されます。たとえば、次のように入力すると `lu sk` は次のような名前に一致します **Luke Skywalker**。検索では常に **starts-with** 方式が使われ、全文検索や「contains」検索ではありません。つまり、 `walk` なら **は** 返します **Skywalker**.
* **論理 AND**:\
  すべてのフィルターは論理 **AND**で結合されます。すべての条件を満たす必要があります。\
  例: `Luke Skywalker country:france` Luke Skywalker を、次の条件で検索します **国** 「france」で始まります。
* **列指定検索**:\
  &#x20;`column:` を使うと、特定の列内を検索できます。\
  例: `country:france` は、次の条件に一致するエントリを検索します: **国** 「france」で始まります。
* **演算子**:
  * `:` → **startsWith** 検索\
    例: `name:jo` 「John」「Joanna」などに一致します。
  * `=` → **等しい** 検索\
    例: `city=Stuttgart` 「Stuttgart」と完全一致します
  * `!=` または `!:` → **否定**\
    例: `city!=Stuttgart` 「Stuttgart」を完全に除外し、 `city!:Stutt` 「Stutt」で始まるすべての都市を除外します。どちらも、列が空のエントリも除外します。
* **特殊な動作**:
  * **ウムラウトの置換**:\
    通常の検索語ではウムラウトが正規化されます（例: **Björn** は、次を検索すると見つけられます **Bjorn**）。列指定検索ではウムラウトは正規化されないため、次を使用してください `city:München` ではなく `city:Munchen`.
  * **Unicode サポート**:\
    検索語では Unicode 文字がサポートされます。
  * **かっこ () は無視されます** startsWith 検索では。
  * **空値検索**:
    * `zip:""` 空の値を検索します
    * `zip:` 任意の値を検索します
* **サポートされる列**:\
  参照 [サポートされる列](#supported-columns) 検索可能なすべての列とエイリアスを確認してください。

## サポートされる列

以下の各テーブルには、列指定検索で使用できる列が一覧表示されています（`column:value`）。列名またはそのエイリアスのどちらでも使用でき、大文字小文字は区別されないため、 `upn:`, `UPN:` と `userPrincipalName:` はいずれも同じ列を検索します。

{% hint style="warning" %}
RealmJoin が列名を認識しない場合、そのクエリ部分は無視され、残りのフィルターはそのまま適用されます。結果がフィルターされていないように見える場合は、列名のスペルミスを確認してください。
{% endhint %}

次の **型** 列は、その列が受け付ける値を示します:

* **テキスト**: `:` 入力の先頭と一致する値にマッチします。 `=` 値全体と一致します。大文字小文字は区別されません。
* **はい/いいえ**：使用します `true` または `false`、たとえば `enabled:false`. `:` と `=` ここでは同様に動作します。
* **数値**：使用します `=` 正確な値の場合、たとえば `installFailedDeviceCount=0`。これを使うと `:`、数値は同じ数字で始まるすべての値に一致するため、 `installFailedDeviceCount:1` 10 や 12 にも一致します。
* **コード**：値は数値として保存されます。コードは列の横に一覧表示されています。
* **日付**：日付は UTC で次の形式で保存されます `YYYY-MM-DD hh:mm:ss`。たとえば、日付の先頭で検索します `created:2025` で年全体を検索したり、 `created:2025-03-14` で 1 日分を検索したりできます。日付の「前」や「後」といった比較はサポートされていません。
* **ID**：Entra オブジェクト ID（GUID）です。次を使用します `:` ID の先頭で検索するか、完全な ID を単独で（列名なしで）貼り付けると、そのオブジェクトを直接見つけられます。Devices テーブルでは、貼り付けた ID はデバイス ID と照合されます。
* **複数値**：列には空白で区切られた複数の値が入ります。See [複数値列](#multi-value-columns).

列名のない通常の検索語は、一部のテキスト列のみを検索します。これらは各テーブルの下に一覧表示されています。

### ユーザー

| 列                   | エイリアス                    | 型      | 説明                              |
| ------------------- | ------------------------ | ------ | ------------------------------- |
| `id`                |                          | ID     | Entra オブジェクト ID                 |
| `displayName`       | `名前`                     | テキスト   | 表示名                             |
| `userPrincipalName` | `upn`                    | テキスト   | ユーザー プリンシパル名                    |
| `mail`              |                          | テキスト   | プライマリ メール アドレス                  |
| `givenName`         | `firstName`, `first`     | テキスト   | 名                               |
| `surname`           | `lastName`, `last`       | テキスト   | 姓                               |
| `jobTitle`          | `job`, `title`           | テキスト   | 役職                              |
| `部署`                | `dept`                   | テキスト   | 部署                              |
| `city`              |                          | テキスト   | City                            |
| `postalCode`        | `postcode`, `zip`, `plz` | テキスト   | 郵便番号                            |
| `国`                 |                          | テキスト   | Entra に入力された国                   |
| `usageLocation`     | `location`               | テキスト   | 使用場所（2 文字の国コード。たとえば `DE`)       |
| `preferredLanguage` | `language`, `lang`       | テキスト   | 優先言語。たとえば `de-DE`               |
| `accountEnabled`    | `場合`                     | はい/いいえ | アカウントが有効かどうか                    |
| `userType`          | `type`                   | コード    | `1` = メンバー、 `2` = ゲスト、 `0` = 不明 |
| `createdDateTime`   | `created`                | 日付     | アカウントが作成された日時                   |

通常の検索語は、表示名、メール、UPN、名、姓、職名、部署、都市、国、および使用場所に一致します。

### グループ

| 列                    | エイリアス                  | 型      | 説明                                              |
| -------------------- | ---------------------- | ------ | ----------------------------------------------- |
| `id`                 |                        | ID     | Entra オブジェクト ID                                 |
| `displayName`        | `名前`                   | テキスト   | グループ名です                                         |
| `説明`                 | `desc`                 | テキスト   | 説明                                              |
| `createdDateTime`    | `created`              | 日付     | グループが作成された日時                                    |
| `expirationDateTime` | `expiration`           | 日付     | グループの有効期限が切れる日時（有効期限ポリシーのある Microsoft 365 グループ） |
| `isTeamsEnabled`     | `teams`                | はい/いいえ | グループがチームかどうか                                    |
| `isSecurity`         | `セキュリティ`               | はい/いいえ | グループがセキュリティ グループかどうか                            |
| `isStatic`           | `static`               | はい/いいえ | `true` 割り当てられたメンバーシップの場合、 `false` 動的メンバーシップの場合  |
| `isRealmJoin`        | `realmJoin`, `rj`      | はい/いいえ | グループが RealmJoin グループかどうか                        |
| `isOnPremises`       | `onPremises`, `onPrem` | はい/いいえ | グループがオンプレミスから同期されているかどうか                        |

通常の検索語は、グループ名と説明に一致します。

### デバイス

| 列                                  | エイリアス                                      | 型      | 説明                                                                                                                |
| ---------------------------------- | ------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------- |
| `id`                               |                                            | ID     | Entra オブジェクト ID                                                                                                   |
| `deviceId`                         |                                            | ID     | デバイス ID                                                                                                           |
| `displayName`                      | `名前`                                       | テキスト   | デバイス名                                                                                                             |
| `operatingSystem`                  | `os`                                       | テキスト   | テーブルに表示されるオペレーティング システム。たとえば `Windows 11 (24H2)`                                                                  |
| `operatingSystemFamily`            | `osFamily`, `family`, `osFam`, `fam`       | コード    | `1` = Windows, `2` = macOS, `3` = Linux, `4` = Android, `5` = iOS, `6` = iPadOS, `7` = プリンター, `8` = その他, `0` = 不明 |
| `operatingSystemVersion`           | `osVersion`, `osVer`                       | テキスト   | オペレーティング システムのバージョン番号                                                                                             |
| `製造元`                              | `manu`                                     | テキスト   | メーカー                                                                                                              |
| `model`                            |                                            | テキスト   | モデル                                                                                                               |
| `serialNumber`                     | `serial`, `sn`                             | テキスト   | シリアル番号                                                                                                            |
| `accountEnabled`                   | `場合`                                       | はい/いいえ | デバイスが Entra で有効かどうか                                                                                               |
| `isCompliant`                      | `準拠していることを`, `compliance`                  | はい/いいえ | デバイスが準拠しているかどうか                                                                                                   |
| `createdDateTime`                  | `created`                                  | 日付     | デバイスが登録された日時                                                                                                      |
| `lastSeen`                         | `last`                                     | 日付     | 最終アクティビティ: RealmJoin エージェントがインストールされている場合はその報告、そうでない場合は Entra からの概算の最終サインイン                                       |
| `version`                          | `rjVersion`, `ver`, `rj`                   | テキスト   | インストール済みの RealmJoin エージェントのバージョン（エージェントがない場合は空）                                                                   |
| `intuneLastSyncDateTime`           | `intuneSync`, `intuneLastSync`, `lastSync` | 日付     | 最終 Intune 同期                                                                                                      |
| `registeredOwnerDisplayName`       | `ownerDisplayName`, `ownerName`, `所有者`     | テキスト   | 登録済み所有者の表示名                                                                                                       |
| `registeredOwnerUserPrincipalName` | `ownerUserPrincipalName`                   | テキスト   | 登録済み所有者の UPN                                                                                                      |
| `registeredOwnerId`                | `ownerId`                                  | ID     | 登録済み所有者のオブジェクト ID                                                                                                 |
| `ethernetMacAddress`               | `ethMac`, `ethernetMac`                    | テキスト   | Intune によって報告された Ethernet MAC アドレス                                                                                |
| `wiFiMacAddress`                   | `wifiMac`, `wlanMac`                       | テキスト   | Intune によって報告された Wi-Fi MAC アドレス                                                                                   |
| `macAddresses`                     | `mac`, `macAddress`                        | 複数値    | 判明しているすべての MAC アドレス: Intune の Ethernet と Wi‑Fi に加え、RealmJoin エージェントが報告したすべてのネットワーク アダプター                          |

通常の検索語は、デバイス名、オペレーティング システム、OS バージョン、製造元、モデル、シリアル番号、所有者名、所有者 UPN、および MAC アドレスに一致します。

区切り記号の有無にかかわらず MAC アドレスを入力できます（`:`, `-` または `.`）たとえば `mac:E8-62-BE` または `mac:E862BE`.

### パッケージ

| 列                                  | エイリアス            | 型      | 説明                                                                                                                                                   |
| ---------------------------------- | ---------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                  | テキスト   | アプリまたはパッケージ ID                                                                                                                                       |
| `displayName`                      | `名前`             | テキスト   | アプリ名                                                                                                                                                 |
| `packageId`                        | `package`, `pkg` | テキスト   | パッケージ ID                                                                                                                                             |
| `type`                             |                  | コード    | `1` = RealmJoin (legacy), `2` = Intune (unmanaged), `3` = Intune (basic), `5` = Intune (managed), `6` = RealmJoin (basic), `7` = RealmJoin (managed) |
| `subtype`                          |                  | テキスト   | テーブルに表示されるアプリのサブタイプ                                                                                                                                  |
| `version`                          |                  | テキスト   | バージョン                                                                                                                                                |
| `プレビュー`                            |                  | はい/いいえ | パッケージがプレリリース パッケージかどうか（非推奨）                                                                                                                          |
| `statusLatestVersion`              |                  | テキスト   | アプリ ストアで利用可能な最新バージョン                                                                                                                                 |
| `statusCurrentPreviewVersion`      |                  | テキスト   | 現在プレビュー中のバージョン                                                                                                                                       |
| `statusUpgradeAction`              |                  | コード    | 実行可能なアップグレード アクション: `0` = なし, `1` = メイン アプリをアップグレード, `2` = プレビュー アプリをアップグレード, `4` = プレビュー アプリを作成, `8` = プレビューをメインに適用。組み合わせたアクションは加算されます。たとえば `3`.    |
| `statusUpgradeActionPlanned`       |                  | コード    | 計画済みのアップグレード アクション。コードは次と同じです `statusUpgradeAction`                                                                                                  |
| `statusUpgradeActionSchedule`      |                  | 日付     | 計画済みのアップグレード アクションが実行される日時                                                                                                                           |
| `automationAutoDeployMain`         |                  | はい/いいえ | メイン アプリの自動展開                                                                                                                                         |
| `automationAutoDeployPreview`      |                  | はい/いいえ | プレビュー アプリの自動展開                                                                                                                                       |
| `notifyTechnicalApplicationOwners` |                  | はい/いいえ | 技術アプリケーション所有者に通知するかどうか                                                                                                                               |
| `technicalApplicationOwners`       |                  | テキスト   | 技術アプリケーション所有者。区切り文字は `;`                                                                                                                             |
| `installSource`                    |                  | テキスト   | インストール数のソース: `RealmJoin` または `Intune`                                                                                                                |
| `installInstalledDeviceCount`      |                  | 数値     | アプリがインストールされているデバイス                                                                                                                                  |
| `installFailedDeviceCount`         |                  | 数値     | インストールに失敗したデバイス                                                                                                                                      |
| `installPendingDeviceCount`        |                  | 数値     | 保留中のインストールがあるデバイス（Intune のみ）                                                                                                                         |
| `installNotInstalledDeviceCount`   |                  | 数値     | アプリがないデバイス（Intune のみ）                                                                                                                                |
| `installFailureScore`              |                  | 数値     | アプリのインストールの失敗スコア                                                                                                                                     |
| `installSyncedAt`                  |                  | 日付     | インストール数が最後に更新された日時                                                                                                                                   |

通常の検索語は、アプリ名、種類、サブタイプ、およびパッケージ ID に一致します。

列 `versionParsed`, `statusLatestVersionParsed`, `statusCurrentPreviewVersionParsed`, `order` と `preReleasePartnerId` も検索可能ですが、内部値を保持しています。代わりに上記の列を使用してください。

### 複数値列

複数値列には、空白で区切られた複数の値が入ります。現在これに当たるのは `macAddresses` (`mac`）です。Devices テーブルにあります。

これらの列では、演算子 `:`, `=`, `!:` と `!=` は列全体ではなく、各値を個別に確認します:

* `mac:E862` 次のようなデバイスを見つけます:  **いずれかの** MAC アドレスが次で始まる `E862`.
* `mac=E862BE0A1B2C` 次のようなデバイスを見つけます:  **いずれかの** MAC アドレスが正確に `E862BE0A1B2C`.
* `mac!:E862` 次のようなデバイスを見つけます:  **いいえ** MAC アドレスが次で始まる `E862`.
* `mac!=E862BE0A1B2C` 次のようなデバイスを見つけます:  **いいえ** MAC アドレスが正確に `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/ja/toekusupto/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.
