# Add-PackageUpdateRule LLMS index: [llms.txt](/llms.txt) --- ## 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] ] [[-IncludeModuleForChecking] ] [[-ExcludeModuleFromChecking] ] [[-ReportChangeOnMajor] ] [[-ReportChangeOnMinor] ] [[-ReportChangeOnBuild] ] [[-ReportChangeOnRevision] ] [[-SettingObject] ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ## 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 ```powershell 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 ```powershell 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 ```powershell 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 ```powershell 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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. ```yaml 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. ```yaml 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](https://go.microsoft.com/fwlink/?LinkID=113216). ## 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 - [packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule](https://packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule/)