Install-PackageProvider

  • Riferimento
Modulo:
PackageManagement

Installa uno o più provider di pacchetti di Gestione pacchetti.

Sintassi

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

Descrizione

Il Install-PackageProvider cmdlet installa i provider di Gestione pacchetti corrispondenti disponibili nelle origini dei pacchetti registrate con PowerShellGet. Per impostazione predefinita, sono inclusi i moduli disponibili nella raccolta Windows PowerShell con il tag PackageManagement. Il provider di gestione pacchetti PowerShellGet viene usato per trovare i provider in questi repository.

Questo cmdlet installa anche i provider di gestione pacchetti corrispondenti disponibili usando l'applicazione di avvio automatico di Gestione pacchetti.

Questo cmdlet installa anche i provider di Gestione pacchetti corrispondenti disponibili nell'archivio BLOB di Azure gestione pacchetti. Usare il provider del programma di avvio automatico per trovarli e installarli.

Per eseguire la prima volta, PackageManagement richiede una connessione Internet per scaricare il provider di pacchetti NuGet. Tuttavia, se il computer non dispone di una connessione Internet ed è necessario usare il provider NuGet o PowerShellGet, è possibile scaricarli in un altro computer e copiarli nel computer di destinazione. A tale scopo, attenersi alla seguente procedura:

  1. Eseguire Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force per installare il provider da un computer con una connessione Internet.
  2. Dopo l'installazione, è possibile trovare il provider installato in $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> o $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. Posizionare la <ProviderName> cartella , che in questo caso è la cartella NuGet, nel percorso corrispondente nel computer di destinazione. Se il computer di destinazione è un Nano Server, è necessario eseguire Install-PackageProvider da Nano Server per scaricare i file binari NuGet corretti.
  4. Riavviare PowerShell per caricare automaticamente il provider di pacchetti. In alternativa, eseguire Get-PackageProvider -ListAvailable per elencare tutti i provider di pacchetti disponibili nel computer. Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 Usare quindi per importare il provider nella sessione di Windows PowerShell corrente.

Esempio

Questo comando installa il provider di pacchetti GistProvider dal PowerShell Gallery.

Install-PackageProvider -Name "GistProvider" -Verbose

Esempio 2: Installare una versione specificata di un provider di pacchetti

In questo esempio viene installata una versione specificata del provider di pacchetti NuGet.

Il primo comando trova tutte le versioni del provider di pacchetti denominato NuGet. Il secondo comando installa una versione specificata del provider di pacchetti NuGet.

Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force

Esempio 3: Trovare un provider e installarlo

Questo esempio usa Find-PackageProvider e la pipeline per cercare il provider Gist e installarlo.

Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose

Esempio 4: Installare un provider nella cartella del modulo dell'utente corrente

Questo comando installa un provider di pacchetti in $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies in modo che solo l'utente corrente possa usarlo.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parametri

-AllVersions

Indica che questo cmdlet installa tutte le versioni disponibili del provider di pacchetti. Per impostazione predefinita, Install-PackageProvider restituisce solo la versione più recente disponibile.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifica un account utente che dispone dell'autorizzazione per installare i provider di pacchetti.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Indica che questo cmdlet forza tutte le azioni con questo cmdlet che può essere forzato. Attualmente, questo significa che il parametro Force agisce come il parametro ForceBootstrap .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceBootstrap

Indica che questo cmdlet installa automaticamente il provider di pacchetti.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifica un oggetto SoftwareIdentity . Usare il Find-PackageProvider cmdlet per ottenere un oggetto SoftwareIdentity da inviare tramite pipe a Install-PackageProvider.

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Specifica la versione massima consentita del provider di pacchetti che si vuole installare. Se non si aggiunge questo parametro, Install-PackageProvider installa la versione più elevata disponibile del provider.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Specifica la versione minima consentita del provider di pacchetti che si vuole installare. Se non si aggiunge questo parametro, Install-PackageProvider installa la versione più elevata disponibile del pacchetto che soddisfa anche qualsiasi requisito specificato dal parametro MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica uno o più nomi di modulo del provider di pacchetti. Separare più nomi di pacchetto con virgole. I caratteri jolly non sono supportati.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Specifica un server proxy per la richiesta, anziché connettersi direttamente alla risorsa Internet.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Specifica un account utente con autorizzazioni per l'uso del server proxy specificato dal parametro Proxy.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

Specifica la versione esatta consentita del provider di pacchetti che si vuole installare. Se non si aggiunge questo parametro, Install-PackageProvider installa la versione più elevata disponibile del provider che soddisfa anche qualsiasi versione massima specificata dal parametro MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Specifica l'ambito di installazione del provider. I valori validi per questo parametro sono:

  • AllUsers : installa i provider in un percorso accessibile a tutti gli utenti del computer. Per impostazione predefinita, si tratta di $env:ProgramFiles\PackageManagement\ProviderAssemblies.

  • CurrentUser : installa i provider in un percorso in cui sono accessibili solo all'utente corrente. Per impostazione predefinita, si tratta di $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

Specifica una o più origini pacchetto. Usare il Get-PackageSource cmdlet per ottenere un elenco delle origini dei pacchetti disponibili.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.PackageManagement.Packaging.SoftwareIdentity

È possibile inviare tramite pipe un oggetto SoftwareIdentity a questo cmdlet. Usare Find-PackageProvider per ottenere un oggetto SoftwareIdentity che può essere inviato tramite pipe a Install-PackageProvider.

Note

Importante

A partire da aprile 2020 PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di TLS (Transport Layer Security). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si tenta di accedere a PowerShell Gallery. Per verificare di usare TLS 1.2, eseguire il comando seguente:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Per altre informazioni, vedere l'annuncio corrispondente nel blog di PowerShell.