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.

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

Contoh

Contoh 1: 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 2: 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.

Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
    Install-Module
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 3: Temukan perintah dan simpan modulnya

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

Mencakup modul yang ditandai sebagai prarilis dalam hasil.

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

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

-AllVersions

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

Type:SwitchParameter
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 CommandNameParameterSet dari Find-PSResource.

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-ModuleName

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

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

-Name

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

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

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

-Proxy

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh CommandNameParameterSet 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 CommandNameParameterSet dari Find-PSResource.

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

-RequiredVersion

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

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

-Tag

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

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

Output

PSGetCommandInfo

Find-Command menghasilkan objek PSGetCommandInfo .

Catatan

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