Install-PackageProvider
Installe un ou plusieurs fournisseurs de packages De gestion des packages.
Syntax
Install-PackageProvider
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Source <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-PackageProvider
[-Scope <String>]
[-InputObject] <SoftwareIdentity[]>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Install-PackageProvider
de commande installe les fournisseurs de gestion des packages correspondants qui sont disponibles dans les sources de package inscrites auprès de PowerShellGet. Par défaut, cela inclut les modules disponibles dans la galerie Windows PowerShell avec la balise PackageManagement. Le fournisseur De gestion des packages PowerShellGet est utilisé pour rechercher des fournisseurs dans ces référentiels.
Cette applet de commande installe également les fournisseurs de gestion des packages correspondants disponibles à l’aide de l’application de démarrage Gestion des packages.
Cette applet de commande installe également les fournisseurs de gestion des packages correspondants qui sont disponibles dans le magasin d’objets blob Azure Gestion des packages. Utilisez le fournisseur de programme d’amorçage pour les rechercher et les installer.
Pour pouvoir exécuter la première fois, PackageManagement nécessite une connexion Internet pour télécharger le fournisseur de package NuGet. Toutefois, si votre ordinateur ne dispose pas d’une connexion Internet et que vous devez utiliser le fournisseur NuGet ou PowerShellGet, vous pouvez les télécharger sur un autre ordinateur et les copier sur votre ordinateur cible. Utilisez les étapes suivantes pour effectuer cette opération :
- Exécutez
Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force
pour installer le fournisseur à partir d’un ordinateur disposant d’une connexion Internet. - Après l’installation, vous pouvez trouver le fournisseur installé dans
$env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>
ou$env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>
. - Placez le
<ProviderName>
dossier, qui est dans ce cas le dossier NuGet, à l’emplacement correspondant sur votre ordinateur cible. Si votre ordinateur cible est un serveur Nano, vous devez exécuterInstall-PackageProvider
à partir de Nano Server pour télécharger les fichiers binaires NuGet appropriés. - Redémarrez PowerShell pour charger automatiquement le fournisseur de package. Vous pouvez également exécuter
Get-PackageProvider -ListAvailable
pour répertorier tous les fournisseurs de packages disponibles sur l’ordinateur.Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201
Utilisez ensuite pour importer le fournisseur dans la session Windows PowerShell active.
Exemples
Exemple 1 : Installer un fournisseur de package à partir du PowerShell Gallery
Cette commande installe le fournisseur de package GistProvider à partir du PowerShell Gallery.
Install-PackageProvider -Name "GistProvider" -Verbose
Exemple 2 : Installer une version spécifiée d’un fournisseur de package
Cet exemple installe une version spécifiée du fournisseur de package NuGet.
La première commande recherche toutes les versions du fournisseur de package nommé NuGet. La deuxième commande installe une version spécifiée du fournisseur de package NuGet.
Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force
Exemple 3 : Rechercher un fournisseur et l’installer
Cet exemple utilise Find-PackageProvider
et le pipeline pour rechercher le fournisseur Gist et l’installer.
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose
Exemple 4 : Installer un fournisseur dans le dossier de module de l’utilisateur actuel
Cette commande installe un fournisseur de package sur afin $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies
que seul l’utilisateur actuel puisse l’utiliser.
Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser
Paramètres
-AllVersions
Indique que cette applet de commande installe toutes les versions disponibles du fournisseur de package. Par défaut, Install-PackageProvider
retourne uniquement la version la plus élevée disponible.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Spécifie un compte d’utilisateur qui est autorisé à installer des fournisseurs de packages.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Indique que cette applet de commande force toutes les actions avec cette applet de commande qui peuvent être forcées. Actuellement, cela signifie que le paramètre Force agit de la même façon que le paramètre ForceBootstrap .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceBootstrap
Indique que cette applet de commande installe automatiquement le fournisseur de package.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Spécifie un objet SoftwareIdentity . Utilisez l’applet Find-PackageProvider
de commande pour obtenir un objet SoftwareIdentity à diriger vers Install-PackageProvider
.
Type: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaximumVersion
Spécifie la version maximale autorisée du fournisseur de package que vous souhaitez installer. Si vous n’ajoutez pas ce paramètre, Install-PackageProvider
installe la version la plus élevée disponible du fournisseur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumVersion
Spécifie la version minimale autorisée du fournisseur de package que vous souhaitez installer. Si vous n’ajoutez pas ce paramètre, Install-PackageProvider
installe la version la plus élevée disponible du package qui répond également aux exigences spécifiées par le paramètre MaximumVersion .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifie un ou plusieurs noms de modules de fournisseur de package. Séparez plusieurs noms de package par des virgules. Les caractères génériques ne sont pas pris en charge.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
Spécifie un serveur proxy pour la requête, plutôt que de se connecter directement à la ressource Internet.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCredential
Spécifie un compte d'utilisateur qui a l'autorisation d'utiliser le serveur proxy spécifié par le paramètre Proxy.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredVersion
Spécifie la version autorisée exacte du fournisseur de package que vous souhaitez installer. Si vous n’ajoutez pas ce paramètre, Install-PackageProvider
installe la version la plus élevée disponible du fournisseur qui satisfait également à toute version maximale spécifiée par le paramètre MaximumVersion .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Spécifie l’étendue d’installation du fournisseur. Les valeurs valides pour ce paramètre sont :
AllUsers : installe les fournisseurs dans un emplacement accessible à tous les utilisateurs de l’ordinateur. Par défaut, il s’agit de $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser : installe les fournisseurs à un emplacement où ils ne sont accessibles qu’à l’utilisateur actuel. Par défaut, il s’agit de $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.
Type: | String |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Source
Spécifie une ou plusieurs sources de package. Utilisez l’applet Get-PackageSource
de commande pour obtenir la liste des sources de package disponibles.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Vous pouvez diriger un objet SoftwareIdentity vers cette applet de commande. Utilisez Find-PackageProvider
pour obtenir un objet SoftwareIdentity qui peut être redirigé vers Install-PackageProvider
.
Notes
Important
Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 de Transport Layer Security (TLS). Si vous n'utilisez pas TLS 1.2 ou une version plus récente, vous recevez une erreur lorsque vous tentez d'accéder à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Pour plus d’informations, consultez l’annonce sur le blog PowerShell.