Dépannage

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /v1.0.2.0/fr/docs/03-troubleshooting/index.md.

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 :

Get-PackageUpdateInfo -Verbose

Valide les paramètres et règles :

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 :

Get-PackageUpdateInfo -Force

Ou réduit l’intervalle :

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 :

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 :

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 :

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 :

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 :

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 :

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 :

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 :

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