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

# Exécution Native Choco

Le Native Choco Runtime est le moteur d’installation de packages en processus de RealmJoin, qui remplace l’ancien binaire Chocolatey 0.10.3 tout en restant entièrement compatible avec les packages existants.

{% hint style="info" %}
Le Native Choco Runtime a été introduit avec **RealmJoin Agent 4.21.6 (bêta)**. La fonctionnalité est **facultative**: les clients existants continuent d’utiliser le moteur classique Chocolatey jusqu’à ce que vous activiez explicitement le runtime natif.
{% endhint %}

## Ce que c’est

Lorsque l’agent RealmJoin installe des packages logiciels en dehors d’Intune (voir [installation de packages](https://docs.realmjoin.com/fr/agent-realmjoin/realmjoin-client/deploy-apps.md#package-installation)), il s’appuyait traditionnellement sur [Chocolatey](https://chocolatey.org/) comme moteur de packages sous-jacent. RealmJoin a livré une version figée et largement patchée du CLI Chocolatey open source — version **0.10.3** — fournie avec `choco.exe` sous `C:\ProgramData\chocolatey\`.

Le **Native Choco Runtime** remplace ce binaire Chocolatey fourni avec RealmJoin par **sa propre implémentation dédiée** qui s’exécute **dans le processus** au sein du service RealmJoin. Elle *émule* Chocolatey : il comprend le même format de package (`.nupkg`) et se comporte de la même façon du point de vue de l’auteur du package et de l’administrateur, mais il ne dépend plus de la base de code vieillissante Chocolatey 0.10.3.

Autrement dit, les packages que vous utilisez déjà continuent de fonctionner sans changement — seul le moteur sous-jacent change.

## Fonctionnement

* **Moteur dans le processus.** Les installations de packages s’exécutent au sein du service RealmJoin au lieu d’appeler un `choco.exe`. Le `chocolateyInstall.ps1` externe ; le script de chaque package est exécuté dans un espace d’exécution PowerShell dans le processus.
* **Stockage isolé.** Le runtime natif s’installe dans son **propre** racine, `C:\ProgramData\RealmJoin\choco\` (avec `lib\`, `extensions\`, et `logs\` comme sous-dossiers). Il n’écrit jamais dans l’état de Chocolatey classique sous `C:\ProgramData\chocolatey\` et ne modifie jamais la variable d’environnement `ChocolateyInstall` à l’échelle de la machine. Cela signifie que le runtime natif et un Chocolatey classique déjà présent peuvent **coexister** sur le même appareil.
* **Résolution automatique des dépendances.** Les dépendances de packages déclarées dans le `.nuspec` (comme le [RealmJoin Core Choco Extension](https://docs.realmjoin.com/fr/agent-realmjoin/recommended-packages.md#realmjoin-core-choco-extension)) sont résolues et installées automatiquement à partir de vos sources configurées.
* **`choco.exe` shim.** Certains scripts de package appellent `choco.exe` directement. Pour que cela continue de fonctionner, le runtime déploie un petit shim vers `%ProgramFiles%\RealmJoin\choco-shim\choco.exe` qui redirige ces appels vers le moteur dans le processus plutôt que vers Chocolatey classique. Le shim n’est pas ajouté au `PATH`système ; il n’est mis à disposition des scripts de package que pendant leur exécution.

## Compatibilité

Le Native Choco Runtime est conçu comme un **remplacement direct**:

* Les packages RealmJoin existants (y compris tout ce qui vient de [Package Store](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-store.md)) s’installent et se désinstallent de la même manière.
* Les arguments / params de package configurés dans le RealmJoin Portal continuent de fonctionner.
* Le [RealmJoin Core Choco Extension](https://docs.realmjoin.com/fr/agent-realmjoin/recommended-packages.md#realmjoin-core-choco-extension) les cmdlets d’assistance utilisées dans les scripts de package restent disponibles.
* [RealmJoin ESP](https://docs.realmjoin.com/fr/agent-realmjoin/realmjoin-client/realmjoin-esp.md) / Autopilot sont pris en charge : sur un appareil neuf avec le runtime natif activé, `winchoco` les packages sont installés nativement lors de l’inscription, avec leurs dépendances résolues automatiquement.

{% hint style="warning" %}
Comme ce runtime est en bêta, nous vous recommandons de valider vos packages les plus importants sur un anneau pilote avant de le déployer à l’échelle du tenant. Veuillez signaler toute différence de comportement au support RealmJoin afin que nous puissions la corriger avant la disponibilité générale.
{% endhint %}

## Comment l’utiliser

Le runtime est sélectionné via un **paramètre RealmJoin**, vous pouvez donc le contrôler de manière centralisée plutôt que de modifier chaque client. Les paramètres RealmJoin se répercutent, ce qui signifie que vous pouvez définir un **paramètre par défaut à l’échelle du tenant** et, si nécessaire, **le remplacer pour des groupes spécifiques** (et les objets qu’ils contiennent).

{% hint style="info" %}
Clé du paramètre : `Chocolatey.UseNativeRuntime`

Valeur du paramètre : `vrai` / `false`
{% endhint %}

Les paramètres suivants contrôlent le comportement :

<table><thead><tr><th>Paramètre</th><th width="120">Valeur par défaut</th><th>Signification</th></tr></thead><tbody><tr><td><code>Chocolatey.Enabled</code></td><td><code>false</code></td><td>RealmJoin gère les packages de type Chocolatey sur l’appareil.</td></tr><tr><td><code>Chocolatey.UseNativeRuntime</code></td><td><code>false</code></td><td>Interrupteur principal. Quand <code>false</code>, les installations passent encore par le moteur classique <code>choco.exe</code>. Lorsque <code>vrai</code>, toutes les <code>winchoco</code> installations passent par le runtime natif dans le processus.</td></tr><tr><td><code>Chocolatey.DisableShim</code></td><td><code>false</code></td><td>Pertinent uniquement lorsque <code>UseNativeRuntime = true</code>. Lorsque <code>vrai</code>, tout script de package qui appelle un <code>choco.exe</code> externe échoue explicitement au lieu d’être redirigé via le shim — utile pour faire ressortir les scripts qui continuent à appeler un binaire externe.</td></tr></tbody></table>

{% stepper %}
{% step %}

### Activez-le d’abord pour un groupe pilote

Ouvrez les paramètres d’un **groupe** RealmJoin qui contient un petit ensemble d’appareils pilotes et définissez `Chocolatey.UseNativeRuntime` à `vrai` là. Comme les paramètres de groupe ont priorité sur le paramètre par défaut à l’échelle du tenant, seuls ces appareils basculent vers le nouveau moteur.
{% endstep %}

{% step %}

### Validez vos packages

Laissez les appareils pilotes exécuter leurs affectations de packages et leurs mises à niveau normales. Vérifiez que les installations réussissent et consultez les journaux si quelque chose vous semble anormal (voir [Problèmes d’installation de packages](https://docs.realmjoin.com/fr/depannage-et-faq/troubleshooting/package-installation-issues.md)).
{% endstep %}

{% step %}

### Déployez-le à l’échelle du tenant

Une fois que vous êtes confiant, définissez `Chocolatey.UseNativeRuntime` à `vrai` car le **paramètre par défaut à l’échelle du tenant** afin que tous les clients l’utilisent. Les groupes individuels peuvent toujours se désinscrire si vous devez temporairement les conserver sur le moteur classique.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
La configuration suit le même modèle paramètre de tenant / remplacement de groupe que les autres paramètres de l’agent décrits sous [Paramètres généraux](https://docs.realmjoin.com/fr/administration-et-parametres/general.md) (par exemple **Configuration du client** et **Configuration LAPS** paramètres du tenant).
{% endhint %}

## Quel est le paramètre par défaut

Le Native Choco Runtime est **désactivé par défaut** (`Chocolatey.UseNativeRuntime = false`). Les clients continuent d’utiliser le moteur Chocolatey 0.10.3 classique fourni avec le produit jusqu’à ce qu’un administrateur active le runtime natif — à l’échelle du tenant ou pour un groupe spécifique. Cela vous permet d’adopter le nouveau runtime à votre propre rythme et de revenir en arrière tout aussi facilement tant que la fonctionnalité est en bêta.

## Migration des appareils existants

Le runtime natif et Chocolatey classique **coexister** sur un appareil aussi longtemps que nécessaire. Lorsque vous activez le runtime natif sur un appareil qui a déjà des packages installés avec Chocolatey classique :

* Les packages existants gérés par RealmJoin continuent de fonctionner et ne sont **ne** pas réinstallés simplement parce que le runtime a changé — leur état installé est conservé lors du basculement, il n’y a donc pas de tempête de réinstallations.
* Les nouvelles installations et les mises à niveau passent par le runtime natif ; l’installation classique reste sur le disque, intacte, jusqu’à ce qu’elle soit explicitement supprimée.

{% hint style="info" %}
La suppression à l’échelle de la flotte de Chocolatey classique est prévue comme une étape distincte et orchestrée. D’ici là, le runtime natif peut très bien coexister avec une installation classique résiduelle, il n’y a donc pas de date butoir stricte pour la nettoyer.
{% endhint %}

Pour un appareil individuel (par exemple lors d’un support ou d’une QA), un administrateur peut faire sortir une machine de Chocolatey classique avec le `migrer` verbe **élevé** du shell :

{% code overflow="wrap" %}

```powershell
# Aperçu de ce qui se passerait, sans apporter de modifications
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --dry-run

# Réinstalle les packages avec état via le runtime natif, puis supprime la version classique
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --yes
```

{% endcode %}

{% hint style="warning" %}
`choco migrate` est un **outil d’administration pour un seul appareil** (support, dev/QA, nettoyage ponctuel). Ce n’est **ne** pas le mécanisme à utiliser pour déployer le changement sur toute une flotte — utilisez pour cela les paramètres de tenant/groupe.
{% endhint %}

## Journaux et dépannage

Les installations du runtime natif écrivent un journal par package dans :

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

(conservés à hauteur des 10 entrées les plus récentes par package). Ceci est distinct des `C:\ProgramData\chocolatey\logs\`. Lorsque vous collectez des journaux pour une demande de support, incluez le `dossier C:\ProgramData\RealmJoin\` comme décrit dans [Problèmes d’installation de packages](https://docs.realmjoin.com/fr/depannage-et-faq/troubleshooting/package-installation-issues.md).

### Référence des fichiers et des chemins

| Path                                              | Rôle                                                      |
| ------------------------------------------------- | --------------------------------------------------------- |
| `C:\ProgramData\RealmJoin\choco\lib\<id>`         | Racine d’installation des packages du runtime natif.      |
| `C:\ProgramData\RealmJoin\choco\extensions\<id>`  | Modules d’assistance PowerShell importés automatiquement. |
| `C:\ProgramData\RealmJoin\choco\logs\<id>`        | Journaux par installation (10 derniers par package).      |
| `C:\Program Files\RealmJoin\choco-shim\choco.exe` | Le `choco.exe` shim.                                      |


---

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