Find-Module

Referensi

Modul:: PowerShellGet

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

Ini adalah cmdlet proksi untuk Find-PSResource cmdlet di Microsoft.PowerShell.PSResourceGet. Untuk informasi selengkapnya, lihat Find-PSResource.

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.

Cmdlet proksi memetakan parameter ini ke parameter Prarilis dari Find-PSResource.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-AllVersions

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

Cmdlet proksi mengubah parameter ini menjadi -Version * sebelum memanggil Find-PSResource.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Command

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Credential

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

Jenis:	PSCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-DscResource

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Filter

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-IncludeDependencies

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Includes

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:	String[]
Nilai yang diterima:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MaximumVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Find-PSResource

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-MinimumVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Find-PSResource

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Name

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

Jenis:	String[]
Position:	0
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	True

-Proxy

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:	Uri
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-ProxyCredential

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:	PSCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-RequiredVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Find-PSResource

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-RoleCapability

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Tag

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

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

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

Galeri PowerShell tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Anda harus menggunakan TLS 1.2 atau yang lebih tinggi. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

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

Bagikan melalui

Find-Module

Sintaks

Deskripsi

Contoh

Contoh 1: Temukan modul berdasarkan nama

Contoh 2: Temukan modul dengan nama serupa

Contoh 3: Temukan modul menurut versi minimum

Contoh 4: Temukan modul menurut versi tertentu

Contoh 5: Temukan modul di repositori tertentu

Contoh 6: Menemukan modul di beberapa repositori

Contoh 7: Temukan modul yang berisi sumber daya DSC

Contoh 8: Menemukan modul dengan filter

Contoh 9: Temukan modul menurut tag

Parameter

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Input

Output

Catatan

Link Terkait