Find-Module
Menemukan modul dalam repositori yang cocok dengan kriteria yang ditentukan.
Sintaks
All
Find-Module
[[-Name] <string[]>]
[-MinimumVersion <string>]
[-MaximumVersion <string>]
[-RequiredVersion <string>]
[-AllVersions]
[-IncludeDependencies]
[-Filter <string>]
[-Tag <string[]>]
[-Includes <string[]>]
[-DscResource <string[]>]
[-RoleCapability <string[]>]
[-Command <string[]>]
[-Proxy <uri>]
[-ProxyCredential <pscredential>]
[-Repository <string[]>]
[-Credential <pscredential>]
[-AllowPrerelease]
[<CommonParameters>]
Deskripsi
Find-Module Cmdlet menemukan modul dalam repositori yang cocok dengan kriteria yang ditentukan.
Find-Module mengembalikan objek PSRepositoryItemInfo untuk setiap modul yang ditemukannya. Objek dapat dikirimkan alur ke cmdlet seperti Install-Module.
Pertama kali Find-Module mencoba menggunakan repositori, Anda mungkin diminta untuk menginstal pembaruan.
Jika sumber repositori tidak terdaftar dengan Register-PSRepository cmdlet, kesalahan akan ditampilkan.
Find-Module mengembalikan versi terbaru modul jika tidak ada parameter yang digunakan yang membatasi versi. Untuk mendapatkan daftar repositori versi modul, gunakan parameter AllVersions.
Jika parameter MinimumVersion ditentukan, Find-Module mengembalikan versi modul yang sama dengan atau lebih besar dari minimum. Jika ada versi yang lebih baru yang tersedia di repositori, versi yang lebih baru akan dikembalikan.
Jika parameter MaximumVersion ditentukan, Find-Module mengembalikan versi terbaru modul yang tidak melebihi versi yang ditentukan.
Jika parameter RequiredVersion ditentukan, Find-Module hanya mengembalikan versi modul yang sama persis dengan versi yang ditentukan.
Find-Module menelusuri semua modul yang tersedia, karena konflik nama antar sumber dapat terjadi.
Parameter yang mengambil nomor versi modul mengharapkan string yang diformat sebagai nomor versi.
- Nomor versi standar memiliki format di
x.y.zmana x, y, dan z adalah angka - Versi prarilis memiliki format
x.y.z-<prerelease_label>di mana string arbitrer ditetapkan ke rilis tersebut<prerelease_label>.
Contoh berikut menggunakan Galeri PowerShell sebagai satu-satunya repositori terdaftar.
Get-PSRepository menampilkan repositori terdaftar. Jika Anda memiliki beberapa repositori terdaftar, gunakan -Repository parameter untuk menentukan nama repositori.
Contoh
Contoh 1: Temukan modul berdasarkan nama
Contoh ini menemukan modul di repositori default.
Find-Module -Name PowerShellGet
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Find-Module Cmdlet menggunakan parameter Nama untuk menentukan modul PowerShellGet.
Contoh 2: Temukan modul dengan nama serupa
Contoh ini menggunakan kartubebas tanda bintang (*) untuk menemukan modul dengan nama serupa.
Find-Module -Name PowerShell*
Version Name Repository Description
------- ---- ---------- -----------
0.4.0 powershell-yaml PSGallery Powershell module for serializing and...
2.1.0 PowerShellGet PSGallery PowerShell module with commands for...
1.9 Powershell.Helper.Extension PSGallery # Powershell.Helper.Extension...
3.1 PowerShellHumanizer PSGallery PowerShell Humanizer wraps Humanizer...
4.0 PowerShellISEModule PSGallery a module that adds capability to the ISE
Find-Module Cmdlet menggunakan parameter Nama dengan kartubebas tanda bintang (*) untuk menemukan semua modul yang berisi PowerShell.
Contoh 3: Temukan modul menurut versi minimum
Contoh ini mencari versi minimum modul. Jika repositori berisi versi modul yang lebih baru, versi yang lebih baru dikembalikan.
Find-Module -Name PowerShellGet -MinimumVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Find-Module Cmdlet menggunakan parameter Nama untuk menentukan modul PowerShellGet.
MinimumVersion menentukan versi 1.6.5.
Find-Module mengembalikan PowerShellGet versi 2.1.0 karena melebihi versi minimum dan merupakan versi terbaru.
Contoh 4: Temukan modul menurut versi tertentu
Contoh ini menunjukkan cara menginstal versi prarilis tertentu dari modul. Versi prarilis memiliki format <version_number>-<prerelease_label>.
Find-Module PSReadLine -AllowPrerelease -RequiredVersion 2.2.4-beta1
Version Name Repository Description
------- ---- ---------- -----------
2.2.4-beta1 PSReadLine PSGallery Great command line editing in the PowerS…
Contoh 5: Temukan modul di repositori tertentu
Contoh ini menggunakan parameter Repositori untuk menemukan modul di repositori tertentu.
Find-Module -Name PowerShellGet -Repository PSGallery
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Find-Module Cmdlet menggunakan parameter Nama untuk menentukan modul PowerShellGet. Parameter Repositori menentukan untuk mencari repositori PSGallery .
Contoh 6: Menemukan modul di beberapa repositori
Contoh ini menggunakan Register-PSRepository untuk menentukan repositori.
Find-Module menggunakan repositori untuk mencari modul.
Register-PSRepository -Name MySource -SourceLocation https://www.myget.org/F/powershellgetdemo/
Find-Module -Name Contoso* -Repository PSGallery, MySource
Repository Version Name Description
---------- ------- ---- -----------
PSGallery 2.0.0.0 ContosoServer Cmdlets and DSC resources for managing Contoso Server...
MySource 1.2.0.0 ContosoClient Cmdlets and DSC resources for managing Contoso Client...
Register-PSRepository Cmdlet mendaftarkan repositori baru.
Parameter Nama menetapkan nama MySource. Parameter SourceLocation menentukan alamat repositori.
Find-Module Cmdlet menggunakan parameter Nama dengan kartubebas tanda bintang (*) untuk menentukan modul Contoso. Parameter Repositori menentukan untuk mencari dua repositori, PSGallery dan MySource.
Contoh 7: Temukan modul yang berisi sumber daya DSC
Perintah ini mengembalikan modul yang berisi sumber daya DSC. Parameter Termasuk memiliki empat fungsionalitas yang telah ditentukan sebelumnya yang digunakan untuk mencari repositori. Gunakan tab-complete untuk menampilkan empat fungsionalitas yang didukung oleh parameter Sertakan .
Find-Module -Repository PSGallery -Includes DscResource
Version Name Repository Description
------- ---- ---------- -----------
2.7.0 Carbon PSGallery Carbon is a PowerShell module...
8.5.0.0 xPSDesiredStateConfiguration PSGallery The xPSDesiredStateConfiguration module...
1.3.1 PackageManagement PSGallery PackageManagement (a.k.a. OneGet) is...
2.7.0.0 xWindowsUpdate PSGallery Module with DSC Resources...
3.2.0.0 xCertificate PSGallery This module includes DSC resources...
3.1.0.0 xPowerShellExecutionPolicy PSGallery This DSC resource can change the user...
Find-Module Cmdlet menggunakan parameter Repositori untuk mencari repositori, PSGallery.
Parameter Includes menentukan DscResource, yang merupakan fungsionalitas yang dapat dicari parameter di repositori.
Contoh 8: Menemukan modul dengan filter
Dalam contoh ini, untuk menemukan modul, filter digunakan untuk mencari repositori.
Untuk repositori berbasis NuGet, parameter Filter mencari melalui nama, deskripsi, dan tag untuk argumen .
Find-Module -Filter AppDomain
Version Name Repository Description
------- ---- ---------- -----------
1.0.0.0 AppDomainConfig PSGallery Manipulate AppDomain configuration...
1.1.0 ClassExplorer PSGallery Quickly search the AppDomain for classes...
Find-Module Cmdlet menggunakan parameter Filter untuk mencari repositori untuk AppDomain.
Contoh 9: Temukan modul menurut tag
Contoh ini menunjukkan cara menemukan modul dengan tag. Nilainya CrescendoBuilt adalah tag yang secara otomatis ditambahkan ke modul yang dibuat menggunakan modul Microsoft.PowerShell.Crescendo .
Find-Module -Tag CrescendoBuilt
Version Name Repository Description
------- ---- ---------- -----------
0.1.0 Foil PSGallery A PowerShell Crescendo wrapper for Chocolatey
0.3.1 Cobalt PSGallery A PowerShell Crescendo wrapper for WinGet
1.1.0 SysInternals PSGallery PowerShell cmdlets for SysInternal tools
0.0.4 Croze PSGallery A PowerShell Crescendo wrapper for Homebrew
0.0.2 AptPackage PSGallery PowerShell Crescendo-generated Module to query APT-Package Information
1.0.1 RoboCopy PSGallery PowerShell cmdlet for the official RoboCopy.exe
1.0.2 TShark PSGallery PowerShell cmdlet for tshark.exe
1.0.0 SpeedTestCLI PSGallery PowerShell cmdlets speedtest-cli
1.0.0 SpeedTest-CLI PSGallery PowerShell cmdlets for Internet Speed Test
1.0.2 Image2Text PSGallery PowerShell Images into ASCII art
0.1.1 Quser.Crescendo PSGallery This module displays session information of users logged onto a local or remote m...
1.0.2 Takeown PSGallery Crescendo Powershell wrapper of takeown.exe
Parameter
-AllowPrerelease
Termasuk dalam modul hasil yang ditandai sebagai pra-rilis.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-AllVersions
Menentukan untuk menyertakan semua versi modul dalam hasil. Anda tidak dapat menggunakan parameter AllVersions dengan parameter MinimumVersion, MaximumVersion, atau RequiredVersion .
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Command
Menentukan array perintah untuk ditemukan dalam modul. Perintah dapat berupa fungsi atau alur kerja.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Credential
Menentukan akun pengguna yang memiliki hak untuk menginstal modul untuk penyedia atau sumber paket tertentu.
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-DscResource
Menentukan nama, atau bagian dari nama, modul yang berisi sumber daya DSC. Per konvensi PowerShell, melakukan pencarian OR saat Anda memberikan beberapa argumen.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Filter
Menentukan filter berdasarkan sintaks pencarian khusus penyedia PackageManagement . Untuk modul NuGet, parameter ini setara dengan pencarian menggunakan bilah Pencarian di situs web Galeri PowerShell .
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-IncludeDependencies
Menunjukkan bahwa operasi ini mencakup semua modul yang bergantung pada modul yang ditentukan dalam parameter Nama .
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Includes
Hanya mengembalikan modul yang menyertakan jenis fungsionalitas PowerShell tertentu. Misalnya, Anda mungkin hanya ingin menemukan modul yang menyertakan DSCResource. Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:
- Cmdlet
- DscResource
- Fungsi
- Kemampuan Peran
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Nilai yang diterima: | DscResource, Cmdlet, Function, RoleCapability |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-MaximumVersion
Menentukan versi maksimum, atau terbaru dari modul untuk disertakan dalam hasil pencarian. MaximumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-MinimumVersion
Menentukan versi minimum modul untuk disertakan dalam hasil. MinimumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan nama modul yang akan dicari di repositori. Daftar nama modul yang dipisahkan koma diterima. Karakter pengganti diterima.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Proxy
Menentukan server proksi untuk permintaan, daripada menyambungkan langsung ke sumber daya Internet.
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-ProxyCredential
Menentukan akun pengguna yang memiliki izin untuk menggunakan server proksi yang ditentukan oleh parameter Proksi .
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Repository
Gunakan parameter Repositori untuk menentukan repositori mana yang akan dicari modulnya. Digunakan saat beberapa repositori didaftarkan. Menerima daftar repositori yang dipisahkan koma. Untuk mendaftarkan repositori, gunakan Register-PSRepository. Untuk menampilkan repositori terdaftar, gunakan Get-PSRepository.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-RequiredVersion
Menentukan nomor versi modul yang tepat untuk disertakan dalam hasilnya. RequiredVersion tidak dapat digunakan dalam perintah yang sama dengan MinimumVersion atau MaximumVersion.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-RoleCapability
Menentukan array kemampuan peran.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Tag
Menentukan array tag. Contoh tag termasuk DesiredStateConfiguration, DSC, DSCResourceKit, atau PSModule.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
String
String
Uri
PSCredential
Output
PSRepositoryItemInfo
Find-Module membuat objek PSRepositoryItemInfo yang dapat dikirimkan alur ke cmdlet seperti Install-Module.
Catatan
PowerShell menyertakan alias berikut untuk Find-Module:
- Semua platform:
fimo
Penting
Pada April 2020, Galeri PowerShell tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Jika Anda tidak menggunakan TLS 1.2 atau yang lebih tinggi, Anda akan menerima kesalahan saat mencoba mengakses Galeri PowerShell. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Untuk informasi selengkapnya, lihat pengumuman
