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