Läs på engelska

Dela via

Install-PackageProvider

  • Referens
Modul:
PackageManagement

Installerar en eller flera paketleverantörer 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 taggen PackageManagement . PowerShellGet-pakethanteringsprovidern används för att hitta leverantörer i dessa lagringsplatser.

Den här cmdleten installerar även matchande pakethanteringsprovidrar som är tillgängliga med hjälp av bootstrapping-programmet för pakethantering.

Den här cmdleten installerar även matchande pakethanteringsprovidrar 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öras 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 kan du hitta providern 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 paketleverantör 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

I det här exemplet installeras 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

Det här exemplet använder 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 paketleverantör så $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies att endast den aktuella användaren kan använda den.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parametrar

-AllVersions

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

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

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ForceBootstrap

Anger att den här cmdleten automatiskt installerar paketprovidern.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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 du den högsta tillgängliga versionen av providern.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 du den högsta tillgängliga versionen av paketet som också uppfyller alla krav som anges av parametern MaximumVersion .

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger ett eller flera paketprovidermodulnamn. Avgränsa flera paketnamn med kommatecken. Jokertecken stöds inte.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Proxy

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

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ProxyCredential

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

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 du den högsta tillgängliga versionen av providern som även uppfyller den högsta version som anges av parametern MaximumVersion .

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Scope

Anger leverantörens installationsomfång. De godtagbara värdena för den här parametern är:

  • AllUsers – installerar leverantörer 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.

Typ:String
Godkända värden:CurrentUser, AllUsers
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 meddelande i PowerShell-bloggen.