Share via

Install-Package

  • Referens
Modul:
PackageManagement

Installerar ett eller flera programvarupaket.

Syntax

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]
Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Description

Cmdleten Install-Package installerar ett eller flera programvarupaket på den lokala datorn. Om du har flera programvarukällor kan du använda Get-PackageProvider och Get-PackageSource visa information om dina leverantörer.

Viktigt

Kommandona i PackageManagement-modulen skiljer sig från de kommandon som tillhandahålls av NuGet-modulen i Package Manager-konsolen i Visual Studio. Varje modul har kommandon som inte är tillgängliga i den andra. Kommandon med samma namn skiljer sig åt i sina specifika argument. Mer information finns i PowerShell-referensdokumentationen för Package Manager-konsolen i Visual Studio.

Exempel

Exempel 1: Installera ett paket efter paketnamn

Cmdleten Install-Package installerar ett programvarupaket och dess beroenden.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package använder parametrar för att ange paketen Namn och Källa. Parametern Credential använder ett domänanvändarkonto med behörighet att installera paket. Kommandot uppmanar dig att ange lösenordet för användarkontot.

Exempel 2: Använd Find-Package för att installera ett paket

I det här exemplet skickas objektet som returneras av Find-Package ned pipelinen och installeras av Install-Package.

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package använder parametrarna Namn och Källa för att hitta ett paket. Objektet skickas ned i pipelinen och Install-Package installerar paketet på den lokala datorn.

Exempel 3: Installera paket genom att ange ett intervall med versioner

Install-Package använder parametrarna MinimumVersion och MaximumVersion för att ange ett intervall med programvaruversioner.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package använder parametrarna Namn och Källa för att hitta ett paket. Parametrarna MinimumVersion och MaximumVersion anger ett intervall med programvaruversioner. Den högsta versionen i intervallet är installerad.

Parametrar

-AcceptLicense

AcceptLicense accepterar automatiskt licensavtalet under installationen.

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

-AllowClobber

Åsidosätter varningsmeddelanden om konflikter med befintliga kommandon. Skriver över befintliga kommandon som har samma namn som kommandon som installeras.

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

-AllowPrereleaseVersions

Tillåter installation av paket som har markerats som förhandsversioner.

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

-AllVersions

Install-Package installerar alla tillgängliga versioner av paketet. Som standard är endast den senaste versionen installerad.

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

-Command

Anger ett eller flera kommandon som Install-Package söker.

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

-ConfigFile

Anger en sökväg som innehåller en konfigurationsfil.

Type:String
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

-Contains

Install-Package hämtar objekt om parametern Contains anger ett värde som matchar något av objektets egenskapsvärden.

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

-Credential

Anger ett användarkonto som har behörighet att komma åt datorn och köra kommandon. Ange ett användarnamn, till exempel User01, Domain01\User01, eller ange ett PSCredential-objekt som genereras av cmdleten Get-Credential . Om du skriver ett användarnamn uppmanas du att ange ett lösenord.

När parametern Credential inte har angetts Install-Package använder den aktuella användaren.

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

-Destination

Anger en sökväg till ett indataobjekt.

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

-DscResource

Anger en eller flera Desired State Configuration (DSC)-resurser som genomsöks av Install-Package. Använd cmdleten Find-DscResource för att hitta DSC-resurser.

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

-ExcludeVersion

Växla till att exkludera versionsnumret i mappsökvägen.

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

-Filter

Anger termer att söka efter i egenskaperna Namn och Beskrivning .

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

-FilterOnTag

Anger en tagg som filtrerar resultat och exkluderar resultat som inte innehåller den angivna taggen.

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

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse. Åsidosätter begränsningar som förhindrar Install-Package att de lyckas, med undantag för säkerhet.

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

-ForceBootstrap

Tvingar PackageManagement att automatiskt installera paketprovidern för det angivna paketet.

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

-Headers

Anger paketrubrikerna.

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

-Includes

Anger om Install-Package alla pakettyper ska hittas. Godkända värden för den här parametern är följande:

  • Cmdlet
  • DscResource
  • Funktion
  • RoleCapability
  • Arbetsflöde
Type:String[]
Accepted values:Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Accepterar pipelineindata. Anger ett paket med hjälp av paketets SoftwareIdentity-typ . Find-Package matar ut ett SoftwareIdentity-objekt .

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

-InstallUpdate

Anger att Install-Package installerar uppdateringar.

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

-MaximumVersion

Anger den högsta tillåtna paketversion som du vill installera. Om du inte anger den här parametern Install-Package installerar du paketets senaste version.

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

-MinimumVersion

Anger den lägsta tillåtna paketversion som du vill installera. Om du inte lägger till den här parametern Install-Package installerar du paketets senaste version som uppfyller alla versioner 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 paketnamn. Flera paketnamn måste avgränsas med kommatecken.

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

-NoPathUpdate

NoPathUpdate gäller endast för cmdleten Install-Script . NoPathUpdate är en dynamisk parameter som lagts till av providern och stöds inte av Install-Package.

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

-PackageManagementProvider

Anger namnet på PackageManagement-providern .

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

-ProviderName

Anger ett eller flera paketprovidernamn som paketsökningen ska begränsas till. Du kan hämta paketprovidernamn genom att köra cmdleten Get-PackageProvider .

Type:String[]
Aliases:Provider
Accepted values:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Proxy

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

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

-PublishLocation

Anger sökvägen till ett pakets publicerade plats.

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

-RequiredVersion

Anger den exakta tillåtna versionen av paketet som du vill installera. Om du inte lägger till den här parametern Install-Package installerar du paketets senaste version som uppfyller alla versioner som anges av parametern MaximumVersion .

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

-RoleCapability

Anger en matris med rollfunktioner.

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

-Scope

Anger det omfång för vilket paketet ska installeras. Godkända värden för den här parametern är följande:

  • CurrentUser
  • AllUsers
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptPublishLocation

Anger sökvägen till ett skripts publicerade plats.

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

-ScriptSourceLocation

Anger platsen för skriptkällan.

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

-SkipDependencies

Hoppar över installationen av programvaruberoenden.

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

-SkipPublisherCheck

Gör att du kan hämta en paketversion som är nyare än den installerade versionen. Till exempel ett installerat paket som är digitalt signerat av en betrodd utgivare men en ny version inte är digitalt signerad.

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

-SkipValidate

Växla som hoppar över valideringen av autentiseringsuppgifterna för ett paket.

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

-Source

Anger en eller flera paketkällor. Flera paketkällans namn måste avgränsas med kommatecken. Du kan hämta paketkällans namn genom att köra cmdleten Get-PackageSource .

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

-Tag

Anger en eller flera strängar att söka efter i paketmetadata.

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

-Type

Anger om du vill söka efter paket med en modul, ett skript eller båda. Godkända värden för den här parametern är följande:

  • Modul
  • Skript
  • Alla
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om Install-Package cmdleten körs. 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.

Utdata

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Den här cmdleten returnerar ett SoftwareIdentity-objekt för varje paket som installeras.

Kommentarer

Om du inkluderar en paketprovider i ett kommando kan dynamiska parametrar vara tillgängliga för en cmdlet. Dynamiska parametrar är specifika för en paketprovider. Cmdleten Get-Help visar en cmdlets parameteruppsättningar och innehåller providerns parameteruppsättning. Till exempel Install-Package har parameteruppsättningen PowerShellGet som innehåller -NoPathUpdate, AllowClobberoch SkipPublisherCheck.

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.