Set-PackageUpdateSetting

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /fr/docs/commands/set-packageupdatesetting/index.md.

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

RELATED LINKS

• packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting