> 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/depannage-et-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.md).

# Correctifs pour les problèmes courants

Correctifs ciblés pour les problèmes courants d’installation de packages RealmJoin, tels que les erreurs BranchCache, dans des scénarios spécifiques.

{% hint style="danger" %}
**N'utilisez ces correctifs que dans les scénarios décrits !**

**Ils ne sont pas destinés à être appliqués aveuglément, car ils peuvent faire plus de mal s'ils sont appliqués inutilement.**
{% endhint %}

## Problèmes BranchCache

* Message d'erreur `Il n'y a pas assez d'espace sur le disque` (peut aussi apparaître localisé, selon la langue de l'OS Windows) dans la phase de téléchargement, code de sortie chocolatey `404`:
  1. Ouvrir un PowerShell élevé
  2. Exécutez `Clear-BCCache -Force`
* Message d'erreur `L'objet fourni n'a pas été initialisé` (peut aussi apparaître localisé, selon la langue de l'OS Windows) dans la phase de téléchargement, code de sortie chocolatey `404`:
  1. Ouvrir un PowerShell élevé
  2. Exécutez `Reset-BC -Force`
* Message d'erreur `Erreur - les hachages ne correspondent pas. La valeur réelle était '123abcd'`:
  1. Ouvrir un PowerShell élevé
  2. Exécutez `Reset-BC -Force`

{% hint style="warning" %}
Nous recommandons vivement de déployer le **Réinitialiser ou effacer BranchCache** Script de remédiation avec une planification quotidienne. Il peut être trouvé dans la [Scripts de remédiation](https://docs.realmjoin.com/fr/automatisation/remediation-scripts.md) section du portail RealmJoin.

En utilisant cette méthode, les problèmes BranchCache mentionnés ci-dessus seront détectés de manière proactive et corrigés automatiquement (si possible).
{% endhint %}

## Croissance du dossier temporaire de Chocolatey

Les fichiers d'installation des paquets Chocolatey sont téléchargés dans `C:\\Windows\\Temp\\chocolatey\\<package-id>\\<version>\\` et ne sont pas supprimés après l'installation. Cela s'applique à la fois au moteur Chocolatey classique et au [Native Choco Runtime](https://docs.realmjoin.com/fr/agent-realmjoin/realmjoin-client/native-choco-runtime.md). Avec le temps, le dossier peut occuper une quantité considérable d'espace disque.

Si vous souhaitez que ce dossier soit nettoyé automatiquement, déployez le **Nettoyage du dossier temporaire de Chocolatey** Script de remédiation depuis le [Scripts de remédiation](https://docs.realmjoin.com/fr/automatisation/remediation-scripts.md) section du portail RealmJoin. Il supprime les dossiers de version des paquets datant de plus de 7 jours.

## Arguments de package manquants / incorrects <a href="#user-content-missing-wrong-package-arguments" id="user-content-missing-wrong-package-arguments"></a>

1. Vérifiez le `chocolatey.log` fichier pour la ou les valeur(s) de `packageParameters` dans la section `RJAppDeployToolkit : Variables résultantes`
   * Ce sont les valeur(s) réelles utilisées pour l'installation et transmises par le backend RealmJoin.
2. Si ce ne sont pas les valeur(s) attendues, vérifiez l'attribution du package dans le portail RealmJoin pour les valeurs de remplacement groupe / utilisateur.

## Fichier .nupkg corrompu

Si vous voyez l'erreur suivante dans le `chocolatey.log` le fichier .nupkg est corrompu :

`[ERROR] - Impossible de lire le package depuis le chemin 'generic-package-id\\generic-package-id.nupkg'.`

On peut aussi souvent constater que le fichier .nupkg a une taille de 0 octet.

Étapes pour résoudre ce problème :

1. Accédez à `C:\\ProgramData\\chocolatey\\lib`
2. Supprimez le dossier `generic-package-id`

## Configuration Chocolatey défectueuse <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

1. Supprimez le contenu du dossier `C:\\ProgramData\\chocolatey\\config`
2. Supprimez la variable système `ChocolateyInstall` :
   * Utiliser l'interface graphique : Exécuter `sysdm.cpl` -> Onglet `Avancé` -> `Variables d'environnement...`
   * Utilisez l'invite de commandes (admin), exécutez : `REG delete "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /V ChocolateyInstall`
3. Redémarrer
4. La zone de notification RealmJoin réinstallera chocolatey, laissez le système se stabiliser pendant 5 à 10 minutes.
5. Si des éléments manquent dans le menu de la zone de notification RealmJoin, redémarrez à nouveau.

## Problèmes généraux de configuration <a href="#user-content-general-setup-issues" id="user-content-general-setup-issues"></a>

**Comme ces cas sont très particuliers, il ne s'agit ici que d'une collection d'étapes de dépannage générales pour aider à cerner le problème.**

* Vérifiez la présence de fichier(s) journal dans `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`.
  * Essayez d'analyser le(s) fichier(s) journal et de trouver le problème.
* Si aucun fichier journal n'est présent, ou s'il n'est pas utile, essayez d'exécuter manuellement l'installation en mode graphique afin de voir d'éventuels messages d'erreur.
  * IMPORTANT : les paquets système RealmJoin sont toujours installés à l'aide du compte intégré `NT AUTHORITY\SYSTEM` , il est donc préférable d'utiliser un outil comme `psexec` pour lancer l'installation depuis ce compte.
  * La plupart du temps, lancer l'installation avec un compte administrateur local standard produira la même erreur, donc lancer depuis `NT AUTHORITY\SYSTEM` peut ne pas être nécessaire.

### Le package n'est pas disponible à l'installation / n'apparaît pas dans le menu de la zone de notification RealmJoin <a href="#user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu" id="user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu"></a>

* Vérifiez si le package est correctement attribué à l'utilisateur ou si l'utilisateur est membre du groupe attribué
* Vérifiez si le package n'est pas attribué en masqué (utilisez le mode de débogage pour voir les packages attribués masqués)
* Vérifiez si l'utilisateur est l'utilisateur principal du client, sinon vérifiez si le package est configuré pour être disponible pour les utilisateurs secondaires


---

# 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/depannage-et-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.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.
