Partager via


Get-InstalledPSResource

Retourne les modules et les scripts installés sur l’ordinateur via PowerShellGet.

Syntaxe

Get-InstalledPSResource
   [[-Name] <String[]>]
   [-Version <String>]
   [-Path <String>]
   [-Scope <ScopeType>]
   [<CommonParameters>]

Description

Cette applet de commande recherche les chemins d’installation du module et du script et retourne des objets PSResourceInfo qui décrivent chaque élément de ressource trouvé. Cela équivaut à la sortie combinée des applets de Get-InstalledModule commande et Get-InstalledScript de PowerShellGet v2.

Exemples

Exemple 1

Cet exemple retourne toutes les versions des modules et scripts installés sur l’ordinateur.

Get-InstalledPSResource

Exemple 2

Cet exemple retourne toutes les versions du module Az installées à l’aide de PowerShellGet.

Get-InstalledPSResource Az

Exemple 3

Cet exemple retourne toutes les versions du module Az installé dans le répertoire actif.

Get-InstalledPSResource Az -Path .

Exemple 4

Cet exemple retourne une version spécifique du module Az s’il est installé sur le système.

Get-InstalledPSResource Az -Version 9.4.0

Exemple 5

Cet exemple retourne toutes les versions installées du module Az dans la plage de versions spécifiée.

Get-InstalledPSResource Az -Version "(1.0.0, 3.0.0)"

Exemple 6

Cet exemple renvoie une version d’aperçu spécifique du module PowerShellGet s’il est installé sur le système.

Get-InstalledPSResource PowerShellGet -Version 3.0.19-beta19

Name          Version Prerelease Repository Description
----          ------- ---------- ---------- -----------
PowerShellGet 3.0.19  beta19     PSGallery  PowerShell module with commands for discovering, installing, updating and p…

Exemple 6

L’exemple précédent a montré que PowerShellGet version 3.0.14-beta14 a été installé sur le système. Cet exemple montre que vous devez fournir la version complète, y compris l’étiquette de préversion pour identifier le module installé par version.

Get-InstalledPSResource PowerShellGet -Version 3.0.19

Il n’existe aucune sortie de cette commande.

Exemple 7

Dans cet exemple, vous voyez que quatre versions de PSReadLine sont installées sur le système. La deuxième commande recherche une plage de version comprise entre 2.2.0 et 2.3.0.

Get-InstalledPSResource PSReadLine

Name       Version Prerelease Repository Description
----       ------- ---------- ---------- -----------
PSReadLine 2.3.0   beta0      PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.6              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.5              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.2              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.0   beta4      PSGallery  Great command line editing in the PowerShell console host

Get-InstalledPSResource PSReadLine -Version '[2.2.0, 2.3.0]'

Name       Version Prerelease Repository Description
----       ------- ---------- ---------- -----------
PSReadLine 2.3.0   beta0      PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.6              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.5              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.2              PSGallery  Great command line editing in the PowerShell console host

Selon les règles de version NuGet, une version préliminaire est inférieure à une version stable, donc 2.2.0-beta4 inférieure à la version dans la 2.2.0 plage de versions spécifiée.

Paramètres

-Name

Nom d’une ressource à rechercher. Les caractères génériques sont pris en charge, mais NuGet accepte uniquement le * caractère. NuGet ne prend pas en charge les recherches génériques dans les référentiels locaux (basés sur des fichiers).

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Path

Spécifie le chemin d’accès dans lequel effectuer une recherche.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Scope

Spécifie l’étendue de la ressource.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valeurs acceptées:CurrentUser, AllUsers
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Version

Spécifie la version de la ressource à retourner. La valeur peut être une version exacte ou une plage de versions à l’aide de la syntaxe de contrôle de version NuGet.

Pour plus d’informations sur les plages de versions NuGet, consultez Gestion des versions de package.

PowerShellGet prend en charge tout sauf la version inclusive minimale répertoriée dans la documentation de la plage de versions NuGet. L’utilisation 1.0.0.0 en tant que version ne génère pas les versions 1.0.0.0 et ultérieures (plage inclusive minimale). Au lieu de cela, la valeur est considérée comme la version requise. Pour rechercher une plage inclusive minimale, utilisez [1.0.0.0, ] comme plage de versions.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

Entrées

String[]

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Notes

Le module définit Get-PSResource comme alias pour Get-InstalledPSResource.