Find-Package

Referensi

Modul:: PackageManagement

Menemukan paket perangkat lunak di sumber paket yang tersedia.

Sintaks

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

Deskripsi

Find-Package menemukan paket perangkat lunak yang tersedia di sumber paket. Get-PackageProvider dan Get-PackageSource menampilkan detail tentang penyedia Anda.

Penting

Perintah yang terkandung dalam modul PackageManagement berbeda dari perintah yang disediakan oleh modul NuGet di Package Manager Console visual Studio. Setiap modul memiliki perintah yang tidak tersedia di modul lainnya. Perintah dengan nama yang sama berbeda dalam argumen spesifiknya. Untuk informasi selengkapnya, lihat dokumentasi referensi PowerShell untuk Konsol Manajer Paket Visual Studio.

Contoh

Contoh 1: Temukan semua paket yang tersedia dari penyedia paket

Perintah ini menemukan semua paket modul PowerShell yang tersedia di galeri terdaftar. Gunakan Get-PackageProvider untuk mendapatkan nama penyedia.

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 menggunakan parameter Penyedia untuk menentukan penyedia NuGet.

Contoh 2: Menemukan paket dari sumber paket

Perintah ini menemukan versi terbaru paket dari sumber paket tertentu. Jika sumber paket tidak disediakan, Find-Package cari setiap penyedia paket yang diinstal dan sumber paketnya. Gunakan Get-PackageSource untuk mendapatkan nama sumber.

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 menggunakan parameter Nama untuk menentukan nama paket NuGet.Core. Parameter Sumber menentukan untuk mencari paket di MyNuGet.

Contoh 3: Menemukan semua versi paket

Perintah ini menemukan semua versi paket yang tersedia dari penyedia tertentu.

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 menggunakan parameter Nama untuk menentukan paket NuGet.Core. Parameter ProviderName menentukan untuk mencari paket di MyNuGet. AllVersions menentukan bahwa semua versi yang tersedia dikembalikan.

Contoh 4: Menemukan paket dengan nama dan versi tertentu

Perintah ini menemukan versi paket tertentu dari penyedia tertentu.

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 menggunakan parameter Nama untuk menentukan nama paket NuGet.Core. Parameter ProviderName menentukan untuk mencari paket di NuGet. RequiredVersion menentukan bahwa hanya versi 2.9.0 yang dikembalikan.

Contoh 5: Menemukan paket dalam berbagai versi

Perintah ini menemukan rentang versi untuk paket tertentu.

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 menggunakan parameter Nama untuk menentukan nama paket NuGet.Core. Parameter ProviderName menentukan untuk mencari paket di NuGet. MinimumVersion menentukan versi terendah 2.7.0. MaximumVersion menentukan versi tertinggi 2.9.0. AllVersions menentukan rentang dikembalikan seperti yang ditentukan oleh minimum dan maksimum.

Contoh 6: Menemukan paket dari sistem file

Perintah ini menemukan paket dengan ekstensi .nupkg file yang disimpan di komputer lokal. File adalah paket yang diunduh dari galeri seperti 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...

Parameter

-AcceptLicense

Secara otomatis menerima perjanjian lisensi jika paket memerlukannya.

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

-AllowPrereleaseVersions

Menyertakan paket yang ditandai sebagai prarilis dalam hasil.

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

-AllVersions

Menunjukkan bahwa Find-Package mengembalikan semua versi paket yang tersedia. Secara default, Find-Package hanya mengembalikan versi terbaru yang tersedia.

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

-Command

Menentukan array perintah yang dicari oleh Find-Package.

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

-ConfigFile

Menentukan file konfigurasi.

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

-Contains

Find-Package mendapatkan objek jika ada item dalam nilai properti objek yang sama persis dengan nilai yang ditentukan.

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

-Credential

Menentukan akun pengguna yang memiliki izin untuk mencari paket.

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

-DscResource

Menentukan array sumber daya Desired State Configuration (DSC) yang dicari cmdlet ini.

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

-Filter

Menentukan istilah yang akan dicari dalam properti Nama dan Deskripsi .

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

-FilterOnTag

Menentukan tag yang memfilter hasil. Hasil yang tidak berisi tag yang ditentukan dikecualikan.

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

-Force

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

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

-ForceBootstrap

Menunjukkan bahwa Find-Package memaksa PackageManagement untuk menginstal penyedia paket secara otomatis.

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

-Headers

Menentukan header untuk paket.

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

-IncludeDependencies

Menunjukkan bahwa cmdlet ini menyertakan dependensi paket dalam hasil.

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

-Includes

Menentukan apakah Find-Package harus menemukan semua paket dalam kategori.

Nilai yang diterima adalah sebagai berikut:

Cmdlet
DscResource
Fungsi
RoleCapability
Alur kerja

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

Menentukan versi paket maksimum yang ingin Anda temukan.

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

-MinimumVersion

Menentukan versi paket minimum yang ingin Anda temukan. Jika versi yang lebih tinggi tersedia, versi tersebut dikembalikan.

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

-Name

Menentukan satu atau beberapa nama paket, atau nama paket dengan karakter kartubebas. Pisahkan beberapa nama paket dengan koma.

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

-PackageManagementProvider

Menentukan nama penyedia manajemen paket.

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

-ProviderName

Menentukan satu atau beberapa nama penyedia paket. Pisahkan beberapa nama penyedia paket dengan koma. Gunakan Get-PackageProvider untuk mendapatkan daftar penyedia paket yang tersedia.

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

Menentukan server proksi untuk permintaan, bukan koneksi langsung ke sumber daya internet.

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

-ProxyCredential

Menentukan akun pengguna yang memiliki izin untuk menggunakan server proksi yang ditentukan oleh parameter Proksi .

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

-PublishLocation

Menentukan lokasi untuk menerbitkan paket.

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

-RequiredVersion

Menentukan versi paket yang tepat yang ingin Anda temukan.

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

-RoleCapability

Menentukan array kemampuan peran.

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

-ScriptPublishLocation

Menentukan lokasi penerbitan skrip untuk paket tersebut.

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

-ScriptSourceLocation

Menentukan lokasi sumber skrip.

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

-SkipValidate

Alihkan yang melewati validasi kredensial paket.

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

-Source

Menentukan satu atau beberapa sumber paket. Gunakan Get-PackageSource untuk mendapatkan daftar sumber paket yang tersedia. Direktori sistem file dapat digunakan sebagai sumber untuk mengunduh paket.

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

-Tag

Menentukan satu atau beberapa string untuk dicari dalam metadata paket.

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

-Type

Menentukan apakah akan mencari paket dengan modul, skrip, atau keduanya.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

SoftwareIdentify[]

Cmdlet ini mengembalikan objek SoftwareIdentity .

Catatan