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

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

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

Cmdlet Find-Module menggunakan parameter Nama untuk menentukan modul PowerShellGet .

Contoh 2: Menemukan modul dengan nama yang sama

Contoh ini menggunakan kartubebas 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...

Cmdlet Find-Module 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 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: 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...

Cmdlet Find-Module 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...

Cmdlet Register-PSRepository mendaftarkan repositori baru. Parameter Nama menetapkan nama MySource. Parameter SourceLocation menentukan alamat repositori.

Cmdlet Find-Module 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 fungsi 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...

Cmdlet Find-Module 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: 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.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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 .

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

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

-Command

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

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

-DscResource

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

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

-Filter

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

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

-Includes

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

Type:	String[]
Accepted values:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

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

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

-MinimumVersion

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

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

-Proxy

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

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

-ProxyCredential

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

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

-RequiredVersion

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

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

-RoleCapability

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

String[]

String

Uri

PSCredential

Output

PSRepositoryItemInfo

Find-Module membuat objek PSRepositoryItemInfo yang dapat dikirim ke 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

Find-Module

Sintaks

Deskripsi

Contoh

Contoh 1: Menemukan modul berdasarkan nama

Contoh 2: Menemukan modul dengan nama yang sama

Contoh 3: Menemukan modul menurut versi minimum

Contoh 4: Menemukan modul menurut versi tertentu

Contoh 5: Menemukan modul di repositori tertentu

Contoh 6: Menemukan modul di beberapa repositori

Contoh 7: Menemukan modul yang berisi sumber daya DSC

Contoh 8: Menemukan modul dengan filter

Contoh 9: Menemukan modul menurut tag

Parameter

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Input

Output

Catatan

Saran dan Komentar

Sumber Daya Tambahan:

Find-Module

Sintaks

Deskripsi

Contoh

Contoh 1: Menemukan modul berdasarkan nama

Contoh 2: Menemukan modul dengan nama yang sama

Contoh 3: Menemukan modul menurut versi minimum

Contoh 4: Menemukan modul menurut versi tertentu

Contoh 5: Menemukan modul di repositori tertentu

Contoh 6: Menemukan modul di beberapa repositori

Contoh 7: Menemukan modul yang berisi sumber daya DSC

Contoh 8: Menemukan modul dengan filter

Contoh 9: Menemukan 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

Saran dan Komentar

Sumber Daya Tambahan: