> 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). # Agent の展開 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（デバイス）](https://portal.realmjoin.com/packagestore/45935/overview)
3. 「**Intune（管理済み）を使用**」を展開方法として使用し、「Continue」をクリックします。 4. このパッケージを「**Enrollment Status Page**」の「ユーザー/デバイスに割り当てられた必須アプリがインストールされるまでデバイスの使用をブロックする」に追加してください。これにより、Intune は登録中に RealmJoin Agent のインストールを待機します。 5. また「**Automation Main channel**".
{% hint style="info" %} RealmJoin エージェントは **新しいバージョンを確認します** ～の間に **初回展開** および **必要に応じて更新します**。このプロセスを高速化するため、引き続き「Automate Main channel」を推奨します。これにより、最新バージョンが最初からインストールされます。 {% endhint %} {% hint style="warning" %} お願いします **「Automate Preview channel」は使用しないでください** なぜなら **intunewin アプリケーション ID が変更される可能性があるため** その結果、パッケージが「Enrollment Status Page」構成から削除されます。 {% endhint %} 6. **割り当ててください** パッケージを **デバイス** （ユーザー オブジェクトに割り当てると、展開中にエージェントが起動しない可能性があります）。例: 1. 追加 **単一のデバイスまたはデバイス グループ** を自動作成される管理対象アプリ グループに 2. 「**すべてのデバイス**」を **Intune 経由の追加割り当てとして** (AVD や Kiosk などの特別なデバイスを除外するためにフィルターが必要になる場合があります) {% hint style="info" %} 当社のストアでは、ユーザー レベルで動作する「RealmJoin Agent (User)」パッケージも提供しています（以前はこれが既定でした）。そのため、 **安定性上の理由**から、現在は **デバイス レベル版のみを推奨しています**. {% endhint %} ## Beta および Canary チャネル {% hint style="info" %} RealmJoin のリリース **チャネル** は **ユーザーおよびグループ設定で調整**: [RealmJoin のリリース チャネルを構成](/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) として Line-of-Business アプリを使用して展開できます。Intune にアップロードする際は、「Ignore app version」が「Yes」に設定されていることを確認してください。
### コマンドラインによる対話型インストール 管理者が大量展開や Microsoft Intune インフラストラクチャを使わずにデバイスへ RealmJoin Agent をインストールしたい場合、MSI をダウンロードして対話型インストールを行うことができます。代替手段として、以下のコマンドラインのいずれかをコピーして、Agent を 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 から安全にインストールできるものとして認識されます。 ![](/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, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/ja/realmjoin-agent/installation.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.