> 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/realmjoin-agent/installation.md).

# エージェントの展開

Package Store のすぐに使える intunewin パッケージを Intune 経由で使用して、RealmJoin Agent を Windows クライアントに展開します。

RealmJoin AgentはMicrosoft Intuneを使用してシームレスに展開できます。すぐに使えるパッケージがPackage Storeで利用可能で、セットアップ手順を簡素化します。\
このガイドでは、Intune経由でRealmJoin Agentをインストールするための推奨かつサポート対象の方法を説明します。

## 自動展開

### Microsoft Intune (intunewin)

{% hint style="success" %}
推奨
{% endhint %}

RealmJoinは、エージェントをintunewinパッケージとして追加および更新することで、お使いのMicrosoft Intune Tenantと直接統合します：

1. 当社の **Package Store**.
2. 「RealmJoin Agent」バナーを選択するか、この直接リンクを使用してください： [RealmJoin Agent (デバイス)](https://portal.realmjoin.com/packagestore/45935/overview)<br>

   <figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FfeIw2aeCYivyheibRk7N%2Fimage.png?alt=media&amp;token=8a94847c-a5e6-4ba6-80cf-9256506ae53d" alt=""><figcaption></figcaption></figure>
3. 「**Intune（管理対象）を使用**」を展開方法として使用し、「Continue」をクリックします。
4. このパッケージを「**Enrollment Status Page**」の下にある「必要なアプリがユーザー/デバイスに割り当てられている場合は、インストールされるまでデバイスの使用をブロックする」の設定に追加してください。これにより、Intune は登録中に RealmJoin Agent のインストールを待機します。
5. こちらも有効にしてください「**Automation Main channel**".

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FYo2RBeON8S2CiF5Eh7cq%2Fimage.png?alt=media&amp;token=05cd015a-384b-44a4-8ab8-132646de8598" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
RealmJoin agent will **新しいバージョンを確認し** ～中に **初回展開** と **必要に応じて更新します**。このプロセスを速めるため、引き続き「Automate Main channel」を推奨します。これにより、最新バージョンが最初からインストールされます。
{% endhint %}

{% hint style="warning" %}
お願いです **「Automate Preview channel」は使用しないでください** なぜなら **intunewin アプリケーション ID が変更される可能性があるため** その結果、パッケージは「Enrollment Status Page」の構成から削除されます。
{% endhint %}

6. **割り当てます** パッケージを **デバイス** (ユーザー オブジェクトに割り当てられている場合、展開中にエージェントが起動しない可能性があります)。例：
   1. 追加 **単一デバイスまたはデバイス グループ** 自動作成される管理対象アプリ グループへ
   2. 追加「**すべてのデバイス**」を **Intune による追加割り当てとして** (AVD やキオスクなどの特殊なデバイスを除外するためにフィルターが必要になる場合があります)

{% hint style="info" %}
当社のストアでは、ユーザー レベルで動作する「RealmJoin Agent (User)」パッケージも提供しています（これは以前の既定値でした）。 **安定性の理由から**、現在は **デバイス レベル版のみを推奨します**.
{% endhint %}

## Beta および Canary チャネル

{% hint style="info" %}
RealmJoin のリリース **チャネル** は **ユーザーおよびグループ設定で調整できます**: [RealmJoin リリース チャネルの構成](https://docs.realmjoin.com/ja/ugd-management/user-and-group-settings.md)。ただし **初回展開時のみ**、 **チャネルはインストーラーによって定義され固定されます** パッケージです。使用する場合は [自動展開](#automatic-deployment) 当社の Package Store を使用すると、展開では常にリリース チャネルが使用されます。
{% endhint %}

対象は **他のチャネルで初回展開をテストする場合**は、以下の intunewin パッケージのいずれかを手動でダウンロードしてアップロードできます：

* Beta チャネル（安定版に近く、長期テスト向け）：\
  [RealmJoin Beta バージョン](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)
* Canary チャネル（実験的、最初のテスト向け）：\
  [RealmJoin Canary バージョン](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

Intune にアップロードする際は、推奨設定を使用し、次の点に注意してください：

* プログラム：
  * デバイスの再起動動作： `戻りコードに基づいて動作を決定する`
* 検出ルール：
  * 検出ルールを手動で構成する
  * ファイル：
    * パス： `C:\Program Files\RealmJoin`
    * ファイルまたはフォルダー： `RealmJoin.exe`
    * 検出方法： `ファイルまたはフォルダーが存在する`
    * 64 ビット クライアント上の 32 ビット アプリに関連付けられている： `なし`

## Windows Defender の除外

RealmJoin は、マルウェア検出のホワイトリスト登録に関して Microsoft Defender チームと連携してきました。Defender は潜在的な脅威を識別するために機械学習の仕組みをますます多く使用しており、また RealmJoin にはクラウドからダウンロードされたアプリケーションのインストールなどの機能が複数あるため、RealmJoin は **Windows Defender** 潜在的な脅威として認識される可能性があります。

この挙動が必ず発生するわけではありませんが、追加の **Windows Defender Antivirus の除外項目**:

| Defender の除外項目                                  |
| ----------------------------------------------- |
| **ファイルとフォルダー**                                  |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |
| **プロセス**                                        |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |

{% hint style="info" %}
同じパスを構成することが重要です **ファイルとフォルダー** と **プロセス**。場合によっては、Microsoft はこれらの Defender の除外項目のうち 1 つしか確認しません。
{% endhint %}

## 追加情報

### 自動展開

#### レガシー: Microsoft Intune (MSI)

{% hint style="warning" %}
この **旧式の展開方法** は参考用としてのみ提供されており、 **現在はサポートされていません**.

また、 [Microsoft は MSI と intunewin の展開を混在させることを推奨していません](https://learn.microsoft.com/en-us/intune/intune-service/apps/lob-apps-windows)：「Windows Autopilot の登録中に Win32 アプリと業務アプリのインストールを混在させると、両方が同時に Trusted Installer サービスを使用するため、アプリのインストールが失敗する可能性があります。」
{% endhint %}

RealmJoin は次の方法で展開できます： [MSI インストーラー](#msi-installer) 業務アプリとして。Intune にアップロードする際は、「Ignore app version」が「Yes」に設定されていることを確認してください。

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FrShHt2tT5AvEUqx4gikB%2Fimage.png?alt=media&amp;token=ed311281-dd1b-4d42-bb9f-5cb13edee9e5" alt="" width="364"><figcaption></figcaption></figure>

### コマンドラインによる対話型インストール

管理者が RealmJoin Agent を一括展開や Microsoft Intune インフラストラクチャなしでデバイスにインストールしたい場合、MSI をダウンロードして対話型インストールを実行できます。代替として、以下のコマンドラインのいずれかをコピーして、エージェントを 1 ステップでダウンロードおよび実行することもできます。

#### MSI インストーラーと EXE

* 安定版リリース：\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.msi) または [EXE](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe)
* Beta チャネル（安定版に近く、長期テスト向け）：\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.msi) または [EXE](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe)
* Canary チャネル（実験的、最初のテスト向け）：\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.msi) または [EXE](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe)

#### リリース チャネル

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

#### Beta チャネル

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

#### Canary チャネル

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

### サイレント インストール

無人の OS インストール中、またはその他の非対話型展開方法で RealmJoin をインストールする場合、インストール中に UI 操作を行わないようにすることがあります。そのようなシナリオで RealmJoin をインストールするには、サイレント インストール オプションを使用してください：

```
reamjoin.exe -install
```

### 署名済み MSI

RealmJoin.MSI は RealmJoin によって SHA2（256 ビット）署名されているため、Windows では安全にインストールできるものとして認識されます。

![](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FLgoUYkRJF8acq3qRvNfj%2Frealmjoin.msi.signature.png?alt=media\&token=b33acfc4-8f6f-4813-adeb-ac6c5c2e59cc)


---

# 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/realmjoin-agent/installation.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.
