Get-Package

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 Get-Package op externe computers door deze uit te voeren als onderdeel van een Invoke-Command opdracht Enter-PSSession of script.

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: 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 met pakketten opgehaald die door PackageManagement op een externe computer zijn geïnstalleerd. 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. Met de parameter Credential worden een domein en gebruikersnaam opgegeven 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 opgehaald die zijn 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 op te geven, PowerShellGet. Met de parameter AllVersions wordt elke geïnstalleerde versie weergegeven.

Voorbeeld 4: Een exacte versie van een specifiek pakket ophalen

Met deze opdracht wordt een specifieke versie van een geïnstalleerd pakket opgehaald. Er kan 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 wordt de provider PowerShellGet opgegeven. De parameter RequiredVersion geeft een geïnstalleerde versie op.

Voorbeeld 5: Een pakket verwijderen

In dit voorbeeld wordt pakketinformatie opgehaald en vervolgens wordt het pakket verwijderd.

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

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

Parameters

-AllowClobber

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

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

-AllVersions

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

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

-Destination

Hiermee geeft u het pad naar een map met geëxtraheerde pakketbestanden.

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

-Force

Hiermee wordt de opdracht uitgevoerd zonder dat om bevestiging van de gebruiker wordt gevraagd.

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

-ForceBootstrap

Hiermee wordt aangegeven dat Get-PackagePackageManagement automatisch de pakketprovider installeert.

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

-MaximumVersion

Hiermee geeft u de maximale pakketversie die u wilt zoeken.

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

-MinimumVersion

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

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, of pakketnamen met jokertekens. Scheid meerdere pakketnamen met komma's.

Type:String[]
Position:0
Default value:None
Required:False
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 is toegevoegd door de provider en wordt niet ondersteund door Get-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 een pakketbeheerprovider.

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. Scheid de namen van meerdere pakketproviders met komma's. Gebruik Get-PackageProvider om een lijst met beschikbare pakketproviders op te halen.

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

-RequiredVersion

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

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

-Scope

Hiermee geeft u het zoekbereik voor het pakket op.

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

-SkipDependencies

Schakeloptie waarmee wordt opgegeven dat het zoeken naar pakketafhankelijkheden wordt overgeslagen.

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

-Type

Hiermee geeft u op of moet worden gezocht naar pakketten met een module, een script of een van beide.

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

Uitvoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Deze cmdlet retourneert een SoftwareIdentity-object voor elk geïnstalleerd pakket dat overeenkomt met de parameters. Standaard wordt elk geïnstalleerd pakket geretourneerd.

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