> 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).

# エージェントの展開

RealmJoin Agent は、Microsoft Intune を使用してシームレスに展開できます。すぐに使えるパッケージが Package Store に用意されており、セットアップ प्रक्रियाを簡素化します。\
このガイドでは、Intune 経由で RealmJoin Agent をインストールするための推奨かつサポートされている方法を説明します。

## 自動展開

### Microsoft Intune (intunewin)

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

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

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

   <figure><img src="/files/678c321a24029f00da8d9f0559578570da51b87c" alt=""><figcaption></figcaption></figure>
3. 「**Intune を使用する（管理対象）**」を展開方法として選択し、「Continue」をクリックします。
4. このパッケージを「**Enrollment Status Page**」の「ユーザー/デバイスに割り当てられている必須アプリがインストールされるまでデバイスの使用をブロックする」の下に追加してください。これにより、Intune は登録中に RealmJoin Agent のインストールを待機します。
5. また、「**Automation Main channel**".

<figure><img src="/files/44f872fd2ba1c9bd1f465abd82cf1cb74b5abafa" alt="" width="563"><figcaption></figcaption></figure>

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

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

6. **割り当て** パッケージを **デバイスに** （ユーザー オブジェクトに割り当てた場合、展開中にエージェントが開始しない可能性があります）。例:
   1. 追加 **単一デバイスまたはデバイス グループ** 自動的に作成された managed app groups に
   2. 「**All devices**」を **Intune による追加の割り当てとして** （AVD や Kiosk のような特殊デバイスを除外するためにフィルターが必要になる場合があります）

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

## Beta および Canary チャネル

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

新規のお客様には **他のチャネルで初回展開をテストするには**、次の intunewin パッケージのいずれかを手動でダウンロードしてアップロードできます:

* Beta Channel（安定版に近く、長期テスト向け）:\
  [RealmJoin Beta Version](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)
* Canary Channel（実験的、初期テスト向け）:\
  [RealmJoin Canary Version](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

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

* Program:
  * Device restart behavior: `戻りコードに基づいて動作を決定する`
* Detection rules:
  * 検出ルールを手動で構成する
  * ファイル:
    * パス: `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 アプリと line-of-business アプリのインストールを混在させると、両方が同時に Trusted Installer サービスを使用するため、アプリのインストールが失敗する場合があります。」
{% endhint %}

RealmJoin は [MSI インストーラー](#msi-installer) として Line-of-Business アプリ経由で展開できます。Intune にアップロードする際は、「Ignore app version」が「Yes」になっていることを確認してください。

<figure><img src="/files/c2f14c2bfd7da9dddbb792e8f43bbdb30f54924a" alt="" width="364"><figcaption></figcaption></figure>

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

管理者が、集中的な展開や Microsoft Intune インフラを使わずにデバイスへ RealmJoin Agent をインストールしたい場合は、MSI をダウンロードして対話形式でインストールできます。代わりに、以下のコマンドラインのいずれかをコピーして、1 回の操作で Agent をダウンロードして実行することもできます。

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

* 安定版リリース:\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.msi) または [EXE](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe)
* Beta Channel（安定版に近く、長期テスト向け）:\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.msi) または [EXE](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe)
* Canary Channel（実験的、初期テスト向け）:\
  [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
```

#### ベータ チャネル

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

#### カナリア チャネル

```
@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 を一切表示しないことを選択できます。このような場合は、サイレント インストール オプションを使用してください:

```
reamjoin.exe -install
```

### 署名済み MSI

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

![](/files/6d8f87c0ab89d2e8402a6b3e8c85cb0d3e4ce051)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/ja/realmjoin-agent/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
