Corrections pour problèmes courants

N'utilisez ces correctifs que dans les scénarios décrits !

Ils ne doivent pas être appliqués aveuglément car ils peuvent causer davantage de dommages s'ils sont appliqués inutilement.

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 du système Windows) lors de la phase de téléchargement, code de sortie chocolatey 404:

  1. Ouvrir un PowerShell élevé

  2. Exécuter Clear-BCCache -Force

• Message d'erreur L'objet fourni n'a pas été initialisé (peut également apparaître localisé, selon la langue du système Windows) lors de la phase de téléchargement, code de sortie chocolatey 404:

  1. Ouvrir un PowerShell élevé

  2. Exécuter 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écuter Reset-BC -Force

Nous recommandons vivement de déployer le Script de réinitialisation ou de nettoyage de BranchCache Script de remédiation avec un planning quotidien. Il se trouve dans la Scripts de remédiation 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 automatiquement corrigés (si possible).

Arguments de package manquants / incorrects

1. Vérifiez le chocolatey.log fichier pour la/les valeur(s) de packageParameters dans la section RJAppDeployToolkit: Resulting Variables

   • Ce sont les valeurs réelles utilisées pour l'installation et transmises par le backend RealmJoin.

2. S'il ne s'agit pas des valeurs attendues, 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] - Unable to read package from path 'generic-package-id\generic-package-id.nupkg'.

Il est souvent également possible d'observer 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. Supprimer le dossier generic-package-id

Configuration chocolatey cassée

1. Supprimer le contenu du dossier C:\ProgramData\chocolatey\config

2. Supprimer la variable système ChocolateyInstall :

   • Utiliser l'interface graphique : Exécuter sysdm.cpl -> Onglet Avancé -> Variables d'environnement...

   • Utiliser cmd (admin), exécuter : 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 vous constatez des éléments manquants dans le menu de la zone de notification RealmJoin, redémarrez à nouveau.

Problèmes généraux d'installation

Comme ceux-ci sont très individuels, ceci n'est qu'une collection d'étapes générales de dépannage pour aider à restreindre le problème.

• Vérifier la/les fichier(s) journal dans C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\.

  • Essayez d'analyser le/les fichier(s) journal et de trouver le problème.

• S'il n'y a pas de fichier journal, ou si celui-ci n'est pas utile, essayez d'exécuter manuellement l'installation en mode GUI pour voir les messages d'erreur possibles.

  • IMPORTANT : les packages système RealmJoin sont toujours installés en utilisant le compte intégré NT AUTHORITY\SYSTEM il est donc préférable d'utiliser un outil comme psexec pour exécuter l'installation depuis ce compte.

  • La plupart du temps, exécuter l'installation en utilisant un compte administrateur local standard produira la même erreur, donc exécuter depuis NT AUTHORITY\SYSTEM peut ne pas être nécessaire.

Package non disponible pour installation / n'apparaît pas dans le menu de la zone de notification RealmJoin

• Vérifiez si le package est correctement affecté à l'utilisateur ou si l'utilisateur est membre du groupe affecté

• Vérifiez si le package n'est pas affecté en caché (utilisez le mode Débogage pour voir les packages affectés cachés)

• Vérifiez si l'utilisateur est l'utilisateur principal du client, ou vérifiez si le package est configuré pour être disponible aux utilisateurs secondaires

ConfigUpdater non autorisé

L'agent RJ ne peut pas accéder à la configuration

Le problème principal à l'origine de ce problème 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 d'assurer un accès ininterrompu aux ressources. Cependant, dans ce cas, le processus attendu a échoué, entraînant l'obsolescence du jeton et donc des problèmes d'accès. Cela souligne l'importance de s'assurer que les mécanismes automatiques de rafraîchissement des jetons fonctionnent correctement pour éviter des problèmes similaires à l'avenir. Traiter cette cause principale 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émarrer