Dela via


Install-PackageProvider

Installerar en eller flera paketproviders för pakethantering.

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

Cmdleten Install-PackageProvider installerar matchande pakethanteringsproviders som är tillgängliga i paketkällor som registrerats med PowerShellGet. Som standard innehåller detta moduler som är tillgängliga i Windows PowerShell-galleriet med packagemanagement-taggen. Pakethanteringsprovidern PowerShellGet används för att hitta providrar på dessa lagringsplatser.

Den här cmdleten installerar även matchande pakethanteringsproviders som är tillgängliga med hjälp av startprogrammet för pakethantering.

Den här cmdleten installerar även matchande pakethanteringsproviders som är tillgängliga i Azure Blob Store för pakethantering. Använd bootstrapper-providern för att hitta och installera dem.

För att kunna köra första gången kräver PackageManagement en Internetanslutning för att ladda ned NuGet-paketprovidern. Men om datorn inte har någon Internetanslutning och du behöver använda NuGet- eller PowerShellGet-providern kan du ladda ned dem på en annan dator och kopiera dem till måldatorn. Gör så här med hjälp av följande steg:

  1. Kör Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force för att installera providern från en dator med en Internetanslutning.
  2. Efter installationen hittar du providern som är installerad i $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> eller $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. <ProviderName> Placera mappen, som i det här fallet är NuGet-mappen, på motsvarande plats på måldatorn. Om måldatorn är en Nano-server måste du köra Install-PackageProvider från Nano Server för att ladda ned rätt NuGet-binärfiler.
  4. Starta om PowerShell för att automatiskt läsa in paketprovidern. Du kan också köra Get-PackageProvider -ListAvailable för att visa en lista över alla paketprovidrar som är tillgängliga på datorn. Använd Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 sedan för att importera providern till den aktuella Windows PowerShell sessionen.

Exempel

Exempel 1: Installera en paketprovider från PowerShell-galleriet

Det här kommandot installerar GistProvider-paketprovidern från PowerShell-galleriet.

Install-PackageProvider -Name "GistProvider" -Verbose

Exempel 2: Installera en angiven version av en paketprovider

Det här exemplet installerar en angiven version av NuGet-paketprovidern.

Det första kommandot hittar alla versioner av paketprovidern med namnet NuGet. Det andra kommandot installerar en angiven version av NuGet-paketprovidern.

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

Exempel 3: Hitta en provider och installera den

I det här exemplet används Find-PackageProvider och pipelinen för att söka efter Gist-providern och installera den.

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

Exempel 4: Installera en provider till den aktuella användarens modulmapp

Det här kommandot installerar en paketprovider till $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies så att endast den aktuella användaren kan använda den.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parametrar

-AllVersions

Anger att denna cmdlet installerar alla tillgängliga versioner av paketprovidern. Som standard Install-PackageProvider returnerar endast den högsta tillgängliga versionen.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Credential

Anger ett användarkonto som har behörighet att installera paketleverantörer.

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

-Force

Anger att denna cmdlet tvingar alla åtgärder med denna cmdlet som kan tvingas. För närvarande innebär det att parametern Force fungerar på samma sätt som parametern ForceBootstrap .

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

-ForceBootstrap

Anger att den här cmdleten automatiskt installerar paketprovidern.

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

-InputObject

Anger ett SoftwareIdentity-objekt . Använd cmdleten Find-PackageProvider för att hämta ett SoftwareIdentity-objekt som ska skickas till Install-PackageProvider.

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

-MaximumVersion

Anger den högsta tillåtna versionen av paketprovidern som du vill installera. Om du inte lägger till den här parametern Install-PackageProvider installerar den högsta tillgängliga versionen av providern.

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

-MinimumVersion

Anger den lägsta tillåtna versionen av paketprovidern som du vill installera. Om du inte lägger till den här parametern Install-PackageProvider installerar den högsta tillgängliga versionen av paketet som också uppfyller alla krav som anges av parametern MaximumVersion .

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

-Name

Anger ett eller flera namn på paketprovidermoduler. Avgränsa flera paketnamn med kommatecken. Jokertecken stöds inte.

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

-Proxy

Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.

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

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.

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

-RequiredVersion

Anger den exakta tillåtna versionen av paketprovidern som du vill installera. Om du inte lägger till den här parametern Install-PackageProvider installerar den högsta tillgängliga versionen av providern som också uppfyller alla högsta versioner som anges av parametern MaximumVersion .

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

-Scope

Anger installationsomfånget för providern. De acceptabla värdena för den här parametern är:

  • AllUsers – installerar providers på en plats som är tillgänglig för alla användare av datorn. Som standard är detta $env:ProgramFiles\PackageManagement\ProviderAssemblies.

  • CurrentUser – installerar leverantörer på en plats där de endast är tillgängliga för den aktuella användaren. Som standard är detta $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

Anger en eller flera paketkällor. Använd cmdleten Get-PackageSource för att hämta en lista över tillgängliga paketkällor.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Du kan skicka ett SoftwareIdentity-objekt till den här cmdleten. Använd Find-PackageProvider för att hämta ett SoftwareIdentity-objekt som kan skickas till Install-PackageProvider.

Kommentarer

Viktigt

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:

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

Mer information finns i tillkännagivandet i PowerShell-bloggen.