Find-Package

Referens

Modul:: PackageManagement

Söker efter programvarupaket i tillgängliga paketkällor.

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 hittar programvarupaket som är tillgängliga i paketkällor. Get-PackageProvider och Get-PackageSource visa information om dina leverantörer.

Exempel

Exempel 1: Hitta alla tillgängliga paket från en paketleverantör

Det här kommandot hittar alla tillgängliga PowerShell-modulpaket i ett registrerat galleri. Använd Get-PackageProvider för att hämta providernamnet.

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-Packageanvänder providerparametern för att ange providern NuGet.

Exempel 2: Hitta ett paket från en paketkälla

Det här kommandot hittar den senaste versionen av ett paket från en angiven paketkälla. Om ingen paketkälla tillhandahålls Find-Package söker varje installerad paketprovider och dess paketkällor igenom. Använd Get-PackageSource för att hämta källnamnet.

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 använder parametern Namn för att ange paketnamnet NuGet.Core. Parametern Source anger att paketet ska sökas i MyNuGet.

Exempel 3: Hitta alla versioner av ett paket

Det här kommandot hittar alla tillgängliga paketversioner från en angiven 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 använder parametern Namn för att ange paketet NuGet.Core. Parametern ProviderName anger att du vill söka efter paketet i MyNuGet. AllVersions anger att alla tillgängliga versioner returneras.

Exempel 4: Hitta ett paket med ett specifikt namn och en specifik version

Det här kommandot hittar en specifik paketversion från en angiven provider.

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

Find-Package använder parametern Namn för att ange paketnamnet NuGet.Core. Parametern ProviderName anger att du vill söka efter paketet i NuGet. RequiredVersion anger att endast version 2.9.0 returneras.

Exempel 5: Hitta paket inom ett antal versioner

Det här kommandot hittar ett intervall med versioner för ett angivet paket.

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 använder parametern Namn för att ange paketnamnet NuGet.Core. Parametern ProviderName anger att du vill söka efter paketet i NuGet. MinimumVersion anger den lägsta versionen 2.7.0. MaximumVersion anger den högsta versionen 2.9.0. AllVersions avgör att intervallet returneras enligt vad som anges av minimum och maximum.

Exempel 6: Hitta ett paket från ett filsystem

Det här kommandot hittar paket med filnamnstillägget .nupkg som lagras på den lokala datorn. Filerna är paket som laddas ned från ett galleri, till exempel 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...

Parametrar

-AcceptLicense

Accepterar automatiskt ett licensavtal om paketet kräver det.

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

-AllowPrereleaseVersions

Innehåller paket som markerats som en förhandsversion i resultatet.

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

-AllVersions

Anger att Find-Package returnerar alla tillgängliga versioner av paketet. Som standard Find-Package returnerar endast den senaste tillgängliga versionen.

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

-Command

Anger en matris med kommandon som genomsöks av Find-Package.

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

-ConfigFile

Anger en konfigurationsfil.

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

-Contains

Find-Package hämtar objekt om något objekt i objektets egenskapsvärden är en exakt matchning för det angivna värdet.

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

-Credential

Anger ett användarkonto som har behörighet att söka efter paket.

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

-DscResource

Anger en matris med Desired State Configuration (DSC)-resurser som denna cmdlet söker i.

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

-Filter

Anger termer att söka efter i egenskaperna Namn och Beskrivning .

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

-FilterOnTag

Anger taggen som filtrerar resultatet. Resultat som inte innehåller den angivna taggen undantas.

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

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

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

-ForceBootstrap

Anger att Find-Package tvingar PackageManagement att automatiskt installera paketprovidern.

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

-Headers

Anger pakethuvudena.

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

-IncludeDependencies

Anger att denna cmdlet innehåller paketberoenden i resultatet.

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

-Includes

Anger om Find-Package ska hitta alla paket i en kategori.

De godkända värdena är följande:

Cmdlet
DscResource
Funktion
RoleCapability
Arbetsflöde

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Anger den maximala paketversion som du vill hitta.

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

-MinimumVersion

Anger den lägsta paketversion som du vill hitta. Om en högre version är tillgänglig returneras den versionen.

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

-Name

Anger ett eller flera paketnamn eller paketnamn med jokertecken. Avgränsa flera paketnamn med kommatecken.

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

-PackageManagementProvider

Anger namnet på en pakethanteringsprovider.

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

-ProviderName

Anger ett eller flera paketprovidernamn. Avgränsa flera paketprovidernamn med kommatecken. Använd Get-PackageProvider för att hämta en lista över tillgängliga paketprovidrar.

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

-Proxy

Anger en proxyserver för begäran i stället för en direktanslutning till Internetresursen.

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

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.

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

-PublishLocation

Anger en plats för publicering av paketet.

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

-RequiredVersion

Anger en exakt paketversion som du vill hitta.

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

-RoleCapability

Anger en matris med rollfunktioner.

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

-ScriptPublishLocation

Anger en plats för skriptpublicering för paketet.

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

-ScriptSourceLocation

Anger en plats för skriptkällan.

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

-SkipValidate

Växla som hoppar över verifiering av paketautentiseringsuppgifter.

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

-Source

Anger en eller flera paketkällor. Använd Get-PackageSource för att hämta en lista över tillgängliga paketkällor. En filsystemkatalog kan användas som källa för nedladdningspaket.

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

-Tag

Anger en eller flera strängar att söka efter i paketmetadata.

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

-Type

Anger om du vill söka efter paket med en modul, ett skript eller någon av dem.

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

Indata

None

Find-Package accepterar inte indata från pipelinen.

Utdata

SoftwareIdentify[]

Find-Package matar ut ett SoftwareIdentity-objekt .

Kommentarer

Viktigt

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Mer information finns i tillkännagivandet i PowerShell-bloggen.