Version imprimable multipages. Cliquer ici pour imprimer.

Retour à la version par défaut.

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.

1 - Export-PackageUpdateInfo

SYNTHÈSE

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

ALIAS

Ce 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 à 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 essaiera 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’InfoPackage 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 au pipeline pour 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.

Type: String
DefaultValue: (Join-Path $HOME "AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml")
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.

ENTRÉES

PackageUpdate.Info[]

SORTIES

PackageUpdate.Info

2 - Get-PackageUpdateInfo

SYNTHÈSE

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

SYNTAXE

DefaultSet1 (Par défaut)

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

CurrentUser

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

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-AllUsers] [<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 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 à :

Nom Dépôt VersionInstallée VersionEnLigne BesoinDeMiseÀJour 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. La sortie peut ressembler à :

Nom Dépôt VersionInstallée VersionEnLigne BesoinDeMiseÀJour 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 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: ''

-Name

Le nom du module à vérifier

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (Tous)
  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: (Tous)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowOnlyNeededUpdate

Ce switch supprime de la sortie les modules à jour. Ne montre que les modules nécessitant une mise à jour.

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

Paramètres communs

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

3 - Import-PackageUpdateInfo

SYNTHÈSE

Importer PackageUpdateInfo à partir d’un fichier de données

SYNTAXE

__AllParameterSets

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

ALIAS

Ce cmdlet possède les alias suivants,

DESCRIPTION

Importer PackageUpdateInfo à partir d’un fichier de données précédemment exporté avec la fonction Export-PackageUpdateInfo.

EXEMPLES

EXEMPLE 1

PS C:\> Import-PackageUpdateInfo

Essayez d’importer le fichier par défaut “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml”

PARAMÈTRES

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

-InputFormat

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

-Path

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

Type: String
DefaultValue: (Join-Path $HOME "AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml")
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  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.

ENTRÉES

System.String

SORTIES

PackageUpdate.Info