> 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 エージェントは Microsoft Intune を使用してシームレスに展開できます。すぐに使えるパッケージが Package Store に用意されており、セットアップ プロセスを簡素化します。\ このガイドでは、Intune を介して RealmJoin エージェントをインストールするための推奨かつサポート対象の方法を説明します。 ## 自動展開 ### Microsoft Intune (intunewin) {% hint style="success" %} 推奨 {% endhint %} RealmJoin は、エージェントを intunewin パッケージとして追加および更新することで、お使いの Microsoft Intune Tenant と直接連携します： 1. 当社の **パッケージストア**. 2. バナー「RealmJoin エージェント」を選択するか、次の直接リンクを使用してください： [RealmJoin エージェント (デバイス)](https://portal.realmjoin.com/packagestore/45935/overview)
3. 「**Intune を使用する（管理対象）**」を展開方法として選択し、「続行」をクリックします。 4. このパッケージをお使いの「**Enrollment Status Page**」の「ユーザー/デバイスに割り当てられている場合は、必要なアプリがインストールされるまでデバイスの使用をブロックする」の下に追加します。これにより、Intune は登録中に RealmJoin エージェントのインストールを待機します。 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. 「**All devices**」を **Intune による追加の割り当てとして** （AVD や Kiosk などの特殊なデバイスを除外するためにフィルターが必要になる場合があります） {% hint style="info" %} 当社のストアでは、「RealmJoin エージェント (ユーザー)」パッケージも提供しており、これはユーザー レベルで動作します（これは以前の既定値でした）。 **安定性の理由から**、現在は **デバイス レベル版のみを推奨しています**. {% endhint %} ## Beta および Canary チャネル {% hint style="info" %} RealmJoin のリリース **チャネル** は **User and Group settings から調整できます**: [RealmJoin のリリース チャネルを構成する](/ja/ugd-management/user-and-group-settings.md)。初回展開時にのみ **初回展開時に**、 **チャネルはインストーラーによって定義され、固定されます** パッケージです。使用する場合、 [自動展開](#automatic-deployment) 当社の Package Store では、展開は常にリリース チャネルを使用します。 {% endhint %} 新規のお客様の場合は、 **他のチャネルで初回展開をテストする場合**、次の intunewin パッケージのいずれかを手動でダウンロードしてアップロードできます： * Beta チャネル（安定版に近く、長期テスト向け）：\ [RealmJoin Beta Version](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin) * Canary チャネル（実験的、最初のテスト向け）：\ [RealmJoin Canary Version](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 アプリと line-of-business アプリのインストールを混在させると、両方が同時に Trusted Installer サービスを使用するため、アプリのインストールが失敗する可能性があります。」 {% endhint %} RealmJoin は [MSI インストーラー](#msi-installer) を使用して Line-of-Business アプリとして展開できます。Intune にアップロードする際は、「Ignore app version」が「Yes」に設定されていることを確認してください。
### コマンドラインによる対話型インストール 管理者が一斉展開や Microsoft Intune インフラストラクチャを使わずにデバイスへ RealmJoin エージェントをインストールしたい場合、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 チャネル（安定版に近く、長期テスト向け）：\ [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.