Version imprimable multipages. Cliquer ici pour imprimer.

Retour à la version par défaut.

À propos de cette documentation

Ceci est le site officiel de la documentation pour PackageUpdateInfo, un module PowerShell qui vous aide à rester à jour avec vos modules installés en vérifiant tous les modules PowerShell installés localement et en signalant ceux qui nécessitent une mise à jour.

À propos du module

PackageUpdateInfo est né d’un besoin réel : suivre les mises à jour des modules sur de nombreux modules PowerShell installés est fastidieux et facile à oublier. Ce module comble cette lacune en vérifiant automatiquement tous les modules installés par rapport à la Galerie PowerShell et en présentant une vue d’ensemble claire des mises à jour disponibles.

Principes de conception clés :

  • Multi-plateforme — supporte Windows, Linux et macOS
  • Compatibilité multi-édition — supporte PowerShell Desktop (5.1+) et Core (7.x)
  • Configurabilité — personnalisez les intervalles de vérification des mises à jour, les règles de sensibilité des versions et les exclusions
  • Compatible avec le pipeline — s’intègre naturellement à l’architecture de pipeline de PowerShell
  • Support des notifications — notifications de bureau BurntToast en option sur Windows

Ressources

Contribuer

Les contributions sont les bienvenues. Si vous trouvez des problèmes, des erreurs ou si vous avez des suggestions d’amélioration, n’hésitez pas à ouvrir une issue ou une pull request sur le dépôt GitHub.

1 - Aperçu

PackageUpdateInfo vous aide à garder vos modules PowerShell installés à jour. Il compare les versions des modules locaux avec celles des dépôts en ligne configurés (par exemple PSGallery) et signale lorsqu’une version plus récente est disponible.

Que fait PackageUpdateInfo ?

Le module peut :

  • Interroger les modules installés localement.
  • Découvrir les versions en ligne actuelles.
  • Comparer les versions avec une sensibilité configurable (majeure, mineure, build, révision).
  • Afficher une sortie riche comprenant le dépôt, les notes de version, l’auteur et les liens du projet.
  • Exporter les résultats pour une importation ultérieure et des flux de travail de démarrage rapides.

Pourquoi utiliser PackageUpdateInfo ?

Commodité

  • Identifier rapidement les modules obsolètes sans vérifier manuellement chacun d’eux.
  • Exporter et importer les informations de mise à jour pour une revue hors ligne ou différée.
  • Effectuer des vérifications de mise à jour en arrière-plan.
  • Utiliser des notifications toast optionnelles sur Windows.

Automatisation

  • Programmer des vérifications de mise à jour en utilisant votre profil, des tâches planifiées ou des routines de démarrage.
  • Imposer un intervalle de vérification pour réduire les requêtes inutiles aux dépôts.
  • Maintenir des règles personnalisées par motif de module pour la sensibilité à la mise à jour.
  • Réutiliser les données exportées précédemment pour un démarrage de shell à faible latence.

Flexibilité

  • Inclure ou exclure des motifs de noms de modules.
  • Définir la portée et la priorité des règles avec des règles par défaut et personnalisées.
  • Fonctionne sur Windows, Linux et macOS.
  • Supporte Windows PowerShell 5.1 et PowerShell 7+.

Prérequis

  • Windows PowerShell 5.1 ou PowerShell 7+.
  • PowerShellGet avec accès à votre dépôt cible (par exemple PSGallery).
  • Optionnel : module BurntToast pour les notifications toast sur Windows.

Installation

Installer pour tous les utilisateurs (nécessite des droits administratifs) :

Install-Module PackageUpdateInfo

Installer pour l’utilisateur actuel :

Install-Module PackageUpdateInfo -Scope CurrentUser

Démarrage rapide

Lancer une vérification interactive :

Get-PackageUpdateInfo

Afficher uniquement les modules nécessitant une mise à jour :

Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Forcer une vérification même si l’intervalle de mise à jour configuré n’a pas expiré :

Get-PackageUpdateInfo -Force

Utiliser les notifications toast (Windows avec BurntToast) :

Get-PackageUpdateInfo -ShowToastNotification

Modèle d’automatisation pratique

Exporter les données de mise à jour dans un travail en arrière-plan et les importer au démarrage du shell :

Start-Job -ScriptBlock { Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification | Export-PackageUpdateInfo } | Out-Null
Import-PackageUpdateInfo

Cela maintient le démarrage interactif tout en affichant les informations de mise à jour récentes.

Prochaines étapes

  • Continuer avec les meilleures pratiques opérationnelles pour le réglage, la conception des règles et l’automatisation.
  • Continuer avec le dépannage pour les erreurs courantes et les flux de récupération.

2 - Bonnes pratiques opérationnelles

Cette page décrit les modèles d’exploitation recommandés pour PackageUpdateInfo dans les shells interactifs, profils et automatisations.

Commence avec le comportement par défaut

Réinitialise les paramètres avant d’introduire des réglages personnalisés, surtout sur des systèmes partagés :

Set-PackageUpdateSetting -Reset

Inspecte la configuration et les règles actuelles :

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Utilise des intervalles de mise à jour pour réduire le bruit

Get-PackageUpdateInfo respecte UpdateCheckInterval. Si la dernière vérification effective est encore dans l’intervalle configuré, la cmdlet retourne rapidement.

Définis un intervalle qui correspond à ton environnement :

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Hours 6)

Utilise -Force uniquement pour des vérifications ad-hoc :

Get-PackageUpdateInfo -Force

Préfère un démarrage de shell non bloquant

Un modèle de profil pratique est :

Start-Job -ScriptBlock {
    Get-PackageUpdateInfo -ShowOnlyNeededUpdate | Export-PackageUpdateInfo
} | Out-Null

Import-PackageUpdateInfo

Pourquoi ça fonctionne bien :

  • Le démarrage reste rapide car l’import lit les données en cache.
  • La vérification en ligne coûteuse s’exécute en arrière-plan.
  • Tu obtiens toujours une visibilité utile sur les mises à jour dans chaque session.

Vérifie explicitement la portée quand c’est nécessaire

Utilise les paramètres de portée lorsque les permissions diffèrent entre modules utilisateur et système :

Get-PackageUpdateInfo -CurrentUser
Get-PackageUpdateInfo -AllUsers

Utilise -Repository dans des environnements avec plusieurs dépôts configurés :

Get-PackageUpdateInfo -Repository PSGallery

Conçois soigneusement les règles

Utilise des exclusions larges uniquement si c’est intentionnel. Exclure de grands motifs peut masquer des mises à jour importantes.

Crée des règles personnalisées ciblées pour les modules à forte rotation :

Add-PackageUpdateRule -IncludeModuleForChecking "Az.*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $false -ReportChangeOnRevision $false

Vérifie la priorité des règles en listant toutes :

Get-PackageUpdateRule -IncludeDefaultRule | Sort-Object Id

Utilise l’exportation/importation de façon intentionnelle

Les chemins d’exportation et d’importation par défaut sont spécifiques à la plateforme et incluent l’édition PowerShell et la version majeure dans le nom de fichier. Cela aide à éviter de mélanger des données provenant de différentes versions d’exécution.

Options d’exportation courantes :

Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat XML
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV

Recommandations :

  • Utilise XML si tu veux préserver des objets typés pour une réimportation.
  • Utilise JSON ou CSV pour des rapports externes et intégrations.
  • Utilise -IncludeTimeStamp pour le suivi historique.

Garde les notifications utiles

Utilise les notifications toast uniquement là où elles apportent une valeur ajoutée :

  • Sur des hôtes Windows avec BurntToast installé.
  • Sur des sessions où des alertes interactives sont attendues.

Pour les serveurs, CI, et shells non interactifs, privilégie les rapports exportés plutôt que les notifications toast.

3 - Dépannage

Utilise ce guide lorsque PackageUpdateInfo ne renvoie pas les résultats attendus, saute des vérifications ou échoue lors de l’importation ou de l’exportation de données.

Obtenir d’abord des diagnostics exploitables

Exécute avec une sortie détaillée :

Get-PackageUpdateInfo -Verbose

Valide les paramètres et règles :

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Vérification sautée de manière inattendue

Symptôme :

  • Tu vois un avertissement indiquant que les vérifications de mise à jour sont sautées parce que l’intervalle de vérification n’est pas expiré.

Cause :

  • UpdateCheckInterval et LastCheck récent ou LastSuccessfulCheck empêchent une nouvelle vérification en ligne.

Résolution :

Get-PackageUpdateInfo -Force

Ou réduit l’intervalle :

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Minutes 30)

Le fichier de configuration est manquant ou corrompu

Symptôme :

  • Get-PackageUpdateSetting avertit que le fichier de configuration du module n’a pas été trouvé, puis lance une erreur.

Cause :

  • Le chemin du fichier de configuration n’existe pas ou contient un JSON invalide.

Résolution :

Set-PackageUpdateSetting -Reset
Get-PackageUpdateSetting

Aucun module n’est renvoyé

Symptôme :

  • Get-PackageUpdateInfo ne renvoie rien alors que des modules sont installés.

Causes courantes :

  • Les règles d’inclusion et d’exclusion filtrent tous les modules.
  • -CurrentUser ou -AllUsers filtrent les modules que tu attends.
  • Le filtrage par dépôt exclut les modules pertinents.

Étapes de résolution :

Get-PackageUpdateRule -IncludeDefaultRule
Get-PackageUpdateInfo -Force
Get-PackageUpdateInfo -CurrentUser -Force
Get-PackageUpdateInfo -AllUsers -Force

L’exportation échoue avec des erreurs de chemin

Symptôme :

  • L’exportation signale un problème de chemin ou de répertoire invalide.

Cause :

  • -Path pointe vers un répertoire ou un emplacement inexistant sans -Force.

Résolution :

Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.xml" -Force

L’importation ne renvoie aucune donnée

Symptôme :

  • Import-PackageUpdateInfo ne renvoie rien.

Causes courantes :

  • Le fichier est vide ou trop petit pour contenir des enregistrements.
  • -InputFormat ne correspond pas au format exporté.
  • Mauvais chemin de fichier pour l’exécution et l’édition actuelles.

Résolution :

Import-PackageUpdateInfo -InputFormat XML -Verbose
Import-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.json" -InputFormat JSON

Les notifications Toast ne s’affichent pas

Symptôme :

  • -ShowToastNotification est utilisé, mais aucune notification ne s’affiche.

Causes courantes :

  • BurntToast n’est pas installé.
  • La plateforme hôte ne supporte pas les notifications Toast de Windows.
  • Aucun module dans le résultat n’a NeedUpdate = $true.

Résolution :

Install-Module BurntToast -Scope CurrentUser
Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification -Force

Les règles ne peuvent pas être ajoutées ou modifiées

Symptôme :

  • L’ajout d’une règle échoue avec un Id, include ou exclude en double.

Cause :

  • Des règles personnalisées existantes contiennent déjà les mêmes identifiants ou motifs.

Résolution :

Get-PackageUpdateRule
Add-PackageUpdateRule -IncludeModuleForChecking "MyModule.*"
Set-PackageUpdateRule -Id 1 -ReportChangeOnRevision $false
Remove-PackageUpdateRule -Id 1

Problèmes de dépôt et réseau

Symptôme :

  • La recherche de version en ligne échoue ou est incomplète.

Causes courantes :

  • Le dépôt n’est pas enregistré ou inaccessible.
  • Problèmes temporaires de réseau.

Résolution :

Get-PSRepository
Find-Module PackageUpdateInfo -Repository PSGallery
Get-PackageUpdateInfo -Repository PSGallery -Force

Flux de récupération

Si le comportement reste incohérent, utilise cette séquence de réinitialisation :

Set-PackageUpdateSetting -Reset
Get-PackageUpdateInfo -Force | Export-PackageUpdateInfo
Import-PackageUpdateInfo

4 - Module commands reference

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.

4.1 - Add-PackageUpdateRule

SYNOPSIS

Ajouter une règle pour vérifier et signaler les modules installés

SYNTAXE

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
 [[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
 [[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
 [[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Cette commande permet de déclarer comment un module est géré dans les rapports pour des cas spécifiques.

Par exemple, vous pouvez configurer PackageUpdateInfo pour supprimer les mises à jour de révision sur un module fréquemment mis à jour, afin que seules les mises à jour de build, mineures ou majeures soient signalées comme “mise à jour nécessaire”.

EXEMPLES

EXEMPLE 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Ajoute une nouvelle règle personnalisée pour “MyModule” afin de supprimer les notifications sur les mises à jour de révision du module

PARAMÈTRES

-Confirm

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: ''

-ExcludeModuleFromChecking

Noms des modules à exclure de la vérification des mises à jour

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 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

Noms des modules à inclure dans la vérification des mises à jour
Par défaut, tous les modules sont inclus.

La valeur par défaut est : “*”

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

L’objet règle sera transmis 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: ''

-ReportChangeOnBuild

Signaler lorsque la version build d’un module change

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
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

Signaler lorsque la version majeure d’un module change

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
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

Signaler lorsque la version mineure d’un module change

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
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

Signaler lorsque la partie révision d’un module change

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
lorsque la version de révision d’un module change.

Major Minor Build Revision

1 0 0 0

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

Objet de paramètres transmis depuis la commande Get-PackageUpdateSetting
Ce paramètre est optionnel.
Par défaut, il utilise l’objet de paramètres par défaut du module.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 7
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée, mais des messages d’information s’affichent 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: ''

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

4.2 - Export-PackageUpdateInfo

SYNOPSIS

Exporter PackageUpdateInfo vers un fichier de données

SYNTAXE

__AllParameterSets

Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
 [-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Exporter PackageUpdateInfo vers un fichier de données

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo

Exemple d’utilisation de Export-PackageUpdateInfo

PARAMÈTRES

-Append

Le fichier de sortie ne sera pas remplacé. Toutes les informations seront ajoutées.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Confirm

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: ''

-Encoding

Encodage du fichier

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Si le répertoire pour le fichier n’existe pas, mais qu’un répertoire autre que celui par défaut est spécifié, la fonction tentera de créer le répertoire.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeTimeStamp

Un horodatage sera ajouté aux enregistrements d’informations.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Le PackageUpdateInfo provenant de la fonction Get-PackageUpdateInfo.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OutputFormat

Le format de sortie pour les données. Les formats disponibles sont “XML”, “JSON”, “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: ''

-PassThru

Les objets exportés seront transmis 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

Le chemin du fichier où exporter les informations. Veuillez spécifier un fichier comme chemin.

La valeur par défaut du chemin est : Linux : “$HOME/.local/share/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: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée mais des messages d’information s’affichent 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: ''

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.Info[]

SORTIES

PackageUpdate.Info

4.3 - Get-PackageUpdateInfo

SYNOPSIS

Obtenir des informations sur la mise à jour des modules installés

SYNTAXE

DefaultSet1 (Par défaut)

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-Force] [<CommonParameters>]

CurrentUser

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Get-PackageUpdateInfo interroge les modules installés localement et les compare aux versions en ligne pour vérifier leur actualité

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateInfo

Affiche les informations de mise à jour pour tous les modules (CurrentUser et AllUsers). 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

EXEMPLE 2

PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate

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

EXEMPLE 3

PS C:\> "Pester", "PSReadline" | Get-PackageUpdateInfo

Le pipeline est supporté. Cela retourne les informations uniquement pour les deux modules “Pester” et “PSReadline”.

Cela peut aussi être fait avec la cmdlet Get-Module : Get-Module “Pester”, “PSReadline” | Get-PackageUpdateInfo

PARAMÈTRES

-AllUsers

Cherche uniquement les modules dans les répertoires AllUsers/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: ''

-CurrentUser

Cherche uniquement les modules dans le profil de l’utilisateur courant. C’est utile si vous exécutez sans droits administrateur, ce que vous devriez toujours faire 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: ''

-Force

Force la requête d’informations sur la mise à jour des modules installés, même si l’intervalle UpdateCheckInterval depuis la dernière vérification n’est pas expiré.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Name

Le nom du module à vérifier

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Repository

Le dépôt à vérifier

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowOnlyNeededUpdate

Ce commutateur supprime de la sortie les modules à jour.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Ce commutateur affiche de jolies notifications toast Windows avec les 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: ''

CommonParameters

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.

ENTRÉES

System.String[]

SORTIES

PackageUpdate.Info

4.4 - Get-PackageUpdateRule

SYNOPSIS

Obtenez la ou les règles pour vérifier et rapporter sur les modules installés

SYNTAX

ShowAll (Par défaut)

Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
 [-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]

ParId

Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]

ALIASES

Ce cmdlet possède les alias suivants,

DESCRIPTION

Cette commande récupère la ou les règles personnalisées existantes concernant la gestion des modules dans les rapports.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateRule

Obtenir toutes les règles personnalisées existantes

EXEMPLE 2

PS C:\> Get-PackageUpdateRule -Id 1

Obtenir la règle personnalisée avec l’ID 1

PARAMÈTRES

-ExcludeModuleFromChecking

Noms des modules à exclure de la vérification des mises à 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: ''

-Id

L’ID en tant qu’identifiant pour la règle

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeDefaultRule

Renvoie la règle par défaut du paramètre de configuration, 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: ''

-IncludeModuleForChecking

Noms des modules à inclure dans la vérification des mises à jour
Par défaut, tous les modules sont inclus.

Valeur par défaut : “*”

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: ''

-SettingObject

Objet de paramètres analysé à partir de la commande Get-PackageUpdateSetting
Ceci est un paramètre optionnel.
Par défaut, il utilisera l’objet de paramètres par défaut du module.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (Tous)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Ce 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.

ENTRÉES

System.Int32[]

PackageUpdate.Configuration

SORTIES

PackageUpdate.ModuleRule

4.5 - Get-PackageUpdateSetting

SYNOPSIS

Obtenir les paramètres de comportement pour le module PackageUpdateInfo

SYNTAX

__AllParameterSets

Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Interroger les paramètres de base pour vérifier et rapporter les informations de mise à jour des modules installés

EXAMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateSetting

Obtenir les paramètres actuels du comportement de PackageUpdateInfo.

PARAMETERS

-Path

Le chemin du fichier où se trouve le fichier de paramètres

Ce paramètre est optionnel, la valeur par défaut du chemin est : Linux : “$HOME/.local/share/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: ''

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.

OUTPUTS

PackageUpdate.Configuration

4.6 - Import-PackageUpdateInfo

SYNOPSIS

Importer PackageUpdateInfo depuis un fichier de données

SYNTAX

__AllParameterSets

Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
 [-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Importer PackageUpdateInfo depuis un fichier de données précédemment exporté avec la fonction Export-PackageUpdateInfo.

EXAMPLES

EXEMPLE 1

PS C:\> Import-PackageUpdateInfo

Tente d’importer le fichier par défaut “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo_$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

PARAMÈTRES

-Confirm

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: ''

-Encoding

Encodage du fichier

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputFormat

Le format de sortie des données
Formats disponibles : “XML”, “JSON”, “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: ''

-Path

Le chemin du fichier à importer.
Veuillez spécifier un fichier en tant que chemin.

La valeur par défaut du chemin est :
Linux : “$HOME/.local/share/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: ''

-ShowToastNotification

Ce commutateur affiche de jolies notifications Windows Toast avec les notes de version des 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: ''

-WhatIf

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: ''

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

System.String

SORTIES

PackageUpdate.Info

4.7 - Remove-PackageUpdateRule

SYNOPSIS

Supprime la ou les règles de vérification et de rapport sur les modules installés.

SYNTAXE

ParId (Par défaut)

Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

ParInputObject

Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
 [-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Cette cmdlet possède les alias suivants,

DESCRIPTION

Cette commande supprime la ou les règles personnalisées existantes concernant la gestion d’un module dans les rapports.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule

Supprime toutes les règles personnalisées pour la gestion des mises à jour des modules.

PARAMÈTRES

-Confirm

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: ''

-Force

Si spécifié, l’utilisateur ne sera pas invité à confirmer.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

L’identifiant de la règle à supprimer.

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Objet règle transmis depuis la commande Get-PackageUpdateSetting.
Ce paramètre est obligatoire dans ce jeu de paramètres.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

L’objet règle sera transmis 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: ''

-SettingObject

Objet de paramètres issu de la commande Get-PackageUpdateSetting.
Ce paramètre est optionnel.
Par défaut, il utilise l’objet de paramètres par défaut du module.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée, mais des messages d’information s’affichent 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: ''

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

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

SORTIES

PackageUpdate.ModuleRule

4.8 - Set-PackageUpdateRule

SYNOPSIS

Définir une règle pour vérifier et signaler les modules installé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>]

ParInputObject

Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Cette commande permet de modifier les règles existantes sur la manière dont un module est géré dans les rapports.

Par exemple, vous pouvez configurer PackageUpdateInfo pour supprimer les mises à jour de révision sur un module fréquemment mis à jour, afin que seules les mises à jour de build, mineures ou majeures soient signalées comme “mise à jour nécessaire”.

EXEMPLES

EXEMPLE 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Ajouter une nouvelle règle personnalisée pour “MyModule” afin de supprimer les notifications sur les mises à jour de révision du module

PARAMÈTRES

-Confirm

Si ce commutateur est activé, vous serez invité à confirmer 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

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 de la règle

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

Noms des modules à inclure dans la vérification des mises à jour
Par défaut, tous les modules sont inclus.

La valeur par défaut est : “*”

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 à modifier

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

L’objet règle sera transmis 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: ''

-ReportChangeOnBuild

Signaler quand la version de build change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
lorsque la version de 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

Signaler quand la version majeure change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
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

Signaler quand la version mineure change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
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

Signaler quand la partie révision change pour un module

Cela signifie que ‘Get-PackageUpdateSetting’ signale qu’une mise à jour est nécessaire,
lorsque la version de 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

Objet de paramètres transmis depuis la commande Get-PackageUpdateSetting
C’est un paramètre optionnel.
Par défaut, il utilise l’objet de paramètres par défaut du module.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée mais des messages d’information s’affichent 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: ''

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

4.9 - Set-PackageUpdateSetting

SYNOPSIS

Définir les paramètres de comportement pour le module 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

Set-PackageUpdateInfo configure les paramètres de base pour vérifier et rapporter les informations de mise à jour des modules installés

EXAMPLES

EXEMPLE 1

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "MyLocalOnlyModule"

Ajoute le module “MyLocalOnlyModule” à la liste d’exclusion pour la vérification des mises à jour.
Par conception, cela doit être considéré uniquement pour les modules non disponibles dans une galerie en ligne.
Cette fonctionnalité est conçue pour éviter des vérifications de mise à jour inutiles pour les modules n’existant pas dans une galerie en ligne.

Vous ne recevrez plus aucune information de mise à jour pour le module ‘MyLocalOnlyModule’ !

Si vous avez des inquiétudes ou des problèmes de performance dus à un grand nombre de modules installés, il est préférable de suivre la pratique consistant à placer le mécanisme de vérification dans votre PSProfile en tant que tâche à chaque démarrage d’une session.
Cette méthode est décrite dans la section ‘practical-usage’ de la page du projet GitHub :
https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

EXEMPLE 2

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "Az.*"

Ajoute tous les modules Az. à la liste d’exclusion pour la vérification des mises à jour.
Ceci est à considérer comme une mauvaise pratique, car vous ne recevrez plus aucune information de mise à jour pour tous les modules Az.
(qui peuvent changer assez fréquemment)

Si vous avez des inquiétudes ou des problèmes de performance dus à un grand nombre de modules installés, il est préférable de suivre la pratique consistant à placer le mécanisme de vérification dans votre PSProfile en tant que tâche à chaque démarrage d’une session.
Cette méthode est décrite dans la section ‘practical-usage’ de la page du projet GitHub :
https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

EXEMPLE 3

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking @("") -IncludeModuleForChecking "*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $true -UpdateCheckInterval "01:00:00"

Réinitialise le module à son comportement par défaut

EXEMPLE 4

PS C:\> Set-PackageUpdateSetting -Reset

Réinitialise le module à son comportement par défaut

PARAMETERS

-Confirm

Si ce commutateur est activé, vous serez invité à confirmer 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.

La valeur par défaut est : “*”

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

Objet de paramètres transmis depuis la commande Get-PackageUpdateSetting

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 dernier début de vérification de mise à 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 de mise à jour réussie

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

L’objet de paramètres sera transmis 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 du fichier où le fichier de paramètres est stocké

Ce paramètre est optionnel, la valeur par défaut du chemin est :
Linux : “$HOME/.local/share/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

Signaler lorsqu’une modification de la version de build d’un module est détectée dans la règle par défaut

Cela signifie que ‘Get-PackageUpdateSetting’ signalera la nécessité d’une mise à jour,
lorsque la 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

Signaler lorsqu’une modification majeure de la version d’un module est détectée dans la règle par défaut

Cela signifie que ‘Get-PackageUpdateSetting’ signalera 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: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Signaler lorsqu’une modification mineure de la version d’un module est détectée dans la règle par défaut

Cela signifie que ‘Get-PackageUpdateSetting’ signalera 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: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Signaler lorsqu’une modification de la révision d’un module est détectée dans la règle par défaut

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

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 le 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

Intervalle minimum / durée minimale à respecter avant de refaire une nouvelle vérification de mise à jour des modules

La valeur par défaut est : “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

Si ce commutateur est activé, aucune action n’est effectuée mais des messages d’information s’affichent 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: ''

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

4.10 - Show-PackageUpdateReleaseNote

SYNOPSIS

Afficher les notes de version d’un module

SYNTAXE

Par objet PackageUpdateInfo

Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Par objet Module

Show-PackageUpdateReleaseNote [[-Module] <PSModuleInfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

DESCRIPTION

Afficher les notes de version d’un module.

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote

Récupérer les notes de version à partir des objets PackageUpdateInfo

EXEMPLE 2

PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote

Récupérer les notes de version d’un module

PARAMÈTRES

-Confirm

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: ''

-InputObject

Objet(s) d’entrée provenant de Get-PackageUpdateInfo ou Import-PackageUpdateInfo pour afficher les 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: ''

-Module

Objet(s) d’entrée provenant de Get-Module pour afficher 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: ''

-WhatIf

Si ce commutateur est activé, aucune action n’est effectuée, mais des messages d’information s’affichent 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: ''

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.Info[]

System.Management.Automation.PSModuleInfo[]

SORTIES

PackageUpdate.ReleaseNote