# Dépannage

LLMS index: [llms.txt](/v1.2.6.0/llms.txt)

---

Utilise ce guide lorsque PackageUpdateInfo ne renvoie pas les résultats attendus, saute des vérifications ou échoue lors de l'importation ou de l'exportation de données.

## Obtenir d'abord des diagnostics exploitables

Exécute avec une sortie détaillée :

```powershell
Get-PackageUpdateInfo -Verbose
```

Valide les paramètres et règles :

```powershell
Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule
```

## Vérification sautée de manière inattendue

Symptôme :

- Tu vois un avertissement indiquant que les vérifications de mise à jour sont sautées parce que l'intervalle de vérification n'est pas expiré.

Cause :

- `UpdateCheckInterval` et `LastCheck` récent ou `LastSuccessfulCheck` empêchent une nouvelle vérification en ligne.

Résolution :

```powershell
Get-PackageUpdateInfo -Force
```

Ou réduit l'intervalle :

```powershell
Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Minutes 30)
```

## Le fichier de configuration est manquant ou corrompu

Symptôme :

- `Get-PackageUpdateSetting` avertit que le fichier de configuration du module n'a pas été trouvé, puis lance une erreur.

Cause :

- Le chemin du fichier de configuration n'existe pas ou contient un JSON invalide.

Résolution :

```powershell
Set-PackageUpdateSetting -Reset
Get-PackageUpdateSetting
```

## Aucun module n'est renvoyé

Symptôme :

- `Get-PackageUpdateInfo` ne renvoie rien alors que des modules sont installés.

 Causes courantes :

- Les règles d'inclusion et d'exclusion filtrent tous les modules.
- `-CurrentUser` ou `-AllUsers` filtrent les modules que tu attends.
- Le filtrage par dépôt exclut les modules pertinents.

Étapes de résolution :

```powershell
Get-PackageUpdateRule -IncludeDefaultRule
Get-PackageUpdateInfo -Force
Get-PackageUpdateInfo -CurrentUser -Force
Get-PackageUpdateInfo -AllUsers -Force
```

## L'exportation échoue avec des erreurs de chemin

Symptôme :

- L'exportation signale un problème de chemin ou de répertoire invalide.

Cause :

- `-Path` pointe vers un répertoire ou un emplacement inexistant sans `-Force`.

Résolution :

```powershell
Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.xml" -Force
```

## L'importation ne renvoie aucune donnée

Symptôme :

- `Import-PackageUpdateInfo` ne renvoie rien.

 Causes courantes :

- Le fichier est vide ou trop petit pour contenir des enregistrements.
- `-InputFormat` ne correspond pas au format exporté.
- Mauvais chemin de fichier pour l'exécution et l'édition actuelles.

Résolution :

```powershell
Import-PackageUpdateInfo -InputFormat XML -Verbose
Import-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.json" -InputFormat JSON
```

## Les notifications Toast ne s'affichent pas

Symptôme :

- `-ShowToastNotification` est utilisé, mais aucune notification ne s'affiche.

 Causes courantes :

- BurntToast n'est pas installé.
- La plateforme hôte ne supporte pas les notifications Toast de Windows.
- Aucun module dans le résultat n'a `NeedUpdate = $true`.

Résolution :

```powershell
Install-Module BurntToast -Scope CurrentUser
Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification -Force
```

## Les règles ne peuvent pas être ajoutées ou modifiées

Symptôme :

- L'ajout d'une règle échoue avec un Id, include ou exclude en double.

Cause :

- Des règles personnalisées existantes contiennent déjà les mêmes identifiants ou motifs.

Résolution :

```powershell
Get-PackageUpdateRule
Add-PackageUpdateRule -IncludeModuleForChecking "MyModule.*"
Set-PackageUpdateRule -Id 1 -ReportChangeOnRevision $false
Remove-PackageUpdateRule -Id 1
```

## Problèmes de dépôt et réseau

Symptôme :

- La recherche de version en ligne échoue ou est incomplète.

 Causes courantes :

- Le dépôt n'est pas enregistré ou inaccessible.
- Problèmes temporaires de réseau.

Résolution :

```powershell
Get-PSRepository
Find-Module PackageUpdateInfo -Repository PSGallery
Get-PackageUpdateInfo -Repository PSGallery -Force
```

## Flux de récupération

Si le comportement reste incohérent, utilise cette séquence de réinitialisation :

```powershell
Set-PackageUpdateSetting -Reset
Get-PackageUpdateInfo -Force | Export-PackageUpdateInfo
Import-PackageUpdateInfo
```