Dela via


Find-Package

Hittar programvarupaket i tillgängliga paketkällor.

Syntax

NuGet

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

PowerShellGet

Find-Package
    [[-Name] <String[]>]
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-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.

Viktigt!

Kommandona i PackageManagement-modulen skiljer sig från kommandona som tillhandahålls av NuGet-modulen i Package Manager-konsolen i Visual Studio. Varje modul har kommandon som inte är tillgängliga i den andra. Kommandon med samma namn skiljer sig åt i sina specifika argument. Mer information finns i PowerShell-referensdokumentationen för Package Manager-konsolen i Visual Studio.

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-Package använder parametern Provider 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 en paketkälla inte tillhandahålls söker Find-Package igenom varje installerad paketprovider och dess paketkällor. 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 Name för att ange paketnamnet NuGet.Core. Parametern Source anger att du vill söka efter paketet 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 Name 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 viss 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 Name för att ange paketnamnet NuGet.Core. Parametern ProviderName anger att paketet ska sökas i NuGet. RequiredVersion anger att endast version 2.9.0 returneras.

Exempel 5: Hitta paket inom en rad olika 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 Name för att ange paketnamnet NuGet.Core. Parametern ProviderName anger att paketet ska sökas 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 minimivärdet och maxvärdet.

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 hämtas 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AllowPrereleaseVersions

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AllVersions

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Command

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ConfigFile

Anger en konfigurationsfil.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NuGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Contains

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NuGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Credential

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

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DscResource

Anger en matris med DSC-resurser (Desired State Configuration) som den här cmdleten söker efter.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Filter

Anger termer att söka efter i egenskaperna Name och Description.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FilterOnTag

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NuGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ForceBootstrap

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Headers

Anger pakethuvudena.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NuGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IncludeDependencies

Anger att den här cmdleten innehåller paketberoenden i resultatet.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Includes

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

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

  • Cmdlet (ett PowerShell-kommando)
  • DscResource
  • Funktion
  • RollKapacitet
  • Arbetsflöde

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Godkända värden:Cmdlet, DscResource, Function, RoleCapability, Workflow
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MaximumVersion

Anger den maximala paketversion som du vill hitta.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MinimumVersion

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PackageManagementProvider

Anger namnet på en pakethanteringsprovider.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 paketleverantörer.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Godkända värden:Bootstrap, NuGet, PowerShellGet
Stöder jokertecken:False
DontShow:False
Alias:Leverantör

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Proxy

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

Parameteregenskaper

Typ:Uri
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ProxyCredential

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

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PublishLocation

Anger en plats för publicering av paketet.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RequiredVersion

Anger en exakt paketversion som du vill hitta.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RoleCapability

Anger en matris med rollfunktioner.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ScriptPublishLocation

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ScriptSourceLocation

Anger en plats för skriptkällan.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SkipValidate

Växla som hoppar över verifiering av paketautentiseringsuppgifter.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NuGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Tag

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Type

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

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Module, Script, All
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PowerShellGet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

SoftwareIdentify

Den här cmdleten returnerar 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 meddelande i PowerShell-bloggen.