# Corrections des problèmes courants

{% 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 également apparaître localisé, selon la langue de l’OS Windows) dans la phase de téléchargement, code de sortie chocolatey `404`:
  1. Ouvrez un PowerShell avec élévation
  2. Exécutez `Clear-BCCache -Force`
* Message d’erreur `L’objet fourni n’a pas été initialisé` (peut également apparaître localisé, selon la langue de l’OS Windows) dans la phase de téléchargement, code de sortie chocolatey `404`:
  1. Ouvrez un PowerShell avec élévation
  2. Exécutez `Reset-BC -Force`
* Message d’erreur `Erreur - les hachages ne correspondent pas. La valeur réelle était « 123abcd »`:
  1. Ouvrez un PowerShell avec élévation
  2. Exécutez `Reset-BC -Force`

{% hint style="warning" %}
Nous recommandons fortement de déployer le **Réinitialiser ou effacer BranchCache** script de remédiation avec une planification quotidienne. Il se trouve dans la [Scripts de remédiation](/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 %}

## 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 valeurs de `packageParameters` dans la section `RJAppDeployToolkit: Resulting Variables`
   * Ce sont la ou les valeurs réelles utilisées pour l’installation et transmises par le backend RealmJoin.
2. Si elles ne correspondent pas à la ou aux valeurs que vous attendiez, vérifiez l’affectation du package dans le portail RealmJoin pour les valeurs de remplacement du groupe / de l’utilisateur.

## Fichier .nupkg corrompu

Si vous voyez l’erreur suivante dans le `chocolatey.log` le fichier .nupkg a été corrompu :

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

On peut souvent aussi constater que la taille du fichier .nupkg est de 0 octet.

Étapes pour corriger 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. Supprimer la variable système `ChocolateyInstall` :
   * Utilisez l’interface graphique : exécutez `sysdm.cpl` -> Onglet `Avancé` -> `Variables d’environnement...`
   * Utilisez le cmd (admin), exécutez : `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. Redémarrez
4. Le bac à sable RealmJoin réinstallera chocolatey, laissez le système se stabiliser pendant 5 à 10 minutes.
5. Si vous constatez des éléments manquants dans le menu du bac à sable 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 ils sont très spécifiques, il s’agit simplement d’un ensemble d’étapes générales de dépannage pour aider à cerner le problème.**

* Vérifiez s’il existe des fichiers journaux dans `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`.
  * Essayez d’analyser le ou les fichiers journaux 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 la configuration en mode interface 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, exécuter l’installation à l’aide d’un compte administrateur local standard fournira la même erreur, donc l’exécution depuis `NT AUTHORITY\SYSTEM` peut ne pas être nécessaire.

### Package non disponible à l’installation / n’apparaît pas dans le menu du bac à sable 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 que le package est correctement attribué à l’utilisateur ou que l’utilisateur est membre du groupe attribué
* Vérifiez que le package n’est pas attribué comme caché (utilisez le mode Débogage pour voir les packages attribués cachés)
* Vérifiez que l’utilisateur est l’utilisateur principal du client ; sinon, vérifiez que le package est configuré pour être disponible pour les utilisateurs secondaires

## ConfigUpdater non autorisé <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

<figure><img src="/files/a34b73a3cad295bb9aebbea78381bd312f969d92" alt=""><figcaption><p>L’agent RJ ne peut pas accéder à la configuration</p></figcaption></figure>

Le principal problème à l’origine de ce souci est que le jeton d’accès n’a pas été actualisé automatiquement comme prévu. En règle générale, les jetons d’accès sont mis à jour automatiquement afin de garantir un accès ininterrompu aux ressources. Cependant, dans ce cas, le processus attendu a échoué, ce qui a rendu le jeton obsolète et a donc provoqué des problèmes d’accès. Cela souligne l’importance de veiller à ce que les mécanismes automatisés d’actualisation des jetons fonctionnent correctement afin d’éviter des problèmes similaires à l’avenir. Le fait de traiter cette cause racine aidera à maintenir un accès cohérent et à éviter les interruptions dans

1. Supprimez le fichier de jeton RealmJoin :
   * Chemin : `%LOCALAPPDATA%\RealmJoin`
   * RJ 4.19 et versions antérieures `token2.dat`
   * RJ 4.20 et versions ultérieures : `msal_cache.dat`
2. Redémarrez


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/fr/autre/troubleshooting/package-installation-issues/fixes-for-common-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
