Find-Command
Menemukan perintah PowerShell dalam modul.
Sintaks
All
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 dikirimkan alur ke Install-Module cmdlet.
Install-Module menginstal modul yang berisi perintah .
Contoh
Contoh 1: Temukan semua perintah dalam repositori tertentu
Find-Command Cmdlet 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 berdasarkan 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 moduleName cmdlets.
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 melalui 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
Mencakup modul yang ditandai sebagai prarilis dalam hasil.
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
Menunjukkan bahwa cmdlet ini mendapatkan semua versi modul.
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 |
-Filter
Menemukan modul berdasarkan sintaks pencarian penyedia PackageManagement . Misalnya, tentukan kata yang akan dicari dalam ModuleName
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 |
-MaximumVersion
Menentukan versi maksimum modul untuk disertakan dalam hasil. MaximumVersion dan parameter 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: | False |
| Nilai dari argumen yang tersisa: | False |
-MinimumVersion
Menentukan versi minimum modul untuk disertakan dalam hasil. Parameter 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: | False |
| Nilai dari argumen yang tersisa: | False |
-ModuleName
Menentukan nama modul untuk mencari perintah. Defaultnya adalah semua modul.
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 |
-Name
Menentukan nama perintah yang akan dicari di repositori. Gunakan koma untuk memisahkan array nama perintah.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Proxy
Menentukan server proksi untuk permintaan, bukan koneksi 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
Menentukan repositori untuk mencari perintah. Gunakan koma untuk memisahkan array nama repositori. Defaultnya adalah semua repositori.
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 versi modul untuk disertakan dalam hasil.
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 tag yang mengategorikan modul dalam repositori. Gunakan koma untuk memisahkan array tag.
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.
Output
PSGetCommandInfo
Find-Command menghasilkan objek PSGetCommandInfo .
Catatan
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
