Find-Package

Referentie

Module:: PackageManagement

Hiermee vindt u softwarepakketten in beschikbare pakketbronnen.

Syntax

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

Description

Find-Package zoekt naar softwarepakketten die beschikbaar zijn in pakketbronnen. Get-PackageProvider en Get-PackageSource details over uw providers weergeven.

Voorbeelden

Voorbeeld 1: Alle beschikbare pakketten zoeken van een pakketprovider

Met deze opdracht vindt u alle beschikbare PowerShell-modulepakketten in een geregistreerde galerie. Gebruik Get-PackageProvider dit om de providernaam op te halen.

Find-Package -ProviderName NuGet

Name               Version   Source     Summary
----               -------   ------     -------
NUnit              3.11.0    MyNuGet    NUnit is a unit-testing framework for all .NET langua...
Newtonsoft.Json    12.0.1    MyNuGet    Json.NET is a popular high-performance JSON framework...
EntityFramework    6.2.0     MyNuGet    Entity Framework is Microsoft's recommended data acce...
MySql.Data         8.0.15    MyNuGet    MySql.Data.MySqlClient .Net Core Class Library
bootstrap          4.3.1     MyNuGet    Bootstrap framework in CSS. Includes fonts and JavaSc...
NuGet.Core         2.14.0    MyNuGet    NuGet.Core is the core framework assembly for NuGet...

Find-Package gebruikt de parameter Provider om de provider NuGet op te geven.

Voorbeeld 2: Een pakket zoeken uit een pakketbron

Met deze opdracht wordt de nieuwste versie van een pakket gevonden vanuit een opgegeven pakketbron. Als er geen pakketbron wordt opgegeven, Find-Package zoekt u elke geïnstalleerde pakketprovider en de bijbehorende pakketbronnen. Gebruik Get-PackageSource deze om de bronnaam op te halen.

Find-Package -Name NuGet.Core -Source MyNuGet

Name         Version   Source    Summary
----         -------   ------    -------
NuGet.Core   2.14.0    MyNuGet   NuGet.Core is the core framework assembly for NuGet...

Find-Package gebruikt de parameter Name om de pakketnaam NuGet.Core op te geven. De bronparameter geeft aan om te zoeken naar het pakket in MyNuGet.

Voorbeeld 3: Alle versies van een pakket zoeken

Met deze opdracht worden alle beschikbare pakketversies van een opgegeven provider gevonden.

Find-Package -Name NuGet.Core -Source MyNuGet -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.14.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.14.0-rtm-832   MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.13.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
...
NuGet.Core    1.1.229.159      MyNuGet      NuGet.Core is the core framework assembly for NuGet...
Nuget.Core    1.0.1120.104     MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package gebruikt de parameter Name om het pakket NuGet.Core op te geven. De parameter ProviderName geeft aan om te zoeken naar het pakket in MyNuGet. AllVersions geeft aan dat alle beschikbare versies worden geretourneerd.

Voorbeeld 4: Een pakket zoeken met een specifieke naam en versie

Met deze opdracht wordt een specifieke pakketversie van een opgegeven provider gevonden.

Find-Package -Name NuGet.Core -ProviderName NuGet -RequiredVersion 2.9.0

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Voorbeeld 5: Pakketten zoeken binnen een reeks versies

Met deze opdracht vindt u een reeks versies voor een opgegeven pakket.

Find-Package -Name NuGet.Core -ProviderName NuGet -MinimumVersion 2.7.0 -MaximumVersion 2.9.0 -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.6            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.7.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package gebruikt de parameter Name om de pakketnaam NuGet.Core op te geven. De parameter ProviderName geeft aan om te zoeken naar het pakket in NuGet. MinimumVersion geeft de laagste versie 2.7.0 op. MaximumVersion geeft de hoogste versie 2.9.0 op. AllVersions bepaalt dat het bereik wordt geretourneerd zoals opgegeven door het minimum en maximum.

Voorbeeld 6: Een pakket zoeken vanuit een bestandssysteem

Met deze opdracht worden pakketten gevonden met de bestandsextensie .nupkg die zijn opgeslagen op de lokale computer. De bestanden zijn pakketten die zijn gedownload uit een galerie, zoals de NuGet.

PS> Find-Package -Source C:\LocalPkg

Name                 Version    Source           Summary
----                 -------    ------           -------
Microsoft.Web.Xdt    3.0.0      C:\LocalPkg\     Microsoft Xml Document Transformation (XDT)...
NuGet.Core           2.14.0     C:\LocalPkg\     NuGet.Core is the core framework assembly...

Parameters

-AcceptLicense

Accepteert automatisch een licentieovereenkomst als het pakket dit vereist.

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 Find-Package alle beschikbare versies van het pakket worden geretourneerd. Find-Package Standaard wordt alleen de nieuwste beschikbare versie geretourneerd.

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

-Command

Hiermee geeft u een matrix van opdrachten doorzocht.Find-Package

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

-ConfigFile

Hiermee geeft u een configuratiebestand.

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

-Contains

Find-Package haalt objecten op als een item in de eigenschapswaarden van het object exact overeenkomen met de opgegeven waarde.

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

-Credential

Hiermee geeft u een gebruikersaccount met machtigingen voor het zoeken naar pakketten.

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

-DscResource

Hiermee geeft u een matrix van Desired State Configuration (DSC) resources op die door deze cmdlet worden gezocht.

Type:	String[]
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 de tag op waarmee de resultaten worden gefilterd. Resultaten die de opgegeven tag niet bevatten, worden uitgesloten.

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.

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

-ForceBootstrap

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

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

-Headers

Hiermee geeft u de headers voor het pakket op.

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

-IncludeDependencies

Geeft aan dat deze cmdlet pakketafhankelijkheden bevat in de resultaten.

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

-Includes

Hiermee geeft u op of Find-Package alle pakketten binnen een categorie moeten worden gevonden.

De geaccepteerde waarden 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

-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

-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

-Proxy

Hiermee geeft u een proxyserver voor de aanvraag in plaats van een directe verbinding met de 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 een locatie op voor het publiceren van het pakket.

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

-RequiredVersion

Hiermee geeft u een exacte pakketversie op die u wilt zoeken.

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

-ScriptPublishLocation

Hiermee geeft u een scriptpublicatielocatie voor het pakket op.

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

-ScriptSourceLocation

Hiermee geeft u een scriptbronlocatie op.

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

-SkipValidate

Schakel over waarmee pakketreferentievalidatie wordt overgeslagen.

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

-Source

Hiermee geeft u een of meer pakketbronnen op. Hiermee Get-PackageSource haalt u een lijst met beschikbare pakketbronnen op. Een bestandssysteemmap kan worden gebruikt als bron voor downloadpakketten.

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 een van beide.

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

Invoerwaarden

None

Find-Package accepteert geen invoer van de pijplijn.

Uitvoerwaarden

SoftwareIdentify[]

Find-Package voert een SoftwareIdentity-object uit .

Notities

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.