Find-Command
PowerShell-parancsokat keres a modulokban.
Syntax
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>]
Description
A Find-Command parancsmag megkeresi a PowerShell-parancsokat, például parancsmagokat, aliasokat, függvényeket és munkafolyamatokat.
Find-Command regisztrált adattárakban keres modulokat.
A Find-Commandáltal talált összes parancshoz egy PSGetCommandInfo objektum lesz visszaadva. A PSGetCommandInfo objektum elküldhető a folyamaton a Install-Module parancsmagnak.
Install-Module telepíti a parancsot tartalmazó modult.
Példák
1. példa: Az összes parancs megkeresése egy megadott adattárban
A Find-Command parancsmag egy regisztrált adattárban keres modulokat.
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 a Adattár paraméterrel adja meg a regisztrált adattár nevét. A rendszer elküldi az objektumokat a folyamatnak.
Select-Object fogadja az objektumokat, és a Első paraméter használatával jeleníti meg az első 10 találatot.
2. példa: Parancs megkeresése név szerint
Find-Command egy parancs nevével megkeresheti a modult egy adattárban. Előfordulhat, hogy egy parancsnév több ModuleNamesszerepel.
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
Get-TargetResourceadja meg.
3. példa: Parancsok keresése név szerint és a modul telepítése
Find-Command megkeresheti a parancsot és a modult, majd elküldheti az objektumot Install-Module. Ha egy parancs több modulban is szerepel, használja a Find-CommandModuleName parancsmagokat.
Ellenkező esetben előfordulhat, hogy olyan modulok vannak telepítve, amelyeket nem kívánt telepíteni.
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 a Név paraméter használatával adja meg a parancsot Get-TargetResource. A Install-Module, és a modul telepítve van. A telepítés befejezése után a Get-InstalledModule használatával megjelenítheti az eredményeket.
4. példa: Parancs megkeresése és a modul mentése
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 A Név és adattár paraméterekkel megkeresi a parancsot Invoke-ScriptAnalyzer a PSGallery-adattárban . Az objektumot a rendszer a Save-Module-hoz továbbítja a folyamat során. A Elérési út paraméter határozza meg a modul mentési helyét.
Részletes nem kötelező paraméter, de állapotkimenetet jelenít meg a PowerShell-konzolon. A részletes kimenet hasznos a hibaelhárításhoz.
Paraméterek
-AllowPrerelease
Az eredményekben előzetesként megjelölt modulokat tartalmaz.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-AllVersions
Azt jelzi, hogy ez a parancsmag egy modul összes verzióját lekéri.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Filter
A PackageManagement szolgáltató keresési szintaxisa alapján keres modulokat. Adja meg például a ModuleName és a Description tulajdonságban keresni kívánt szavakat.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-MaximumVersion
Meghatározza, hogy a modul maximális verziója szerepeljen az eredmények között. A MaximumVersion és a RequiredVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-MinimumVersion
Meghatározza a modul minimális verzióját, amely az eredményekbe belefoglalandó. A MinimumVersion és a RequiredVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ModuleName
A parancsok kereséséhez használt modul nevét adja meg. Az alapértelmezett beállítás az összes modul.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Megadja az adattárban keresni kívánt parancsnevet. Parancsnevek tömbjének vesszővel való elválasztásához.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Proxy
A kéréshez proxykiszolgálót ad meg, nem pedig az internetes erőforráshoz való közvetlen kapcsolatot.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ProxyCredential
Olyan felhasználói fiókot ad meg, amely jogosult a proxyparaméter által megadott proxykiszolgáló használatára.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Repository
Megadja a parancsok kereséséhez használt adattárat. Az adattárnevek tömbjének elválasztásához használjon vesszőket. Az alapértelmezett érték az összes adattár.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-RequiredVersion
Megadja a modul azon verzióját, amely szerepel az eredmények között.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Tag
Olyan címkéket ad meg, amelyek kategorizálják a modulokat egy adattárban. Címkék tömbjének elválasztásához használjon vesszőt.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Kimenetek
PSGetCommandInfo
Find-Command
PSGetCommandInfo objektumot ad ki.
Jegyzetek
Fontos
2020 áprilisától a PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2 vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-gyűjtemény elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
További információ: közlemény a PowerShell blogjában.