Share via

Find-Command

  • Referencia
Modul:
PowerShellGet

Megkeresi a PowerShell-parancsokat a modulokban.

Syntax

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. Lehetséges, hogy egy parancsnév több ModuleNames-ben is létezik.

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 az Adattár paramétert használja a PSGallery kereséséhez. A Name 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 a következő címre Install-Module: . Ha egy parancs több modulban is szerepel, használja a Find-CommandModuleName parancsmagok paramétert. 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 Name paraméter használatával adja meg a parancsot Get-TargetResource. Az Adattár paraméter a PSGalleryben keres. A ModuleName paraméter megadja a telepíteni kívánt modult, a SystemLocaleDsc-t. A rendszer elküldi az objektumot a folyamatnak Install-Module , és telepíti a modult. A telepítés befejezése után az eredmények megjelenítéséhez használhatja Get-InstalledModule .

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éterek használatával megkeresi a parancsot Invoke-ScriptAnalyzer a PSGallery-adattárban . A rendszer elküldi az objektumot a folyamatnak.Save-Module Az Elérési út paraméter határozza meg a modul mentésének helyét. A Részletes paraméter nem kötelező, de megjeleníti az állapotkimenetet 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 proxyparancsmag ezt a paramétert a prerelease paraméterreFind-PSResourceképezi le.

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

-AllVersions

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

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

-Filter

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

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-ModuleName

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

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

-Name

Megadja az adattárban keresni kívánt parancsnevet. Parancsnevek tömbjének vesszővel való elválasztásához.

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

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

-Proxy

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

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

-ProxyCredential

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

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

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

-RequiredVersion

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

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

-Tag

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

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

Kimenetek

PSGetCommandInfo

Find-CommandPSGetCommandInfo objektumot ad ki.

Jegyzetek

A PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2-s vagy újabb verzióját kell használnia. Az alábbi 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