Version imprimable multipages. Cliquer ici pour imprimer.
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.
Ajoute une règle personnalisée qui contrôle la manière dont les mises à jour des modules sont signalées.
Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
[[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
[[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
[[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Cette cmdlet possède les alias suivants,
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.
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.
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.
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éé.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Rule
Exporte des objets PackageUpdateInfo vers un fichier XML, JSON ou CSV.
Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
[-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
[<CommonParameters>]
Cette cmdlet possède les alias suivants,
É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.
PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo
Exporte les objets PackageUpdateInfo actuels vers le fichier XML par défaut.
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.
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.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Export
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.
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-Force] [<CommonParameters>]
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]
Cette cmdlet possède les alias suivants,
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.
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
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
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.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.2.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module
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.
Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
[-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]
Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]
Cette cmdlet possède les alias suivants,
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é.
PS C:\> Get-PackageUpdateRule
Récupère toutes les règles personnalisées actuellement configurées pour la gestion des mises à jour de packages.
PS C:\> Get-PackageUpdateRule -Id 1, 2
Récupère les règles personnalisées qui ont les identifiants spécifiés.
PS C:\> Get-PackageUpdateRule -ExcludeModuleFromChecking 'Pester'
Récupère les règles personnalisées qui excluent Pester des vérifications de mise à jour.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Rule
Récupère la configuration PackageUpdateInfo depuis le fichier de paramètres du module.
Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]
Cette cmdlet ne possède pas d’alias.
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.
PS C:\> Get-PackageUpdateSetting
Récupère les paramètres actuels de PackageUpdateInfo depuis le fichier de configuration par défaut.
PS C:\> Get-PackageUpdateSetting -Path "C:\temp\PackageUpdateInfo.json"
Lit la configuration PackageUpdateInfo depuis un fichier de paramètres spécifique.
PS C:\> Get-PackageUpdateSetting | Select-Object -ExpandProperty UpdateCheckInterval
Renvoie l’intervalle de vérification des mises à jour configuré dans les paramètres actuels.
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Paramètre
Importe les informations de mise à jour des packages à partir d’un fichier de données précédemment exporté.
Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
[-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]
Cette cmdlet possède les alias suivants,
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.
PS C:\> Import-PackageUpdateInfo
Importe le fichier d’informations de mise à jour des packages par défaut pour l’environnement PowerShell actuel.
PS C:\> Import-PackageUpdateInfo -Path C:\temp\packageupdateinfo.xml
Importe les informations de mise à jour à partir d’un fichier XML spécifique.
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é.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0 Auteur : Andi Bellstedt Date : 2026-06-21 Mots-clés : PackageUpdateInfo, Update, Module, Info
Supprime une ou plusieurs règles personnalisées de gestion des mises à jour de la configuration des mises à jour de packages.
Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
[-Confirm] [<CommonParameters>]
Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
[-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]
Cette cmdlet possède les alias suivants,
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.
PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule
Supprime toutes les règles personnalisées de mise à jour des paramètres du module courant.
PS C:\> Remove-PackageUpdateRule -Id 12
Supprime la règle personnalisée avec l’Id 12 de la configuration courante.
$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.
$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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Règle
Met à jour une règle PackageUpdateInfo existante qui contrôle la manière dont les changements de version des modules sont signalés.
Set-PackageUpdateRule -Id <int> [-IncludeModuleForChecking <string[]>]
[-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
[-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
[-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
[-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Cette cmdlet possède les alias suivants,
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é.
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.
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.
$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.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Règle
Configure le comportement de vérification des mises à jour et les préférences de rapport pour PackageUpdateInfo.
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>]
Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
[<CommonParameters>]
Cette cmdlet possède les alias suivants,
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.
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
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
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.
PS C:\> Set-PackageUpdateSetting -Reset
Réinitialise les paramètres de mise à jour des packages aux valeurs par défaut intégrées.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Update, Module, Setting
Affiche les notes de version pour un ou plusieurs modules PowerShell.
Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Show-PackageUpdateReleaseNote [[-Module] <PSModuleInfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Cette cmdlet possède les alias suivants,
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.
PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote
Récupère les notes de version pour chaque module retourné par Get-PackageUpdateInfo.
PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote
Récupère les notes de version pour le module PackageUpdateInfo de la session PowerShell en cours.
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.
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.
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Auteur : Andi Bellstedt
Date : 2026-06-21
Mots-clés : PackageUpdateInfo, Mise à jour, Module, Note de version