Megosztás a következőn keresztül:


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.

Ez egy proxyparancsmag a Find-PSResourceMicrosoft.PowerShell.PSResourceGet parancsmaghoz. További információ: Find-PSResource.

Példák

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

a Adattár paramétert használja a PSGallerykereséséhez. A Név paraméter a parancsot Get-TargetResourceadja meg.

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

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 a Név paraméter használatával adja meg a parancsot Get-TargetResource. A Adattár paraméter a PSGallerykeres. A ModuleName paraméter határozza meg a telepíteni kívánt modult, SystemLocaleDsc. Az objektumot a rendszer elküldi a folyamatnak 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.

3. példa: Parancs megkeresése és a modul mentése

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.

A proxy parancsmag ezt a paramétert a prerelease paraméterreFind-PSResourceképezi le.

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

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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 proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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 proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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.

A proxy parancsmag ezt a paramétert a CommandName paraméterre Find-PSResourceképezi le.

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 proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a CommandNameParameterSet nem támogatja Find-PSResource.

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

A PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2 vagy újabb verzióját kell használnia. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12