Install-Package

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 använder du Get-PackageProvider och Get-PackageSource för att visa information om dina leverantörer.

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 Name och Source. 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 Name och Source 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 antal versioner

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

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

Install-Package använder parametrarna Name och Source för att hitta ett paket. Parametrarna MinimumVersion och MaximumVersion anger ett antal programvaruversioner. Den högsta versionen i intervallet är installerad.

Parametrar

-AcceptLicense

AcceptLicense godkänner licensavtalet automatiskt under installationen.

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

-AllowClobber

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

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

-AllowPrereleaseVersions

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

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

-AllVersions

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

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

-Command

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

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

-ConfigFile

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

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

-Contains

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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\User01eller 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 använder Install-Package den aktuella användaren.

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

-Destination

Anger en sökväg till ett indataobjekt.

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

-DscResource

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

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

-ExcludeVersion

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

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

-Filter

Anger termer att söka efter i egenskaperna Name och Description.

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

-FilterOnTag

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

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

-Force

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

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

-ForceBootstrap

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

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

-Headers

Anger paketrubrikerna.

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

-Includes

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

• Cmdlet
• DscResource
• Funktion
• RoleCapability
• Arbetsflöde

Typ:	String[]
Godkända värden:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InputObject

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

Typ:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-InstallUpdate

Anger att Install-Package installerar uppdateringar.

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

-MaximumVersion

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

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

Typ:	String[]
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

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

-PackageManagementProvider

Anger namnet på providern PackageManagement.

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

Typ:	String[]
Alias:	Provider
Godkända värden:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Proxy

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

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

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

-PublishLocation

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

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

-RequiredVersion

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

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

-RoleCapability

Anger en matris med rollfunktioner.

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

-Scope

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

• CurrentUser
• Allaanvändare

Typ:	String
Godkända värden:	CurrentUser, AllUsers
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ScriptPublishLocation

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

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

-ScriptSourceLocation

Anger platsen för skriptkällan.

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

-SkipDependencies

Hoppar över installationen av programvaruberoenden.

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

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

-SkipValidate

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

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

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

-Tag

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

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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
• Manus
• Alla

Typ:	String
Godkända värden:	Module, Script, All
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om Install-Package cmdlet 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

`Install-Package` accepts input from the pipeline.

Utdata

SoftwareIdentity[]

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 paketleverantör. Cmdleten Get-Help listar en cmdlets parameteruppsättningar och innehåller providerns parameteruppsättning. Install-Package har till exempel parameteruppsättningen PowerShellGet som innehåller -NoPathUpdate, AllowClobberoch SkipPublisherCheck.

Relaterade länkar

• about_PackageManagement
• Find-DscResource
• Get-Help
• Get-Package
• Get-PackageProvider
• Get-PackageSource
• Find-Package
• Save-Package
• Uninstall-Package