Find-Module

Menemukan modul dalam repositori yang cocok dengan kriteria yang ditentukan.

Sintaks

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 di repositori yang cocok dengan kriteria yang ditentukan. Find-Module mengembalikan objek PSRepositoryItemInfo untuk setiap modul yang ditemukannya. Objek dapat dikirim ke 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 dikembalikan.

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.

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: Menemukan 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 wildcard tanda bintang (*) untuk menemukan modul dengan nama yang sama.

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: Menemukan modul menurut versi minimum

Contoh ini mencari versi minimum modul. Jika repositori berisi versi modul yang lebih baru, versi yang lebih baru akan 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: Menemukan modul menurut versi tertentu

Contoh ini mengembalikan objek yang mewakili versi spesifik modul. Jika versi yang ditentukan tidak ditemukan, kesalahan akan dikembalikan.

Find-Module -Name PowerShellGet -RequiredVersion 1.6.5

Version   Name             Repository     Description
-------   ----             ----------     -----------
1.6.5     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

Find-Module Cmdlet menggunakan parameter Nama untuk menentukan modul PowerShellGet. Parameter RequiredVersion menentukan versi 1.6.5.

Contoh 5: Menemukan 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: Menemukan modul yang berisi sumber daya DSC

Perintah ini mengembalikan modul yang berisi sumber daya DSC. Parameter Includes 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 appDomain.

Contoh 9: Menemukan modul menurut tag

Contoh ini menunjukkan cara menemukan modul dengan tag. Nilai 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.

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

-AllVersions

Menentukan untuk menyertakan semua versi modul dalam hasil. Anda tidak dapat menggunakan parameter AllVersions dengan parameter MinimumVersion, MaximumVersion, atau RequiredVersion .

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

-Command

Menentukan array perintah untuk ditemukan dalam modul. Perintah dapat berupa fungsi atau alur kerja.

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

-Credential

Menentukan akun pengguna yang memiliki hak untuk menginstal modul untuk penyedia atau sumber paket tertentu.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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.

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

-Filter

Menentukan filter berdasarkan sintaks pencarian khusus penyedia PackageManagement . Untuk modul NuGet, parameter ini setara dengan pencarian dengan menggunakan bilah Pencarian di situs web Galeri PowerShell .

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

-IncludeDependencies

Menunjukkan bahwa operasi ini mencakup semua modul yang bergantung pada modul yang ditentukan dalam parameter Nama .

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
  • RoleCapability
Type:String[]
Accepted values:DscResource, Cmdlet, Function, RoleCapability
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Menentukan versi modul maksimum, atau terbaru yang akan disertakan dalam hasil pencarian. MaximumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

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

-MinimumVersion

Menentukan versi minimum modul untuk disertakan dalam hasil. MinimumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

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

-Name

Menentukan nama modul yang akan dicari di repositori. Daftar nama modul yang dipisahkan koma diterima. Kartubebas diterima.

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

-Proxy

Menentukan server proksi untuk permintaan tersebut, daripada menyambungkan langsung ke sumber daya Internet.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
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
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Gunakan parameter Repositori untuk menentukan repositori mana yang akan dicari modulnya. Digunakan ketika beberapa repositori terdaftar. Menerima daftar repositori yang dipisahkan koma. Untuk mendaftarkan repositori, gunakan Register-PSRepository. Untuk menampilkan repositori terdaftar, gunakan Get-PSRepository.

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

-RequiredVersion

Menentukan nomor versi modul yang tepat untuk disertakan dalam hasil. RequiredVersion tidak dapat digunakan dalam perintah yang sama dengan MinimumVersion atau MaximumVersion.

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

-RoleCapability

Menentukan array kemampuan peran.

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

-Tag

Menentukan array tag. Contoh tag termasuk DesiredStateConfiguration, DSC, DSCResourceKit, atau PSModule.

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

Input

String[]

String

Uri

PSCredential

Output

PSRepositoryItemInfo

Find-Module membuat objek PSRepositoryItemInfo yang dapat dikirimkan alur ke cmdlet seperti Install-Module.

Catatan

Penting

Mulai April 2020, PowerShell Gallery 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 di blog PowerShell.