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 providers i dessa lagringsplatser.

Den här cmdleten installerar även matchande pakethanteringsprovidrar som är tillgängliga med hjälp av startprogrammet 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ö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 detta 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 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

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 paketprovider 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.

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

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 du 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 du 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 paketprovidermodulnamn. 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 du 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 providerns installationsomfång. De acceptabla 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.

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 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 kontrollera att du använder TLS 1.2:

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

Mer information finns i meddelandet i PowerShell-bloggen.