> 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/realmjoin-client/native-choco-runtime.md).

# Native Choco Runtime

Native Choco Runtime は、既存パッケージとの完全な互換性を保ちながら、古い Chocolatey 0.10.3 バイナリを置き換える RealmJoin 独自のプロセス内パッケージ インストール エンジンです。

{% hint style="info" %}
Native Choco Runtime は、次とともに導入されました **RealmJoin Agent 4.21.6（ベータ版）**。この機能は **オプトイン**：ネイティブ ランタイムを明示的に有効にするまで、既存のクライアントは従来の Chocolatey エンジンを使い続けます。
{% endhint %}

## 概要

RealmJoin Agent が Intune の外でソフトウェア パッケージをインストールする場合（参照 [パッケージのインストール](https://docs.realmjoin.com/ja/realmjoin-agent/realmjoin-client/deploy-apps.md#package-installation)）、従来は次に依存していました: [Chocolatey](https://chocolatey.org/) を基盤のパッケージ エンジンとして利用していました。RealmJoin は、オープンソースの Chocolatey CLI の固定された大幅にパッチ適用済みビルド（バージョン **0.10.3** — としてバンドルされていた `choco.exe` の下で。 `C:\ProgramData\chocolatey\`.

次の **Native Choco Runtime** は、そのバンドルされた Chocolatey バイナリを RealmJoin の **独自の目的特化実装** に置き換えます。これは **同一プロセス内** で RealmJoin サービス内で実行されます。これは *シムとして機能し* Chocolatey に対応しており、同じパッケージ形式（`.nupkg`）を理解し、パッケージ作成者と管理者の観点では同じように動作しますが、もはや老朽化した Chocolatey 0.10.3 のコードベースには依存しません。

つまり、すでに使用しているパッケージは変更なしで引き続き動作し、下で動くエンジンだけが変わります。

## 仕組み

* **同一プロセス内エンジン。** パッケージのインストールは、外部のプロセスを起動するのではなく RealmJoin サービス内で実行されます `choco.exe`。 `chocolateyInstall.ps1` は、各パッケージの chocolateyInstall.ps1 は、同一プロセス内の PowerShell ラン スペースで実行されます。
* **分離されたストレージ。** ネイティブ ランタイムは、次の場所に自身の **専用の** ルートに `C:\ProgramData\RealmJoin\choco\` （ `lib\`, `extensions\`、そして `logs\` のサブフォルダーを含みます）。従来の Chocolatey の状態を書き込むことはなく、 `C:\ProgramData\chocolatey\` また、マシン全体の `ChocolateyInstall` 環境変数も変更しません。つまり、ネイティブ ランタイムと既存の従来版 Chocolatey は **共存できます** 同じデバイス上で。
* **依存関係の自動解決。** 次で宣言されたパッケージの依存関係は、 `.nuspec` （たとえば [RealmJoin Core Choco Extension](https://docs.realmjoin.com/ja/realmjoin-agent/recommended-packages.md#realmjoin-core-choco-extension)）など）は、構成済みのソースから自動的に解決され、インストールされます。
* **`choco.exe` シム。** 一部のパッケージ スクリプトは `choco.exe` を直接呼び出します。これらを動作させ続けるため、ランタイムは小さなシムを次に配置します `%ProgramFiles%\RealmJoin\choco-shim\choco.exe` 。このシムは、そうした呼び出しを従来の Chocolatey ではなく同一プロセス内エンジンにルーティングし直します。シムはシステムの `PATH`には追加されず、パッケージ スクリプトの実行中のみ利用可能になります。

## 互換性

Native Choco Runtime は、次のような **置き換え互換の代替手段**:

* 既存の RealmJoin パッケージ（ [Package Store](https://docs.realmjoin.com/ja/apurikshon/packages/package-store.md)）を含め、インストールとアンインストールは同じ方法で行われます。
* RealmJoin Portal で構成したパッケージ引数 / params は引き続き機能します。
* 次の [RealmJoin Core Choco Extension](https://docs.realmjoin.com/ja/realmjoin-agent/recommended-packages.md#realmjoin-core-choco-extension) パッケージ スクリプト内で使われるヘルパー cmdlet も引き続き利用できます。
* [RealmJoin ESP](https://docs.realmjoin.com/ja/realmjoin-agent/realmjoin-client/realmjoin-esp.md) / Autopilot もサポートされます: ネイティブ ランタイムを有効にした新しいデバイスでは、 `winchoco` 登録中にパッケージがネイティブにインストールされ、依存関係も自動的に解決されます。

{% hint style="warning" %}
このランタイムはベータ版のため、テナント全体に展開する前に、パイロット リングで重要なパッケージを検証することをおすすめします。一般提供前に対応できるよう、動作の違いがあれば RealmJoin Support までご報告ください。
{% endhint %}

## 使い方

ランタイムは RealmJoin の **設定**で選択されるため、個々のクライアントを触るのではなく中央で制御できます。RealmJoin の設定は継承されるため、 **テナント全体の既定値** を設定し、必要に応じて **特定のグループで上書きできます** （およびその中のオブジェクト）

{% hint style="info" %}
設定キー: `Chocolatey.UseNativeRuntime`

設定値: `true` / `false`
{% endhint %}

動作は次の設定で制御されます:

<table><thead><tr><th>設定項目</th><th width="120">既定値</th><th>意味</th></tr></thead><tbody><tr><td><code>Chocolatey.Enabled</code></td><td><code>false</code></td><td>RealmJoin は、デバイス上の Chocolatey 型パッケージを管理します。</td></tr><tr><td><code>Chocolatey.UseNativeRuntime</code></td><td><code>false</code></td><td>メイン スイッチ。これを <code>false</code>にすると、インストールは引き続き従来の <code>choco.exe</code>。 <code>true</code>、すべての <code>winchoco</code> インストールが同一プロセス内のネイティブ ランタイムを通過します。</td></tr><tr><td><code>Chocolatey.DisableShim</code></td><td><code>false</code></td><td>次の場合にのみ関連します: <code>UseNativeRuntime = true</code>。 <code>true</code>にしている場合、外部の <code>choco.exe</code> を呼び出すパッケージ スクリプトは、シム経由でルーティングされず明示的に失敗します。外部バイナリをまだ参照しているスクリプトをあぶり出すのに便利です。</td></tr></tbody></table>

{% stepper %}
{% step %}

### まずはパイロット グループで有効にする

RealmJoin の設定を開き、 **グループ** 少数のパイロット デバイスを含むグループで `Chocolatey.UseNativeRuntime` を `true` 設定します。グループ設定はテナント全体の既定値より優先されるため、そのデバイスだけが新しいエンジンに切り替わります。
{% endstep %}

{% step %}

### パッケージを検証する

パイロット デバイスで通常どおりのパッケージ割り当てとアップグレードを実行させます。インストールが成功することを確認し、何かおかしければログを確認してください（参照 [パッケージ インストールの問題](https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues.md)).
{% endstep %}

{% step %}

### テナント全体に展開する

問題ないと確認できたら、 `Chocolatey.UseNativeRuntime` を `true` なぜなら **テナント全体の既定値** すべてのクライアントがそれを使うように設定します。必要に応じて個別のグループは、引き続き一時的に従来のエンジンを使うよう除外できます。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
構成は、次の項で説明されている他のエージェント設定と同じテナント設定 / グループ上書きモデルに従います [全般設定](https://docs.realmjoin.com/ja/to/general.md) （たとえば **クライアント構成** と **LAPS 構成** Tenant 設定を使用します)。
{% endhint %}

## 既定値は何ですか

Native Choco Runtime は **既定では無効です** (`Chocolatey.UseNativeRuntime = false`）。管理者がネイティブ ランタイムを有効にするまで、クライアントは従来のバンドル済み Chocolatey 0.10.3 エンジンを使い続けます。これはテナント全体または特定のグループ単位で有効化できます。これにより、ベータ版の間は新しいランタイムを自分のペースで導入し、同じくらい簡単に元に戻せます。

## 既存デバイスの移行

ネイティブ ランタイムと従来の Chocolatey は **共存できます** 必要な期間、1 台のデバイス上で共存できます。すでに従来の Chocolatey でインストールされたパッケージがあるデバイスでネイティブ ランタイムを有効にすると:

* 既存の RealmJoin 管理パッケージは引き続き動作し、 **は** ランタイムが変わっただけで再インストールされることはありません。インストール済みの状態は切り替え後も引き継がれるため、再インストールの嵐は発生しません。
* 新規インストールとアップグレードはネイティブ ランタイムを通過し、従来のインストールは明示的に削除されるまでディスク上にそのまま残ります。

{% hint style="info" %}
従来の Chocolatey をフリート全体から削除する作業は、別途調整された手順として計画されています。それまでは、ネイティブ ランタイムは残存する従来のインストールと共存できるため、すぐに片付ける厳しい期限はありません。
{% endhint %}

個々のデバイス（たとえばサポートや QA の最中）については、管理者がシムの `移行して` コマンド動詞を **管理者権限の** シェルから実行して、

{% code overflow="wrap" %}

```powershell
# 変更せずに、どうなるかをプレビューする
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --dry-run

# ステートフル パッケージをネイティブ ランタイム経由で再インストールし、その後従来版を削除する
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --yes
```

{% endcode %}

{% hint style="warning" %}
`choco migrate` は **単一デバイス向けの管理者用ヘルパーです** （サポート、開発/QA、一回限りのクリーンアップ向け）です。これは **は** フリート全体に変更を展開するための仕組みではありません。そちらにはテナント/グループ設定を使用してください。
{% endhint %}

## ログとトラブルシューティング

ネイティブ ランタイムによるインストールは、各パッケージごとのログを次に書き込みます:

```
C:\ProgramData\RealmJoin\choco\logs\<package-id>\<timestamp>_<version>_<operation>.log
```

（各パッケージにつき最新 10 件まで保持されます）。これは従来の Chocolatey の `C:\ProgramData\chocolatey\logs\`とは別です。サポート依頼用にログを収集する際は、 `C:\ProgramData\RealmJoin\` フォルダーも含めてください。詳細は [パッケージ インストールの問題](https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues.md).

### ファイルとパスの参照

| パス                                                | 目的                                |
| ------------------------------------------------- | --------------------------------- |
| `C:\ProgramData\RealmJoin\choco\lib\<id>`         | ネイティブ ランタイムのパッケージ インストール ルート。     |
| `C:\ProgramData\RealmJoin\choco\extensions\<id>`  | 自動インポートされる PowerShell ヘルパー モジュール。 |
| `C:\ProgramData\RealmJoin\choco\logs\<id>`        | インストールごとのログ（各パッケージ最新 10 件）。       |
| `C:\Program Files\RealmJoin\choco-shim\choco.exe` | 次の `choco.exe` シム。                |


---

# 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/realmjoin-client/native-choco-runtime.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.
