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 :

  1. 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.
  2. Après l’installation, vous pouvez trouver le fournisseur installé dans $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> ou $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. 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écuter Install-PackageProvider à partir de Nano Server pour télécharger les fichiers binaires NuGet appropriés.
  4. 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

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.