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 vindt softwarepakketten die beschikbaar zijn in pakketbronnen. Get-PackageProvider en Get-PackageSource geef details over uw providers weer.

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 beschikbare pakketten van een pakketprovider zoeken

Met deze opdracht vindt u alle beschikbare PowerShell-modulepakketten in een geregistreerde galerie. Gebruik Get-PackageProvider om de naam van de provider 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 uit een opgegeven pakketbron gevonden. Als er geen pakketbron is opgegeven, Find-Package zoekt u elke geïnstalleerde pakketprovider en de bijbehorende pakketbronnen. Gebruik Get-PackageSource 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. Met de parameter Source geeft u op om te zoeken naar het pakket in MyNuGet.

Voorbeeld 3: Alle versies van een pakket zoeken

Met deze opdracht vindt u alle beschikbare pakketversies van een opgegeven provider.

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 het bereik dat wordt geretourneerd zoals opgegeven door het minimum en maximum.

Voorbeeld 6: Een pakket zoeken vanuit een bestandssysteem

Met deze opdracht vindt u pakketten 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 gebruiksrechtovereenkomst als het pakket dit vereist.

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

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

-Command

Hiermee geeft u een matrix van opdrachten gezocht door Find-Package.

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

-ConfigFile

Hiermee geeft u een configuratiebestand.

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

-Contains

Find-Package hiermee worden objecten opgehaald als een item in de eigenschapswaarden van het object exact overeenkomt met de opgegeven waarde.

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

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om naar pakketten te zoeken.

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

-DscResource

Hiermee geeft u een matrix van Desired State Configuration (DSC) resources waarnaar deze cmdlet zoekt.

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

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.

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

-ForceBootstrap

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

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

-Headers

Hiermee geeft u de headers voor het pakket.

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

-IncludeDependencies

Geeft aan dat deze cmdlet pakketafhankelijkheden in de resultaten bevat.

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

-Includes

Hiermee geeft u op of Find-Package alle pakketten in 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
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

-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

-Proxy

Hiermee geeft u een proxyserver voor de aanvraag, in plaats van een directe verbinding met de 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 voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .

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

-PublishLocation

Hiermee geeft u een locatie voor het publiceren van het pakket.

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

-RequiredVersion

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

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

-ScriptPublishLocation

Hiermee geeft u een scriptpublicatielocatie voor het pakket op.

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

-ScriptSourceLocation

Hiermee geeft u een locatie van een scriptbron op.

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

-SkipValidate

Schakeloptie waarmee de validatie van pakketreferenties 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. Gebruik Get-PackageSource om een lijst met beschikbare pakketbronnen op te halen. Een bestandssysteemmap kan worden gebruikt als bron voor downloadpakketten.

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

Invoerwaarden

None

U kunt geen objecten doorspezen naar deze cmdlet.

Uitvoerwaarden

SoftwareIdentify[]

Deze cmdlet retourneert een SoftwareIdentity-object .

Notities