Add-PackageUpdateRule
For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /fr/docs/commands/add-packageupdaterule/index.md.
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