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

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

SYNTAX

__AllParameterSets

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

ALIASES

Ce cmdlet possède les alias suivants,

DESCRIPTION

Cette commande permet de déclarer comment un module est géré dans le reporting pour des cas particuliers.

Par exemple, vous pouvez configurer PackageUpdateInfo pour supprimer les notifications de mise à 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”.

EXAMPLES

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 concernant les mises à jour de révision du module

PARAMÈTRES

-Confirm

Si cet interrupteur 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 de modules à exclure de la vérification de mise à 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 du 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 de modules à inclure dans la vérification de mise à jour Par défaut, tous les modules sont inclus.

Valeur par défaut : “*”

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 analysé 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 de build change pour un module

Cela signifie que le rapport ‘Get-PackageUpdateSetting’ doit être mis à jour, lorsque la version de 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 change pour un module

Cela signifie que le rapport ‘Get-PackageUpdateSetting’ doit être mis à 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

Signaler lorsque la version mineure change pour un module

Cela signifie que le rapport ‘Get-PackageUpdateSetting’ doit être mis à 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

Signaler lorsque la partie révision change pour un module

Cela signifie que le rapport ‘Get-PackageUpdateSetting’ doit être mis à jour, 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 analysé à partir de la commande Get-PackageUpdateSetting C’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: (All)
  Position: 7
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si cet interrupteur est activé, aucune action ne sera effectuée, mais des messages d’information seront 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

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

PackageUpdate.Configuration

SORTIES

PackageUpdate.ModuleRule

4.2 - Export-PackageUpdateInfo

SYNOPSIS

Exporter PackageUpdateInfo vers un fichier de données

SYNTAX

__AllParameterSets

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

ALIASES

Ce cmdlet possède les alias suivants,

DESCRIPTION

Exporter PackageUpdateInfo vers un fichier de données

EXAMPLES

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 à la suite.

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 cette option est activée, 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: ''

-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 du fichier n’est pas présent, mais qu’un autre répertoire que le 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

L’objet 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 envoyés 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 infos.
Veuillez spécifier un fichier en tant que chemin.

La valeur par défaut du chemin est :
Linux : “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo.xml”
Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.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 cette option est activée, aucune action ne sera effectuée, mais des messages d’information seront 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

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.

INPUTS

PackageUpdate.Info[]

OUTPUTS

PackageUpdate.Info

4.3 - Get-PackageUpdateInfo

SYNOPSIS

Obtenez des informations sur la mise à jour pour les 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>]

ALIAS

Ce 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 mise à jour

EXEMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateInfo

Affiche les informations de mise à jour pour tous les modules (currentUser et AllUsers). Le résultat peut ressembler à :

Nom Dépôt VersionInstallée VersionEnLigne BesoinDeMiseAJour Chemin

PSReadline PSGallery 1.2 1.2 Faux C:\Program Files\WindowsPowerShell\Modules\PSReadline Pester PSGallery 4.4.0 4.4.2 Vrai C:\Program Files\WindowsPowerShell\Modules\Pester

EXEMPLE 2

PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Cela filtrera la sortie pour n’afficher que les modules où NeedUpdate est Vrai. Le résultat peut ressembler à :

Nom Dépôt VersionInstallée VersionEnLigne BesoinDeMiseAJour Chemin

Pester PSGallery 4.4.0 4.4.2 Vrai C:\Program Files\WindowsPowerShell\Modules\Pester

EXEMPLE 3

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

Le pipeline est supporté. Cela retourne les infos 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

Ne rechercher que dans les modules situés dans les répertoires AllUsers/system. N’oublie pas 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

Ne rechercher que dans le profil utilisateur actuel. C’est utile si tu exécutes sans droits administrateur, ce qui est recommandé 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

Forcer la requête d’informations sur la mise à jour des modules installés, même si l’intervalle de vérification de mise à jour 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 belles notifications Windows-Toast 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

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

ById

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

INPUTS

System.Int32[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

4.5 - Get-PackageUpdateSetting

SYNOPSIS

Configurer les paramètres de comportement pour le module PackageUpdateInfo

SYNTAX

__AllParameterSets

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

ALIASES

Ce cmdlet possède les alias suivants,

DESCRIPTION

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

EXAMPLES

EXEMPLE 1

PS C:\> Get-PackageUpdateSetting

Obtenez les paramètres actuels concernant le comportement de PackageUpdateInfo.

PARAMETERS

-Path

Le chemin du fichier de configuration

Ceci est optionnel, la valeur par défaut du chemin est : Linux : “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo.xml”) Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml”)

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

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.

OUTPUTS

PackageUpdate.Configuration

4.6 - Import-PackageUpdateInfo

SYNOPSIS

Importer PackageUpdateInfo depuis un fichier de données

SYNTAXE

__AllParameterSets

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

ALIAS

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.

EXEMPLES

EXEMPLE 1

PS C:\> Import-PackageUpdateInfo

Essaye d’importer le fichier par défaut “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.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.

Valeur par défaut du chemin :
Linux : “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo.xml”
Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.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 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.String

SORTIES

PackageUpdate.Info

4.7 - Remove-PackageUpdateRule

SYNOPSIS

supprime la ou les règles pour vérifier et signaler les modules installés

SYNTAXE

ParId (par défaut)

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

ParObjetEntrée

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 sur la manière dont un module est géré 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é, 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: ''

-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 de paramètres transmis par la commande Get-PackageUpdateSetting
Ce paramètre est optionnel

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

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

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 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, de sorte 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: 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 lorsqu’une 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 lorsqu’une 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 lorsqu’une 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 lorsqu’une partie de la 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

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

-SettingObject

Objet de paramètres passé 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 seront 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: ''

ParamètresCommuns

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 la vérification et le rapport sur la mise à jour des modules installés

EXAMPLES

EXEMPLE 1

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

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

EXEMPLE 2

PS C:\> Set-PackageUpdateSetting -Reset

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

PARAMETERS

-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 de mise à 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 de mise à 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 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

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ù les paramètres sont stockés

Ce paramètre est optionnel, la valeur par défaut du chemin est :
Linux : “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateSetting.xml”)
Windows : “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateSetting.xml”)

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 un changement lorsque la version de build d’un module change dans la règle par défaut

Cela signifie que ‘Get-PackageUpdateSetting’ signale un besoin de 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 un changement lorsque la version majeure d’un module change dans la règle par défaut

Cela signifie que ‘Get-PackageUpdateSetting’ signale un besoin de 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 un changement lorsque la version mineure d’un module change dans la règle par défaut

Cela signifie que ‘Get-PackageUpdateSetting’ signale un besoin de 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 un changement lorsque la partie révision d’un module change dans la règle par défaut

Cela signifie que ‘Get-PackageUpdateSetting’ signale un besoin de 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éinitialiser 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 de temps qui doit s’écouler avant de faire 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 PackageUpdeInfo

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

Par objet Module

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

ALIAS

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

Obtenir les notes de version à partir des objets PackageUpdateInfo

EXEMPLE 2

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

Obtenir 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: ByPackageUpdeInfoObject
  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