Get-Package

Referentie

Module:: PackageManagement

Retourneert een lijst met alle softwarepakketten die zijn geïnstalleerd met PackageManagement.

Syntax

Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Destination <String>]
   [-ExcludeVersion]
   [-Scope <String>]
   [-SkipDependencies]
   [<CommonParameters>]

Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Scope <String>]
   [-PackageManagementProvider <String>]
   [-Type <String>]
   [-AllowClobber]
   [-SkipPublisherCheck]
   [-InstallUpdate]
   [-NoPathUpdate]
   [-AllowPrereleaseVersions]
   [<CommonParameters>]

Description

De Get-Package cmdlet retourneert een lijst met alle softwarepakketten op de lokale computer die zijn geïnstalleerd met PackageManagement. U kunt uitvoeren op externe computers door deze uit te voeren Get-Package als onderdeel van een Invoke-Command of Enter-PSSession opdracht of script.

Voorbeelden

Voorbeeld 1: Alle geïnstalleerde pakketten ophalen

Met Get-Package de cmdlet worden alle pakketten opgehaald die op de lokale computer zijn geïnstalleerd.

Get-Package

Name           Version      Source                                     ProviderName
----           -------      ------                                     ------------
posh-git       0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet

Voorbeeld 2: Pakketten ophalen die zijn geïnstalleerd op een externe computer

Met deze opdracht wordt een lijst opgehaald met pakketten die zijn geïnstalleerd door PackageManagement op een externe computer. Met deze opdracht wordt u gevraagd het wachtwoord van de opgegeven gebruiker op te geven.

PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}

Invoke-Command gebruikt de parameter ComputerName om een externe computer, Server01, op te geven. De referentieparameter geeft een domein en gebruikersnaam op met machtigingen voor het uitvoeren van opdrachten op de computer. De parameter ScriptBlock voert de Get-Package cmdlet uit op de externe computer.

Voorbeeld 3: Pakketten ophalen voor een opgegeven provider

Met deze opdracht worden softwarepakketten geïnstalleerd op de lokale computer van een specifieke provider.

Get-Package -ProviderName PowerShellGet -AllVersions

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.2.2        https://www.powershellgallery.com/api/v2   PowerShellGet
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet
posh-git              0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet
PowerShellGet         2.0.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package gebruikt de parameter ProviderName om een specifieke provider, PowerShellGet, op te geven. De parameter AllVersions geeft elke versie weer die is geïnstalleerd.

Voorbeeld 4: Een exacte versie van een specifiek pakket ophalen

Met deze opdracht wordt een specifieke versie van een geïnstalleerd pakket opgehaald. Er kunnen meer dan één versie van een pakket worden geïnstalleerd.

Get-Package -Name PackageManagement -ProviderName PowerShellGet -RequiredVersion 1.3.1

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package gebruikt de parameter Name om de pakketnaam , PackageManagement, op te geven. Met de parameter ProviderName geeft u de provider PowerShellGet op. De parameter RequiredVersion geeft een geïnstalleerde versie op.

Voorbeeld 5: Een pakket verwijderen

In dit voorbeeld worden pakketgegevens opgehaald en vervolgens het pakket verwijderd.

Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package

Get-Package gebruikt de parameter Name om de pakketnaam op te geven, posh-git. De parameter RequiredVersion is een specifieke versie van het pakket. Het object wordt naar de pijplijn verzonden naar de Uninstall-Package cmdlet. Uninstall-Package verwijdert het pakket.

Parameters

-AllowClobber

Hiermee worden waarschuwingsberichten over conflicten met bestaande opdrachten overschreven. Overschrijft bestaande opdrachten met dezelfde naam als opdrachten die door een module worden geïnstalleerd.

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

-AllowPrereleaseVersions

Bevat pakketten die zijn gemarkeerd als een voorlopige versie in de resultaten.

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

-AllVersions

Geeft aan dat Get-Package alle beschikbare versies van het pakket worden geretourneerd. Get-Package Standaard wordt alleen de nieuwste beschikbare versie geretourneerd.

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

-Destination

Hiermee geeft u het pad naar een map met uitgepakte pakketbestanden.

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

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

-ForceBootstrap

Hiermee wordt aangegeven dat Get-PackagePackageManagement de pakketprovider automatisch moet installeren.

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

-InstallUpdate

Geeft aan dat met deze cmdlet updates worden geïnstalleerd.

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

-MaximumVersion

Hiermee geeft u de maximale pakketversie op die u wilt zoeken.

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

-MinimumVersion

Hiermee geeft u de minimale pakketversie op die u wilt zoeken. Als er een hogere versie beschikbaar is, wordt die versie geretourneerd.

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

-Name

Hiermee geeft u een of meer pakketnamen of pakketnamen met jokertekens. Scheid meerdere pakketnamen met komma's.

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

-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 Get-Package.

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

-PackageManagementProvider

Hiermee geeft u de naam van een pakketbeheerprovider.

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

-ProviderName

Hiermee geeft u een of meer pakketprovidernamen op. Scheid meerdere namen van pakketproviders met komma's. Hiermee Get-PackageProvider haalt u een lijst met beschikbare pakketproviders op.

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

-RequiredVersion

Hiermee geeft u de exacte versie van het pakket te vinden.

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

-Scope

Hiermee geeft u het zoekbereik voor het pakket.

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

-SkipDependencies

Schakeloptie die aangeeft dat u alle pakketafhankelijkheden wilt overslaan.

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

-Type

Hiermee geeft u op of u wilt zoeken naar pakketten met een module, een script of een van beide.

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

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 Get-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.