Install-Package
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 Get-PackageProvider
du 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 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åt 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 godkänner licensavtalet automatiskt 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 de 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 för 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 det 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
ska hitta alla pakettyper. 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 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 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 läggs 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 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 omfånget 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
`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
visar en cmdlets parameteruppsättningar och innehåller providerns parameteruppsättning. Har till exempel Install-Package
parameteruppsättningen PowerShellGet som innehåller -NoPathUpdate
, AllowClobber
och SkipPublisherCheck
.