Version imprimable multipages. Cliquer ici pour imprimer.

Retour à la version par défaut.

À propos de cette documentation

Ceci est le site officiel de la documentation pour PackageUpdateInfo, un module PowerShell qui vous aide à rester à jour avec vos modules installés en vérifiant tous les modules PowerShell installés localement et en signalant ceux qui nécessitent une mise à jour.

À propos du module

PackageUpdateInfo est né d’un besoin réel : suivre les mises à jour des modules sur de nombreux modules PowerShell installés est fastidieux et facile à oublier. Ce module comble cette lacune en vérifiant automatiquement tous les modules installés par rapport à la Galerie PowerShell et en présentant une vue d’ensemble claire des mises à jour disponibles.

Principes de conception clés :

  • Multi-plateforme — supporte Windows, Linux et macOS
  • Compatibilité multi-édition — supporte PowerShell Desktop (5.1+) et Core (7.x)
  • Configurabilité — personnalisez les intervalles de vérification des mises à jour, les règles de sensibilité des versions et les exclusions
  • Compatible avec le pipeline — s’intègre naturellement à l’architecture de pipeline de PowerShell
  • Support des notifications — notifications de bureau BurntToast en option sur Windows

Ressources

Contribuer

Les contributions sont les bienvenues. Si vous trouvez des problèmes, des erreurs ou si vous avez des suggestions d’amélioration, n’hésitez pas à ouvrir une issue ou une pull request sur le dépôt GitHub.

1 - Aperçu

PackageUpdateInfo vous aide à garder vos modules PowerShell installés à jour. Il compare les versions des modules locaux avec celles des dépôts en ligne configurés (par exemple PSGallery) et signale lorsqu’une version plus récente est disponible.

Que fait PackageUpdateInfo ?

Le module peut :

  • Interroger les modules installés localement.
  • Découvrir les versions en ligne actuelles.
  • Comparer les versions avec une sensibilité configurable (majeure, mineure, build, révision).
  • Afficher une sortie riche comprenant le dépôt, les notes de version, l’auteur et les liens du projet.
  • Exporter les résultats pour une importation ultérieure et des flux de travail de démarrage rapides.

Pourquoi utiliser PackageUpdateInfo ?

Commodité

  • Identifier rapidement les modules obsolètes sans vérifier manuellement chacun d’eux.
  • Exporter et importer les informations de mise à jour pour une revue hors ligne ou différée.
  • Effectuer des vérifications de mise à jour en arrière-plan.
  • Utiliser des notifications toast optionnelles sur Windows.

Automatisation

  • Programmer des vérifications de mise à jour en utilisant votre profil, des tâches planifiées ou des routines de démarrage.
  • Imposer un intervalle de vérification pour réduire les requêtes inutiles aux dépôts.
  • Maintenir des règles personnalisées par motif de module pour la sensibilité à la mise à jour.
  • Réutiliser les données exportées précédemment pour un démarrage de shell à faible latence.

Flexibilité

  • Inclure ou exclure des motifs de noms de modules.
  • Définir la portée et la priorité des règles avec des règles par défaut et personnalisées.
  • Fonctionne sur Windows, Linux et macOS.
  • Supporte Windows PowerShell 5.1 et PowerShell 7+.

Prérequis

  • Windows PowerShell 5.1 ou PowerShell 7+.
  • PowerShellGet avec accès à votre dépôt cible (par exemple PSGallery).
  • Optionnel : module BurntToast pour les notifications toast sur Windows.

Installation

Installer pour tous les utilisateurs (nécessite des droits administratifs) :

Install-Module PackageUpdateInfo

Installer pour l’utilisateur actuel :

Install-Module PackageUpdateInfo -Scope CurrentUser

Démarrage rapide

Lancer une vérification interactive :

Get-PackageUpdateInfo

Afficher uniquement les modules nécessitant une mise à jour :

Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Forcer une vérification même si l’intervalle de mise à jour configuré n’a pas expiré :

Get-PackageUpdateInfo -Force

Utiliser les notifications toast (Windows avec BurntToast) :

Get-PackageUpdateInfo -ShowToastNotification

Modèle d’automatisation pratique

Exporter les données de mise à jour dans un travail en arrière-plan et les importer au démarrage du shell :

Start-Job -ScriptBlock { Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification | Export-PackageUpdateInfo } | Out-Null
Import-PackageUpdateInfo

Cela maintient le démarrage interactif tout en affichant les informations de mise à jour récentes.

Prochaines étapes

  • Continuer avec les meilleures pratiques opérationnelles pour le réglage, la conception des règles et l’automatisation.
  • Continuer avec le dépannage pour les erreurs courantes et les flux de récupération.

2 - Bonnes pratiques opérationnelles

Cette page décrit les modèles d’exploitation recommandés pour PackageUpdateInfo dans les shells interactifs, profils et automatisations.

Commence avec le comportement par défaut

Réinitialise les paramètres avant d’introduire des réglages personnalisés, surtout sur des systèmes partagés :

Set-PackageUpdateSetting -Reset

Inspecte la configuration et les règles actuelles :

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Utilise des intervalles de mise à jour pour réduire le bruit

Get-PackageUpdateInfo respecte UpdateCheckInterval. Si la dernière vérification effective est encore dans l’intervalle configuré, la cmdlet retourne rapidement.

Définis un intervalle qui correspond à ton environnement :

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Hours 6)

Utilise -Force uniquement pour des vérifications ad-hoc :

Get-PackageUpdateInfo -Force

Préfère un démarrage de shell non bloquant

Un modèle de profil pratique est :

Start-Job -ScriptBlock {
    Get-PackageUpdateInfo -ShowOnlyNeededUpdate | Export-PackageUpdateInfo
} | Out-Null

Import-PackageUpdateInfo

Pourquoi ça fonctionne bien :

  • Le démarrage reste rapide car l’import lit les données en cache.
  • La vérification en ligne coûteuse s’exécute en arrière-plan.
  • Tu obtiens toujours une visibilité utile sur les mises à jour dans chaque session.

Vérifie explicitement la portée quand c’est nécessaire

Utilise les paramètres de portée lorsque les permissions diffèrent entre modules utilisateur et système :

Get-PackageUpdateInfo -CurrentUser
Get-PackageUpdateInfo -AllUsers

Utilise -Repository dans des environnements avec plusieurs dépôts configurés :

Get-PackageUpdateInfo -Repository PSGallery

Conçois soigneusement les règles

Utilise des exclusions larges uniquement si c’est intentionnel. Exclure de grands motifs peut masquer des mises à jour importantes.

Crée des règles personnalisées ciblées pour les modules à forte rotation :

Add-PackageUpdateRule -IncludeModuleForChecking "Az.*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $false -ReportChangeOnRevision $false

Vérifie la priorité des règles en listant toutes :

Get-PackageUpdateRule -IncludeDefaultRule | Sort-Object Id

Utilise l’exportation/importation de façon intentionnelle

Les chemins d’exportation et d’importation par défaut sont spécifiques à la plateforme et incluent l’édition PowerShell et la version majeure dans le nom de fichier. Cela aide à éviter de mélanger des données provenant de différentes versions d’exécution.

Options d’exportation courantes :

Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat XML
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV

Recommandations :

  • Utilise XML si tu veux préserver des objets typés pour une réimportation.
  • Utilise JSON ou CSV pour des rapports externes et intégrations.
  • Utilise -IncludeTimeStamp pour le suivi historique.

Garde les notifications utiles

Utilise les notifications toast uniquement là où elles apportent une valeur ajoutée :

  • Sur des hôtes Windows avec BurntToast installé.
  • Sur des sessions où des alertes interactives sont attendues.

Pour les serveurs, CI, et shells non interactifs, privilégie les rapports exportés plutôt que les notifications toast.

3 - Dépannage

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

4 - Module commands reference

Ici, tu peux trouver une référence pour toutes les commandes du module. Cette référence est conçue pour t’aider à trouver rapidement la commande dont tu as besoin et à comprendre comment l’utiliser efficacement.

En cliquant sur une commande, tu seras dirigé vers une page détaillée qui fournit des informations complètes sur la commande, y compris sa syntaxe, ses paramètres, des exemples, ainsi que des notes ou astuces supplémentaires pour l’utilisation.

4.1 - Add-PackageUpdateRule

SYNOPSIS

Ajoute une règle personnalisée qui contrôle la manière dont les mises à jour des modules sont signalées.

SYNTAXE

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
 [[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
 [[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
 [[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Cette cmdlet possède les alias suivants,

DESCRIPTION

Cette commande crée une règle de mise à jour personnalisée pour la configuration actuelle de PackageUpdateInfo.
Chaque règle définit quand une mise à jour doit être considérée comme pertinente pour le signalement, en fonction des modifications dans la partie majeure, mineure, build ou révision de la version d’un module.
Les règles peuvent également restreindre le signalement à des modules spécifiques en incluant ou excluant des noms de modules, ce qui permet de supprimer les mises à jour uniquement de révision bruyantes ou de concentrer les vérifications sur des modules sélectionnés.
Si aucun objet de paramètres n’est fourni, la commande utilise la configuration actuelle du module et y stocke la nouvelle règle.

EXEMPLES

EXEMPLE 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Ajoute une règle qui signale les mises à jour majeures, mineures et de build pour MyModule tout en supprimant les changements uniquement de révision.

EXEMPLE 2

PS C:\> Add-PackageUpdateRule -ExcludeModuleFromChecking "PowerShellGet","PSScriptAnalyzer" -ReportChangeOnRevision $false

Ajoute une règle qui exclut deux modules de la vérification des mises à jour et supprime les mises à jour de révision pour les modules restants.

EXEMPLE 3

PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru

Ajoute une règle avec un identifiant spécifique et retourne l’objet règle créé.

EXEMPLE 4

PS C:\> $settings = Get-PackageUpdateSetting; Add-PackageUpdateRule -SettingObject $settings -ExcludeModuleFromChecking "MyModule"

Ajoute une règle à un objet de paramètres existant sans utiliser la configuration par défaut du module.

PARAMÈTRES

-Confirm

Demande une confirmation avant d’enregistrer la nouvelle règle.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Un ou plusieurs noms de modules qui doivent être exclus de la vérification des mises à jour par cette règle.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

L’identifiant unique de la règle.

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Un ou plusieurs noms de modules qui doivent être inclus dans la vérification des mises à jour par cette règle.
Si omis, la règle s’applique à tous les modules.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Retourne l’objet règle créé dans le pipeline.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Indique si un changement dans la partie build de la version doit déclencher un rapport de mise à jour.

Cela signifie que ‘Get-PackageUpdateSetting’ signalera une mise à jour uniquement lorsque la version build d’un module change.
Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 5
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Indique si un changement dans la partie majeure de la version doit déclencher un rapport de mise à jour.

Cela signifie que ‘Get-PackageUpdateSetting’ signalera une mise à jour uniquement lorsque la version majeure d’un module change.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Indique si un changement dans la partie mineure de la version doit déclencher un rapport de mise à jour.

Cela signifie que ‘Get-PackageUpdateSetting’ signalera une mise à jour uniquement lorsque la version mineure d’un module change.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 4
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Indique si un changement dans la partie révision de la version doit déclencher un rapport de mise à jour.

Cela signifie que ‘Get-PackageUpdateSetting’ signalera la nécessité d’une mise à jour lorsque la version de révision d’un module change.

Major Minor Build Revision

0 0 0 1

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 6
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Un objet de paramètres provenant de Get-PackageUpdateSetting qui doit recevoir la nouvelle règle.
Si omis, les paramètres actuels du module sont utilisés.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 7
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Affiche ce qui se passerait si la commande était exécutée sans modifier aucune configuration.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

ENTRÉES

PackageUpdate.Configuration

SORTIES

PackageUpdate.ModuleRule

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Rule

LIENS CONNEXES

4.2 - Export-PackageUpdateInfo

SYNOPSIS

Exporte des objets PackageUpdateInfo vers un fichier XML, JSON ou CSV.

SYNTAXE

__AllParameterSets

Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
 [-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIAS

Cette cmdlet possède les alias suivants,

DESCRIPTION

Écrit les objets PackageUpdateInfo produits par Get-PackageUpdateInfo dans un fichier de données structuré pour la persistance, le reporting ou une automatisation ultérieure.
La cmdlet prend en charge les formats de sortie XML, JSON et CSV, l’ajout optionnel d’un horodatage, ainsi que le mode ajout pour étendre un fichier existant.
Elle supporte également la création du répertoire cible si nécessaire et peut renvoyer les objets exportés dans le pipeline.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo

Exporte les objets PackageUpdateInfo actuels vers le fichier XML par défaut.

EXEMPLE 2

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON -Path .\updates.json -IncludeTimeStamp -PassThru

Exporte les données au format JSON, inclut un horodatage pour chaque enregistrement et transmet les objets dans le pipeline.

EXEMPLE 3

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV -Path .\updates.csv -Append -Force

Ajoute les données exportées à un fichier CSV et crée le répertoire cible s’il n’existe pas.

EXEMPLE 4

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path C:\Temp\PackageUpdateInfo.xml -Encoding utf8

Exporte les données actuelles vers un fichier XML personnalisé en utilisant l’encodage UTF-8.

PARAMÈTRES

-Append

Ajoute les informations exportées à un fichier existant au lieu de remplacer son contenu actuel.
Cela est pris en charge pour les sorties JSON et CSV et ignoré pour la sortie XML.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Confirm

Si ce commutateur est activé, une confirmation vous sera demandée avant d’exécuter toute opération modifiant l’état.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

L’encodage du fichier à utiliser lors de la création ou de la mise à jour du fichier d’export.

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Crée le répertoire parent pour le fichier cible s’il n’existe pas déjà et si le chemin spécifié est en dehors de l’emplacement par défaut.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeTimeStamp

Ajoute une propriété TimeStamp à chaque enregistrement exporté afin que l’export capture l’heure d’exportation pour chaque entrée.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Un ou plusieurs objets PackageUpdateInfo à exporter.
Ce paramètre accepte l’entrée par pipeline depuis Get-PackageUpdateInfo et des commandes similaires.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OutputFormat

Le format de sortie utilisé pour l’export.
Les valeurs prises en charge sont “XML”, “JSON” et “CSV”.

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Envoie les objets exportés dans le pipeline après les avoir écrits sur le disque.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Le chemin du fichier de destination pour les données exportées.
Spécifiez un chemin de fichier plutôt qu’un chemin de répertoire.

La valeur par défaut du chemin est :
Linux : “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml”
Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée, mais des messages d’information sont affichés pour expliquer ce qui se passerait si la commande était exécutée.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

ENTRÉES

PackageUpdate.Info[]

SORTIES

PackageUpdate.Info

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Export

LIENS CONNEXES

4.3 - Get-PackageUpdateInfo

SYNOPSIS

Récupère les informations de mise à jour pour les modules PowerShell installés et identifie les modules pour lesquels des versions plus récentes sont disponibles en ligne.

SYNTAXE

DefaultSet1 (Par défaut)

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-Force] [<CommonParameters>]

CurrentUser

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Get-PackageUpdateInfo inspecte les modules PowerShell installés localement, compare leurs versions installées avec celles disponibles dans un ou plusieurs dépôts configurés, et renvoie des informations détaillées sur les mises à jour.

La commande peut filtrer les résultats pour ne montrer que les modules nécessitant une mise à jour, restreindre la recherche aux chemins des modules de l’utilisateur courant ou de tous les utilisateurs, et afficher éventuellement des notifications toast Windows lorsque des mises à jour sont disponibles.

Elle respecte également les règles de vérification des mises à jour du module et l’intervalle de vérification configuré, sauf si vous forcez explicitement une vérification fraîche.

La vérification est effectuée via PowerShellGet v2 ou v3, selon la disponibilité du module Microsoft.PowerShell.PSResourceGet sur le système.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateInfo

Récupère les informations de mise à jour pour tous les modules découverts à partir des règles d’inclusion configurées et des dépôts disponibles.
La sortie affiche la version installée, la dernière version en ligne, et si une mise à jour est nécessaire.
La sortie peut ressembler à :

Name Repository VersionInstalled VersionOnline NeedUpdate Path

PSReadline PSGallery 1.2 1.2 False C:\Program Files\WindowsPowerShell\Modules\PSReadline
Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

EXEMPLE 2

PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Retourne uniquement les modules pour lesquels une version plus récente est disponible en ligne, facilitant ainsi la concentration sur les modules nécessitant réellement une attention.
Cela filtre la sortie pour ne montrer que les modules où NeedUpdate est True.
La sortie peut ressembler à :

Name Repository VersionInstalled VersionOnline NeedUpdate Path

Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

EXEMPLE 3

PS C:\> "Pester", "PSReadline" | Get-PackageUpdateInfo

Accepte les noms de modules depuis le pipeline et retourne les informations de mise à jour pour chaque module demandé. Cela fonctionne aussi avec des objets exposant une propriété Name, comme les modules retournés par Get-Module.

EXEMPLE 4

PS C:\> Get-PackageUpdateInfo -CurrentUser -ShowOnlyNeededUpdate

Vérifie uniquement les modules installés dans le profil de l’utilisateur courant et affiche uniquement ceux qui ont une version plus récente disponible en ligne.

PARAMÈTRES

-AllUsers

Restreint la recherche aux modules installés dans les emplacements partagés pour tous les utilisateurs ou système.

Gardez à l’esprit que des droits administrateur sont nécessaires pour mettre à jour ces modules.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: AllUsers
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-CurrentUser

Restreint la recherche aux modules installés dans le profil de l’utilisateur courant.

C’est utile si vous travaillez sans droits administrateur, ce qui devrait toujours être votre préférence par défaut.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: CurrentUser
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Ignore l’intervalle de vérification des mises à jour configuré et effectue immédiatement une comparaison fraîche.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Name

Un ou plusieurs noms de modules à inspecter.
Lorsque ce paramètre est omis, la fonction utilise les règles d’inclusion configurées pour déterminer quels modules doivent être vérifiés.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Repository

Un ou plusieurs dépôts PowerShell à interroger pour les versions disponibles des modules.
Si omis, la commande utilise les dépôts disponibles sur le système local.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowOnlyNeededUpdate

Supprime de la sortie les modules déjà à jour et ne retourne que ceux pour lesquels une mise à jour est disponible.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Affiche des notifications toast Windows pour les modules ayant des mises à jour disponibles lorsque le système supporte cette fonctionnalité.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet supporte les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

ENTRÉES

System.String[]

SORTIES

PackageUpdate.Info

NOTES

Version : 1.2.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module

LIENS CONNEXES

4.4 - Get-PackageUpdateRule

SYNOPSIS

Récupère une ou plusieurs règles de mise à jour de package utilisées pour contrôler les vérifications et rapports de mise à jour des modules.

SYNTAXE

ShowAll (Par défaut)

Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
 [-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]

ById

Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Récupère les règles personnalisées qui définissent comment les modules sont gérés lors des vérifications et rapports de mise à jour.
Vous pouvez filtrer les règles par identifiant, par motifs d’inclusion ou d’exclusion de modules, ou inclure la règle par défaut
depuis l’objet de paramètres actif pour comparer le comportement personnalisé avec le comportement de secours intégré.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateRule

Récupère toutes les règles personnalisées actuellement configurées pour la gestion des mises à jour de packages.

EXEMPLE 2

PS C:\> Get-PackageUpdateRule -Id 1, 2

Récupère les règles personnalisées qui ont les identifiants spécifiés.

EXEMPLE 3

PS C:\> Get-PackageUpdateRule -ExcludeModuleFromChecking 'Pester'

Récupère les règles personnalisées qui excluent Pester des vérifications de mise à jour.

EXEMPLE 4

PS C:\> Get-PackageUpdateRule -IncludeModuleForChecking 'PackageManagement' -IncludeDefaultRule

Récupère les règles personnalisées qui incluent PackageManagement pour la vérification des mises à jour et retourne aussi la règle par défaut.

PARAMÈTRES

-ExcludeModuleFromChecking

Filtre les règles retournées pour celles qui excluent le nom de module spécifié des vérifications de mise à jour.

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Spécifie un ou plusieurs identifiants de règles à récupérer.

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeDefaultRule

Ajoute la règle par défaut depuis l’objet de paramètres fourni ou actif à la sortie en plus des règles personnalisées.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Filtre les règles retournées pour celles qui incluent le nom de module spécifié pour la vérification des mises à jour.
Par défaut, tous les modules sont inclus lorsqu’aucun filtre n’est fourni.

La valeur par défaut est : “*”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Spécifie un objet de paramètres retourné par Get-PackageUpdateSetting.
Si ce paramètre est omis, la commande utilise l’objet de paramètres de module courant.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

ENTRÉES

System.Int32[]

PackageUpdate.Configuration

SORTIES

PackageUpdate.ModuleRule

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Rule

LIENS CONNEXES

4.5 - Get-PackageUpdateSetting

SYNOPSIS

Récupère la configuration PackageUpdateInfo depuis le fichier de paramètres du module.

SYNTAX

__AllParameterSets

Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]

ALIASES

Cette cmdlet ne possède pas d’alias.

DESCRIPTION

Lit le fichier de configuration PackageUpdateInfo et renvoie les paramètres actuels du comportement du module sous forme d’un objet PackageUpdate.Configuration.
L’objet retourné inclut les règles de mise à jour par défaut et personnalisées, l’intervalle de vérification des mises à jour, ainsi que les horodatages des dernières vérifications et des dernières vérifications réussies.

EXAMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateSetting

Récupère les paramètres actuels de PackageUpdateInfo depuis le fichier de configuration par défaut.

EXEMPLE 2

PS C:\> Get-PackageUpdateSetting -Path "C:\temp\PackageUpdateInfo.json"

Lit la configuration PackageUpdateInfo depuis un fichier de paramètres spécifique.

EXEMPLE 3

PS C:\> Get-PackageUpdateSetting | Select-Object -ExpandProperty UpdateCheckInterval

Renvoie l’intervalle de vérification des mises à jour configuré dans les paramètres actuels.

PARAMETERS

-Path

Le chemin complet vers le fichier de paramètres à lire.

Ce paramètre est optionnel.
S’il est omis, la fonction utilise le chemin de paramètres par défaut du module :
Linux : “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).json”
Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”

Type: String
DefaultValue: $script:ModuleSettingPath
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

OUTPUTS

PackageUpdate.Configuration

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Paramètre

4.6 - Import-PackageUpdateInfo

SYNOPSIS

Importe les informations de mise à jour des packages à partir d’un fichier de données précédemment exporté.

SYNTAXE

__AllParameterSets

Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
 [-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Cette cmdlet possède les alias suivants,

DESCRIPTION

Importe les informations de mise à jour des packages à partir d’un fichier de données qui a été précédemment exporté par Export-PackageUpdateInfo. La commande lit les enregistrements à partir de fichiers XML, JSON ou CSV et les convertit en objets PackageUpdateInfo pour une utilisation, un affichage ou un traitement ultérieur. Sur demande, elle peut également afficher des notifications toast Windows pour les modules nécessitant une mise à jour.

EXEMPLES

EXEMPLE 1

PS C:\> Import-PackageUpdateInfo

Importe le fichier d’informations de mise à jour des packages par défaut pour l’environnement PowerShell actuel.

EXEMPLE 2

PS C:\> Import-PackageUpdateInfo -Path C:\temp\packageupdateinfo.xml

Importe les informations de mise à jour à partir d’un fichier XML spécifique.

EXEMPLE 3

PS C:\> Import-PackageUpdateInfo -Path .\updates.json -InputFormat JSON

Importe les informations de mise à jour à partir d’un fichier JSON en utilisant le format d’entrée spécifié.

EXEMPLE 4

PS C:\> Import-PackageUpdateInfo -Path .\updates.csv -InputFormat CSV -ShowToastNotification

Importe les informations de mise à jour à partir d’un fichier CSV et affiche des notifications toast pour les modules nécessitant une mise à jour.

PARAMÈTRES

-Confirm

Si ce commutateur est activé, une confirmation vous sera demandée avant d’exécuter toute opération modifiant l’état.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

Spécifie l’encodage du fichier utilisé lors de la lecture du fichier d’entrée.

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputFormat

Spécifie le format du fichier de données importé. Les valeurs prises en charge sont “XML”, “JSON” et “CSV”.

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Le chemin du fichier de données à importer. Spécifiez un chemin de fichier valide. Si omis, la commande utilise le fichier de données du module par défaut pour l’édition et la version PowerShell en cours.

Les chemins par défaut sont : Linux : “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Affiche des notifications toast Windows avec les informations des notes de version pour les modules nécessitant une mise à jour.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée mais des messages d’information seront affichés pour expliquer ce qui se passerait si la commande était exécutée.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir about_CommonParameters.

ENTRÉES

System.String

SORTIES

PackageUpdate.Info

NOTES

Version : 1.1.0.0 Auteur : Andi Bellstedt Date : 2026-06-21 Mots-clés : PackageUpdateInfo, Update, Module, Info

LIENS ASSOCIÉS

4.7 - Remove-PackageUpdateRule

SYNOPSIS

Supprime une ou plusieurs règles personnalisées de gestion des mises à jour de la configuration des mises à jour de packages.

SYNTAXE

ParId (Par défaut)

Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

ParObjetEntrée

Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
 [-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Supprime les règles personnalisées existantes qui définissent comment certains modules PowerShell doivent être gérés lors des vérifications et rapports de mise à jour.
La commande peut supprimer des règles par identifiant de règle, en transmettant des objets règle depuis Get-PackageUpdateRule,
ou en mettant à jour un objet de configuration contenant la collection de règles.

Lorsque des règles sont supprimées, la configuration mise à jour est réécrite dans le fichier de paramètres pour que la modification soit persistante.
Utilisez -PassThru pour renvoyer les objets règle supprimés dans le pipeline.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule

Supprime toutes les règles personnalisées de mise à jour des paramètres du module courant.

EXEMPLE 2

PS C:\> Remove-PackageUpdateRule -Id 12

Supprime la règle personnalisée avec l’Id 12 de la configuration courante.

EXEMPLE 3

$rules = Get-PackageUpdateRule -Name "Microsoft.PowerShell.Utility"
PS C:\> $rules | Remove-PackageUpdateRule -PassThru

Supprime les règles correspondantes et renvoie les objets règle supprimés dans le pipeline.

EXEMPLE 4

$settings = Get-PackageUpdateSetting
PS C:\> Remove-PackageUpdateRule -Id 3 -SettingObject $settings -Force

Supprime une règle spécifique sans demander de confirmation et écrit les paramètres mis à jour sur le disque.

PARAMÈTRES

-Confirm

Si ce commutateur est activé, une confirmation vous sera demandée avant d’exécuter toute opération modifiant l’état.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Supprime la demande de confirmation et supprime la règle immédiatement.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

L’identifiant de la règle à supprimer.
Accepte un ou plusieurs identifiants de règles.

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Un ou plusieurs objets règle à supprimer.
Ceux-ci sont généralement retournés par Get-PackageUpdateRule.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Renvoie l’objet ou les objets règle supprimés dans le pipeline pour un traitement ultérieur.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

L’objet de configuration contenant la collection de règles.
Si ce paramètre n’est pas fourni, la commande utilise les paramètres du module courant obtenus avec Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée mais des messages d’information expliquent ce qui se passerait si la commande était exécutée.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

ENTRÉES

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

SORTIES

PackageUpdate.ModuleRule

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Règle

LIENS CONNEXES

4.8 - Set-PackageUpdateRule

SYNOPSIS

Met à jour une règle PackageUpdateInfo existante qui contrôle la manière dont les changements de version des modules sont signalés.

SYNTAXE

ParId (Par défaut)

Set-PackageUpdateRule -Id <int> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ParObjetEntrée

Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Cette cmdlet possède les alias suivants,

DESCRIPTION

Cette cmdlet modifie une règle de mise à jour existante stockée dans la configuration PackageUpdateInfo afin que les vérifications de mise à jour puissent être restreintes ou élargies pour des modules spécifiques.
Tu peux l’utiliser pour inclure ou exclure des modules de la détection de mise à jour, contrôler quelles parties de la version déclenchent un rapport de mise à jour, et enregistrer ces modifications de règle dans le fichier de paramètres actif.
La commande fonctionne avec une règle identifiée par Id ou avec un objet règle fourni via InputObject, et elle peut retourner la règle mise à jour lorsque -PassThru est spécifié.

EXEMPLES

EXEMPLE 1

PS C:\> Set-PackageUpdateRule -Id 3 -IncludeModuleForChecking 'MyModule' -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false -PassThru

Met à jour la règle 3 pour que MyModule soit évalué explicitement et que seuls les changements majeurs, mineurs et de build soient signalés comme nécessitant une mise à jour.

EXEMPLE 2

PS C:\> Get-PackageUpdateRule -Id 7 | Set-PackageUpdateRule -ExcludeModuleFromChecking 'AzureTools' -ReportChangeOnRevision $false

Prend la règle avec l’Id 7 depuis le pipeline et supprime la notification de mise à jour basée sur la révision pour AzureTools tout en conservant la règle dans les paramètres actuels.

EXEMPLE 3

$rule = Get-PackageUpdateRule -Id 12
PS C:\> Set-PackageUpdateRule -InputObject $rule -IncludeModuleForChecking 'PowershellGet','PSReadLine' -ReportChangeOnMinor $false -ReportChangeOnBuild $false

Charge un objet règle existant, étend les modules inclus, et met à jour la règle pour que seuls les changements majeurs et de révision soient considérés comme des mises à jour à traiter.

EXEMPLE 4

PS C:\> Set-PackageUpdateRule -Id 5 -ReportChangeOnMajor $false -ReportChangeOnMinor $false -ReportChangeOnBuild $false -ReportChangeOnRevision $true -WhatIf

Montre l’effet de changer la règle 5 pour ne signaler que les mises à jour basées sur la révision sans réellement écrire la modification sur le disque.

PARAMÈTRES

-Confirm

Demande une confirmation avant que la cmdlet écrive les données de règle modifiées dans le fichier de paramètres.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Un ou plusieurs noms de modules qui doivent être exclus des vérifications de mise à jour pour la règle modifiée.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

L’identifiant numérique de la règle à modifier.

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Un ou plusieurs noms de modules qui doivent être inclus dans les vérifications de mise à jour pour la règle modifiée.
Lorsqu’il est omis, la règle conserve le comportement par défaut d’évaluer tous les modules.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

L’objet règle à mettre à jour.
Utile lorsque tu as déjà une règle obtenue via Get-PackageUpdateRule et que tu souhaites la modifier sans faire référence à son Id.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Retourne l’objet règle mis à jour dans le pipeline après que la modification a été écrite dans le fichier de paramètres.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Contrôle si un changement dans la partie version build fait que la règle signale qu’une mise à jour est nécessaire.

Signaler quand la version build change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale la nécessité d’une mise à jour,
uniquement lorsque la version build d’un module change.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Contrôle si un changement dans la partie version majeure fait que la règle signale qu’une mise à jour est nécessaire.

Signaler quand la version majeure change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale la nécessité d’une mise à jour,
uniquement lorsque la version majeure d’un module change.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Contrôle si un changement dans la partie version mineure fait que la règle signale qu’une mise à jour est nécessaire.

Signaler quand la version mineure change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale la nécessité d’une mise à jour,
uniquement lorsque la version mineure d’un module change.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Contrôle si un changement dans la partie version révision fait que la règle signale qu’une mise à jour est nécessaire.

Signaler quand la partie révision change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale la nécessité d’une mise à jour,
uniquement lorsque la version révision d’un module change.

Major Minor Build Revision

0 0 0 1

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

L’objet de configuration PackageUpdateInfo à mettre à jour.
Lorsqu’il est omis, la cmdlet utilise les paramètres actuels du module obtenus via Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Montre ce qui se passerait si la commande était exécutée sans appliquer de modifications.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Paramètres communs

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

ENTRÉES

System.Int32

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

SORTIES

PackageUpdate.ModuleRule

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Règle

LIENS CONNEXES

4.9 - Set-PackageUpdateSetting

SYNOPSIS

Configure le comportement de vérification des mises à jour et les préférences de rapport pour PackageUpdateInfo.

SYNTAX

SetBehaviour

Set-PackageUpdateSetting [-ExcludeModuleFromChecking <string[]>]
 [-IncludeModuleForChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-UpdateCheckInterval <timespan>]
 [-LastCheck <datetime>] [-LastSuccessfulCheck <datetime>] [-InputObject <Configuration>]
 [-Path <string>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ResetBehaviour

Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Configure la manière dont PackageUpdateInfo évalue les modules PowerShell installés pour détecter les mises à jour disponibles.
Utilise cette commande pour contrôler quels modules sont inclus ou exclus des vérifications de mise à jour,
décider quels changements de version doivent déclencher des notifications de mise à jour, définir la fréquence des vérifications,
et réinitialiser les paramètres enregistrés à leurs valeurs par défaut.
La configuration est sauvegardée dans un fichier JSON et peut être appliquée directement ou en passant un objet de configuration existant.

EXAMPLES

EXEMPLE 1

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "MyLocalOnlyModule"

Place le module “MyLocalOnlyModule” dans la liste d’exclusion pour la vérification des mises à jour.
Par conception, cela doit être utilisé uniquement pour les modules non disponibles dans une galerie en ligne.
Cette fonctionnalité est conçue pour éviter des vérifications inutiles pour des modules qui n’existent pas dans une galerie en ligne.

Tu ne recevras plus aucune information de mise à jour pour le module ‘MyLocalOnlyModule’ !

Si tu as des inquiétudes ou problèmes de performance dus à un grand nombre de modules installés, il est préférable de mettre le mécanisme de vérification dans ton PSProfile comme une tâche lancée à chaque démarrage de shell.
Cette pratique est décrite dans la section ‘practical-usage’ de la page GitHub du projet :
https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

EXEMPLE 2

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "Az.*"

Place tous les modules Az. dans la liste d’exclusion pour la vérification des mises à jour.
Ceci est considéré comme une mauvaise pratique, car tu ne recevras plus aucune information de mise à jour pour tous les modules Az.
(Et ils peuvent changer assez souvent)

Si tu as des inquiétudes ou problèmes de performance dus à un grand nombre de modules installés, il est préférable de mettre le mécanisme de vérification dans ton PSProfile comme une tâche lancée à chaque démarrage de shell.
Cette pratique est décrite dans la section ‘practical-usage’ de la page GitHub du projet :
https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

EXEMPLE 3

PS C:\> Set-PackageUpdateSetting -IncludeModuleForChecking "*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $true -UpdateCheckInterval "01:00:00"

Restaure le comportement par défaut de la vérification des mises à jour et les seuils de notification tout en conservant l’intervalle de vérification configuré à une heure.

EXEMPLE 4

PS C:\> Set-PackageUpdateSetting -Reset

Réinitialise les paramètres de mise à jour des packages aux valeurs par défaut intégrées.

EXEMPLE 5

PS C:\> Get-PackageUpdateSetting | Set-PackageUpdateSetting -PassThru

Met à jour l’objet de configuration actuel en mémoire et le renvoie dans le pipeline pour un traitement ultérieur.

PARAMETERS

-Confirm

Demande une confirmation avant d’exécuter toute opération modifiant l’état.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Noms des modules à exclure de la vérification des mises à jour dans la règle par défaut.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Noms des modules à inclure dans la vérification des mises à jour dans la règle par défaut.
Par défaut, tous les modules sont inclus.

Valeur par défaut : “*”

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Un objet de configuration retourné par Get-PackageUpdateSetting qui doit être mis à jour en place.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastCheck

Horodatage du début du dernier cycle de vérification des mises à jour des modules.

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastSuccessfulCheck

Horodatage de la dernière vérification des mises à jour des modules terminée avec succès.

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Renvoie l’objet de paramètres mis à jour dans le pipeline pour un traitement ultérieur.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Chemin complet vers le fichier de paramètres à lire ou écrire.

Si ce paramètre est omis, la commande utilise le chemin de paramètres par défaut du module :
Linux : “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateSetting_$($PSEdition)$($PSVersionTable.PSVersion.Major).json”
Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateSetting$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Indique si un changement dans la version de build d’un module doit déclencher une notification de mise à jour dans la règle par défaut.

Cela signifie que Get-PackageUpdateSetting signale un besoin de mise à jour uniquement lorsque le numéro de version de build d’un module change.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Indique si un changement dans la version majeure d’un module doit déclencher une notification de mise à jour dans la règle par défaut.

Cela signifie que Get-PackageUpdateSetting signale un besoin de mise à jour uniquement lorsque le numéro de version majeure d’un module change.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Indique si un changement dans la version mineure d’un module doit déclencher une notification de mise à jour dans la règle par défaut.

Cela signifie que Get-PackageUpdateSetting signale un besoin de mise à jour uniquement lorsque le numéro de version mineure d’un module change.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Indique si un changement dans la partie révision de la version d’un module doit déclencher une notification de mise à jour dans la règle par défaut.

Cela signifie que Get-PackageUpdateSetting signale un besoin de mise à jour uniquement lorsque le numéro de révision d’un module change.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Reset

Réinitialise la configuration du module à son comportement par défaut.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ResetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-UpdateCheckInterval

La durée minimale qui doit s’écouler avant qu’une nouvelle vérification de mise à jour du module soit effectuée.

Valeur par défaut : “01:00:00”

Type: TimeSpan
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Montre ce qui se passerait si la commande était exécutée sans effectuer de modifications réelles.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.Configuration

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Setting

4.10 - Show-PackageUpdateReleaseNote

SYNOPSIS

Affiche les notes de version pour un ou plusieurs modules PowerShell.

SYNTAXE

Par objet PackageUpdateInfo

Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Par objet Module

Show-PackageUpdateReleaseNote [[-Module] <PSModuleInfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Récupère et affiche les notes de version pour les objets d’information de module produits par Get-PackageUpdateInfo ou Import-PackageUpdateInfo, ou pour les objets module retournés par Get-Module.
Lorsque les notes de version sont disponibles sous forme d’URL, la cmdlet tente de résoudre et récupérer le contenu afin que les notes puissent être présentées directement à l’appelant.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote

Récupère les notes de version pour chaque module retourné par Get-PackageUpdateInfo.

EXEMPLE 2

PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote

Récupère les notes de version pour le module PackageUpdateInfo de la session PowerShell en cours.

EXEMPLE 3

PS C:\> Get-PackageUpdateInfo -Name PackageUpdateInfo | Show-PackageUpdateReleaseNote

Affiche les notes de version pour un module spécifique en utilisant la sortie de Get-PackageUpdateInfo.

EXEMPLE 4

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote -WhatIf

Montre quels modules seraient traités pour la récupération des notes de version sans exécuter l’opération.

PARAMÈTRES

-Confirm

Si ce commutateur est activé, une confirmation vous sera demandée avant d’exécuter toute opération modifiant l’état.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Un ou plusieurs objets PackageUpdateInfo provenant de Get-PackageUpdateInfo ou Import-PackageUpdateInfo contenant les informations des notes de version.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Input
ParameterSets:
- Name: ByPackageUpdateInfoObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Module

Un ou plusieurs objets module provenant de Get-Module contenant les métadonnées des notes de version ou une URL vers les notes de version.

Type: PSModuleInfo[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ModuleName
ParameterSets:
- Name: ByModuleObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée mais des messages d’information seront affichés pour expliquer ce qui se passerait si la commande était exécutée.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d’informations, voir
about_CommonParameters.

ENTRÉES

PackageUpdate.Info[]

System.Management.Automation.PSModuleInfo[]

SORTIES

PackageUpdate.ReleaseNote

NOTES

Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Note de version

LIENS CONNEXES