Install-Package

Module:

PackageManagement

Hiermee installeert u 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 geeft u details weer over uw providers.

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 maakt gebruik van parameters om de pakketnaam en bron op te geven. De referentieparameter maakt gebruik van een domeingebruikersaccount met machtigingen voor het installeren van pakketten. Met de opdracht wordt u gevraagd 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
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowClobber

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

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

-Command

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

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

-ConfigFile

Hiermee geeft u een pad op dat een configuratiebestand bevat.

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

-Contains

Install-Package haalt objecten op als de parameter Contains een waarde opgeeft die overeenkomt met een van de eigenschapswaarden van het object.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 wordt gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

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

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

-Destination

Hiermee geeft u een pad naar een invoerobject.

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

-DscResource

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

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

-Filter

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

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

-Force

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

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

-ForceBootstrap

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

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

-Headers

Hiermee geeft u de pakketheaders op.

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

-InstallUpdate

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

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

-Name

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

Type:	String[]
Position:	0
Default value:	None
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 door de provider wordt toegevoegd en wordt niet ondersteund door Install-Package.

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

-ProviderName

Hiermee geeft u een of meer namen van pakketproviders op waarnaar u het zoekbereik van uw pakket wilt bepalen. U kunt pakketprovidernamen ophalen door de cmdlet uit te Get-PackageProvider voeren.

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

-Proxy

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

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

-ProxyCredential

Hiermee geeft u een gebruikersaccount met machtigingen voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .

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

-PublishLocation

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

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

-RoleCapability

Hiermee geeft u een matrix van rolmogelijkheden op.

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

-Scope

Hiermee geeft u het bereik op 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
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptPublishLocation

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

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

-SkipDependencies

Slaat de installatie van softwareafhankelijkheden over.

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

-SkipPublisherCheck

Hiermee kunt u een pakketversie ophalen die nieuwer is dan de geïnstalleerde versie. 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
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidate

Schakel over om de referenties van een pakket te valideren.

Type:	SwitchParameter
Position:	Named
Default value:	None
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 cmdlet uit te Get-PackageSource voeren.

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

• Module
• Script
• Alles

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

-WhatIf

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

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

Invoerwaarden

`Install-Package` accepts input from the pipeline.

Uitvoerwaarden

SoftwareIdentity[]

Notities

Als u een pakketprovider in een opdracht opgeeft, kunt u 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. De PowerShellGet-parameterset bevat -NoPathUpdatebijvoorbeeld Install-Package , AllowClobberen 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 het 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