Install-Package

Module:

PackageManagement

Installeert een of meer softwarepakketten.

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

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 om details over uw providers weer te geven.

Belangrijk

De opdrachten in de module PackageManagement zijn anders dan de opdrachten die worden geleverd door de NuGet-module in de Package Manager-console van Visual Studio. Elke module heeft 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

De Install-Package cmdlet installeert een softwarepakket en de bijbehorende afhankelijkheden.

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

Install-Package gebruikt parameters om de pakketten Naam en Bron op te geven. De parameter Credential 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 door Find-Package wordt geretourneerd, door 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 door de pijplijn verzonden 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 bereik van 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 zoeken. 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowClobber

Overschrijft waarschuwingsberichten over conflicten met bestaande opdrachten. Bestaande opdrachten die dezelfde naam hebben als opdrachten die worden geïnstalleerd, worden overschreven.

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

-AllowPrereleaseVersions

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

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

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

-ConfigFile

Hiermee geeft u een pad dat een configuratiebestand bevat.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Contains

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

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

-Credential

Hiermee geeft u een gebruikersaccount met machtigingen voor toegang tot de computer en het uitvoeren van opdrachten. Typ een gebruikersnaam, zoals User01, Domain01\User01, of voer een PSCredential-object in dat door de Get-Credential cmdlet is 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

Hiermee geeft u een pad naar een invoerobject.

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

-DscResource

Hiermee geeft u een of meer Desired State Configuration (DSC)-resources op die worden doorzocht op Install-Package. Gebruik de Find-DscResource cmdlet om DSC-resources te zoeken.

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

-ExcludeVersion

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

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

-Filter

Hiermee geeft u de termen op die moeten worden gezocht in de eigenschappen Naam en Beschrijving .

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

-FilterOnTag

Hiermee geeft u een tag op die resultaten filtert en resultaten uitsluit die niet de opgegeven tag bevatten.

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

-Force

Hiermee wordt de opdracht uitgevoerd zonder dat om bevestiging van de gebruiker wordt gevraagd. Overschrijft beperkingen die verhinderen Install-Package dat ze slagen, met uitzondering van de beveiliging.

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

-ForceBootstrap

Hiermee dwingt u PackageManagement automatisch de pakketprovider voor het opgegeven pakket te installeren.

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

-Headers

Hiermee geeft u de pakketheaders op.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
• Werkstroom

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

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

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

-InstallUpdate

Hiermee wordt aangegeven dat Install-Package updates worden geïnstalleerd.

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

-MaximumVersion

Hiermee geeft u de maximaal toegestane pakketversie 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

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

-NoPathUpdate

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

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

-PackageManagementProvider

Hiermee geeft u de naam van de PackageManagement-provider .

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

-ProviderName

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

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

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

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

-ProxyCredential

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

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

-PublishLocation

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleCapability

Hiermee geeft u een matrix met rolmogelijkheden op.

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

-Scope

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

• CurrentUser
• Allusers

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

-ScriptPublishLocation

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

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

-ScriptSourceLocation

Hiermee geeft u de locatie van de scriptbron op.

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

-SkipDependencies

Slaat de installatie van softwareafhankelijkheden over.

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

-SkipPublisherCheck

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

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

-SkipValidate

Schakeloptie waarmee het valideren van de referenties van een pakket wordt overgeslagen.

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

-Source

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

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

-Tag

Hiermee geeft u een of meer tekenreeksen te zoeken in de metagegevens van het pakket.

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

-Type

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

• Module
• Script
• Alles

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

-WhatIf

Toont wat er gebeurt als Install-Package de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

U kunt een SoftwareIdentity-object doorspeken 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. Heeft bijvoorbeeld Install-Package de PowerShellGet-parameterset die , AllowClobberen SkipPublisherCheckbevat-NoPathUpdate.

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.

Verwante koppelingen

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