Find-Command

Menemukan perintah PowerShell dalam modul.

Sintaks

Find-Command
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Deskripsi

Find-Command Cmdlet menemukan perintah PowerShell seperti cmdlet, alias, fungsi, dan alur kerja. Find-Command mencari modul di repositori terdaftar.

Untuk setiap perintah yang ditemukan oleh Find-Command, objek PSGetCommandInfo dikembalikan. Objek PSGetCommandInfo dapat dikirim ke alur ke Install-Module cmdlet . Install-Module menginstal modul yang berisi perintah .

Contoh

Contoh 1: Temukan semua perintah dalam repositori tertentu

Cmdlet Find-Command mencari repositori terdaftar untuk modul.

Find-Command -Repository PSGallery | Select-Object -First 10

Name                                Version    ModuleName          Repository
----                                -------    ----------          ----------
Disable-AzureRmDataCollection       5.8.3      AzureRM.profile     PSGallery
Disable-AzureRmContextAutosave      5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmDataCollection        5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmContextAutosave       5.8.3      AzureRM.profile     PSGallery
Remove-AzureRmEnvironment           5.8.3      AzureRM.profile     PSGallery
Get-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Set-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Add-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Get-AzureRmSubscription             5.8.3      AzureRM.profile     PSGallery
Connect-AzureRmAccount              5.8.3      AzureRM.profile     PSGallery

Find-Command menggunakan parameter Repositori untuk menentukan nama repositori terdaftar. Objek dikirim ke alur. Select-Object menerima objek dan menggunakan parameter Pertama untuk menampilkan 10 hasil pertama.

Contoh 2: Temukan perintah menurut nama

Find-Command dapat menggunakan nama perintah untuk menemukan modul di repositori. Ada kemungkinan bahwa nama perintah ada di beberapa ModuleNames.

Find-Command -Repository PSGallery -Name Get-TargetResource

Name                  Version    ModuleName                      Repository
----                  -------    ----------                      ----------
Get-TargetResource    3.1.0.0    xPowerShellExecutionPolicy      PSGallery
Get-TargetResource    1.0.0      xInternetExplorerHomePage       PSGallery
Get-TargetResource    1.2.0.0    SystemLocaleDsc                 PSGallery

Find-Command menggunakan parameter Repositori untuk mencari PSGallery. Parameter Nama menentukan perintah Get-TargetResource.

Contoh 3: Temukan perintah berdasarkan nama dan instal modul

Find-Command dapat menemukan perintah dan modul, lalu mengirim objek ke Install-Module. Jika perintah disertakan dalam beberapa modul, gunakan Find-Command parameter cmdlet ModuleName . Jika tidak, modul mungkin diinstal yang tidak ingin Anda instal.

PS> Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
    Install-Module

PS> Get-InstalledModule

Version   Name               Repository   Description
-------   ----               ----------   -----------
1.2.0.0   SystemLocaleDsc    PSGallery    This DSC Resource allows configuration of the Windows...

Find-Command menggunakan parameter Nama untuk menentukan perintah Get-TargetResource. Parameter Repositori mencari PSGallery. Parameter ModuleName menentukan modul yang ingin Anda instal, SystemLocaleDsc. Objek dikirim ke alur Install-Module dan modul diinstal. Setelah penginstalan selesai, Anda dapat menggunakan Get-InstalledModule untuk menampilkan hasilnya.

Contoh 4: Temukan perintah dan simpan modulnya

PS> Find-Command -Name Invoke-ScriptAnalyzer -Repository PSGallery | Save-Module -Path C:\Test\Modules -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'PSScriptAnalyzer'.
VERBOSE: Module 'PSScriptAnalyzer' was saved successfully to path 'C:\Test\Modules\PSScriptAnalyzer\1.18.0'.

Find-Command menggunakan parameter Nama dan Repositori untuk mencari perintah Invoke-ScriptAnalyzer di repositori PSGallery . Objek dikirim ke alur ke Save-Module. Parameter Jalur menentukan lokasi untuk menyimpan modul. Verbose adalah parameter opsional, tetapi menampilkan output status di konsol PowerShell. Output verbose bermanfaat untuk pemecahan masalah.

Parameter

-AllowPrerelease

Menyertakan modul yang ditandai sebagai prarilis dalam hasil.

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

-AllVersions

Menunjukkan bahwa cmdlet ini mendapatkan semua versi modul.

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

-Filter

Menemukan modul berdasarkan sintaks pencarian penyedia PackageManagement . Misalnya, tentukan kata yang akan dicari dalam properti ModuleName dan Description .

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

-MaximumVersion

Menentukan versi maksimum modul untuk disertakan dalam hasil. Parameter MaximumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

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

-MinimumVersion

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

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

-ModuleName

Menentukan nama modul untuk mencari perintah. Defaultnya adalah semua modul.

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

-Name

Menentukan nama perintah yang akan dicari dalam repositori. Gunakan koma untuk memisahkan array nama perintah.

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

-Proxy

Menentukan server proksi untuk permintaan, bukan koneksi 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

Menentukan repositori untuk mencari perintah. Gunakan koma untuk memisahkan array nama repositori. Defaultnya adalah semua repositori.

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

-RequiredVersion

Menentukan versi modul yang akan disertakan dalam hasil.

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

-Tag

Menentukan tag yang mengategorikan modul dalam repositori. Gunakan koma untuk memisahkan array tag.

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

Output

PSGetCommandInfo

Find-Command menghasilkan objek PSGetCommandInfo .

Catatan

Penting

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