Delen via

Install-Package

  • Referentie
Module:
PackageManagement

Installeert een of meer softwarepakketten.

Syntaxis

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

De Install-Package cmdlet installeert een of meer softwarepakketten op de lokale computer. Als u meerdere softwarebronnen hebt, gebruikt Get-PackageProvider u en Get-PackageSource geeft u details weer over uw providers.

Belangrijk

De opdrachten in de PackageManagement-module verschillen van de opdrachten die worden geleverd door de NuGet-module in de Package Manager-console van Visual Studio. Elke module bevat opdrachten die niet beschikbaar zijn in de andere module. Opdrachten met dezelfde naam verschillen in hun specifieke argumenten. Zie de PowerShell-referentiedocumentatie voor de Package Manager-console van Visual Studio voor meer informatie.

Voorbeelden

Voorbeeld 1: Een pakket installeren op pakketnaam

Met de Install-Package cmdlet worden een softwarepakket en de bijbehorende afhankelijkheden geïnstalleerd.

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

Install-Package gebruikt parameters om de pakkettennaam en bron op te geven. De parameter Referentie maakt gebruik van een domeingebruikersaccount met machtigingen voor het installeren van pakketten. De opdracht vraagt u om het wachtwoord van het gebruikersaccount.

Voorbeeld 2: Find-Package gebruiken om een pakket te installeren

In dit voorbeeld wordt het object dat wordt geretourneerd door Find-Package de pijplijn verzonden en geïnstalleerd door Install-Package.

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

Find-Package gebruikt de parameters Naam en Bron om een pakket te zoeken. Het object wordt verzonden naar de pijplijn en Install-Package installeert het pakket op de lokale computer.

Voorbeeld 3: Pakketten installeren door een reeks versies op te geven

Install-Package gebruikt de parameters MinimumVersion en MaximumVersion om een reeks softwareversies op te geven.

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

Install-Package gebruikt de parameters Naam en Bron om een pakket te vinden. De parameters MinimumVersion en MaximumVersion geven een reeks softwareversies op. De hoogste versie in het bereik is geïnstalleerd.

Parameters

-AcceptLicense

AcceptLicense accepteert automatisch de gebruiksrechtovereenkomst tijdens de installatie.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AllowClobber

Overschrijft waarschuwingsberichten over conflicten met bestaande opdrachten. Hiermee overschrijft u bestaande opdrachten met dezelfde naam als opdrachten die worden geïnstalleerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AllowPrereleaseVersions

Hiermee staat u de installatie van pakketten toe die zijn gemarkeerd als voorlopige versie.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AllVersions

Install-Package installeert alle beschikbare versies van het pakket. Standaard wordt alleen de nieuwste versie geïnstalleerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Command

Hiermee geeft u een of meer opdrachten waarmee Install-Package wordt gezocht.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConfigFile

Hiermee geeft u een pad op dat een configuratiebestand bevat.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Contains

Install-Package hiermee worden objecten opgehaald als de parameter Contains een waarde opgeeft die overeenkomt met een van de eigenschapswaarden van het object.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om toegang te krijgen tot de computer en opdrachten uit te voeren. Typ een gebruikersnaam, zoals User01, Domain01\User01, of voer een PSCredential-object in dat door de Get-Credential cmdlet wordt gegenereerd. Als u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Wanneer de referentieparameter niet is opgegeven, Install-Package wordt de huidige gebruiker gebruikt.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Destination

Hiermee geeft u een pad naar een invoerobject.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DscResource

Hiermee geeft u een of meer DSC-resources (Desired State Configuration) op waarop wordt gezocht Install-Package. Gebruik de Find-DscResource cmdlet om DSC-resources te vinden.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExcludeVersion

Schakel over om het versienummer uit te sluiten in het mappad.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Filter

Hiermee geeft u termen te zoeken binnen de eigenschappen Naam en Beschrijving .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FilterOnTag

Hiermee geeft u een tag op waarmee resultaten worden gefilterd en resultaten worden uitgesloten die niet de opgegeven tag bevatten.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd. Overschrijft beperkingen die voorkomen dat Install-Package ze slagen, met uitzondering van beveiliging.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ForceBootstrap

Dwingt PackageManagement af om de pakketprovider automatisch te installeren voor het opgegeven pakket.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Headers

Hiermee geeft u de pakketheaders op.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Includes

Hiermee geeft u op of Install-Package alle pakkettypen moeten worden gevonden. De acceptabele waarden voor deze parameter zijn als volgt:

  • Cmdlet
  • DscResource
  • Functie
  • RoleCapability
  • Werkproces
Type:String[]
Geaccepteerde waarden:Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Accepteert pijplijninvoer. Hiermee geeft u een pakket op met behulp van het SoftwareIdentity-type van het pakket. Find-Package voert een SoftwareIdentity-object uit .

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InstallUpdate

Geeft aan dat Install-Package updates worden geïnstalleerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaximumVersion

Hiermee geeft u de maximaal toegestane pakketversie op die u wilt installeren. Als u deze parameter niet opgeeft, Install-Package installeert u de nieuwste versie van het pakket.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinimumVersion

Hiermee geeft u de minimaal toegestane pakketversie op die u wilt installeren. Als u deze parameter niet toevoegt, Install-Package installeert u de nieuwste versie van het pakket die voldoet aan een versie die is opgegeven door de parameter MaximumVersion .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een of meer pakketnamen. Meerdere pakketnamen moeten worden gescheiden door komma's.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoPathUpdate

NoPathUpdate is alleen van toepassing op de Install-Script cmdlet. NoPathUpdate is een dynamische parameter die door de provider wordt toegevoegd en wordt niet ondersteund door Install-Package.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PackageManagementProvider

Hiermee geeft u de naam van de PackageManagement-provider .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProviderName

Hiermee geeft u een of meer pakketprovidernamen op waarop het bereik van uw pakketzoekopdracht moet worden afgestemd. U kunt pakketprovidernamen ophalen door de cmdlet uit te Get-PackageProvider voeren.

Type:String[]
Aliassen:Provider
Geaccepteerde waarden:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Proxy

Hiermee geeft u een proxyserver voor de aanvraag op, in plaats van rechtstreeks verbinding te maken met een internetresource.

Type:Uri
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProxyCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om de proxyserver te gebruiken die is opgegeven door de parameter Proxy.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublishLocation

Hiermee geeft u het pad naar de gepubliceerde locatie van een pakket.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RequiredVersion

Hiermee geeft u de exacte toegestane versie van het pakket dat u wilt installeren. Als u deze parameter niet toevoegt, Install-Package installeert u de nieuwste versie van het pakket die voldoet aan een versie die is opgegeven door de parameter MaximumVersion .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RoleCapability

Hiermee geeft u een matrix van rolmogelijkheden.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Hiermee geeft u het bereik op waarvoor het pakket moet worden geïnstalleerd. De acceptabele waarden voor deze parameter zijn als volgt:

  • HuidigeGebruiker
  • AllUsers
Type:String
Geaccepteerde waarden:CurrentUser, AllUsers
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ScriptPublishLocation

Hiermee geeft u het pad naar de gepubliceerde locatie van een script.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ScriptSourceLocation

Hiermee geeft u de locatie van de scriptbron.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipDependencies

Hiermee wordt de installatie van softwareafhankelijkheden overgeslagen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipPublisherCheck

Hiermee kunt u een pakketversie ophalen die nieuwer is dan uw geïnstalleerde versie. Een geïnstalleerd pakket dat digitaal is ondertekend door een vertrouwde uitgever, maar een nieuwe versie is niet digitaal ondertekend.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipValidate

Schakel over waarmee de referenties van een pakket worden overgeslagen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Source

Hiermee geeft u een of meer pakketbronnen op. Meerdere pakketbronnamen moeten worden gescheiden door komma's. U kunt pakketbronnamen ophalen door de cmdlet uit te Get-PackageSource voeren.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Hiermee geeft u een of meer tekenreeksen op die moeten worden gezocht in de metagegevens van het pakket.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Type

Hiermee geeft u op of u wilt zoeken naar pakketten met een module, een script of beide. De acceptabele waarden voor deze parameter zijn als volgt:

  • Moduul
  • Script
  • Alle
Type:String
Geaccepteerde waarden:Module, Script, All
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als Install-Package cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

U kunt een SoftwareIdentity-object doorsluisen naar deze cmdlet.

Uitvoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Deze cmdlet retourneert een SoftwareIdentity-object voor elk pakket dat wordt geïnstalleerd.

Notities

Het opnemen van een pakketprovider in een opdracht kan dynamische parameters beschikbaar maken voor een cmdlet. Dynamische parameters zijn specifiek voor een pakketprovider. De Get-Help cmdlet bevat de parametersets van een cmdlet en bevat de parameterset van de provider. Bevat bijvoorbeeld Install-Package de PowerShellGet-parameterset die , -NoPathUpdateAllowClobberen SkipPublisherCheck.

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u TLS 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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

Zie de aankondiging in de PowerShell-blog voor meer informatie.