Sdílet prostřednictvím


Find-Command

Vyhledá příkazy PowerShellu v modulech.

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

Rutina Find-Command vyhledá příkazy PowerShellu, jako jsou rutiny, aliasy, funkce a pracovní postupy. Find-Command prohledává moduly v registrovaných úložištích.

Toto je rutina proxy pro rutinu Find-PSResource v Microsoft.PowerShell.PSResourceGet. Další informace najdete v tématu Find-PSResource.

Příklady

Příklad 1: Vyhledání příkazu podle názvu

Find-Command může použít název příkazu k vyhledání modulu v úložišti. Je možné, že název příkazu existuje ve více 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 pomocí parametru Repository prohledá PSGallery. Parametr Name určuje příkaz Get-TargetResource.

Příklad 2: Vyhledání příkazů podle názvu a instalace modulu

Find-Command může vyhledat příkaz a modul a pak odeslat objekt do Install-Module. Pokud je příkaz součástí více modulů, použijte Find-Command parametr Rutiny ModuleName . Jinak se můžou nainstalovat moduly, které jste nechtěli nainstalovat.

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 používá parametr Name k zadání příkazu Get-TargetResource. Parametr Repository prohledá PSGallery. Parametr ModuleName určuje modul, který chcete nainstalovat, SystemLocaleDsc. Objekt se odešle kanálem do Install-Module a modul se nainstaluje. Po dokončení instalace můžete k zobrazení výsledků použít příkaz Get-InstalledModule .

Příklad 3: Vyhledání příkazu a uložení jeho modulu

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 používá parametry Name a Repository k vyhledání příkazu Invoke-ScriptAnalyzer v úložišti PSGallery . Objekt se odešle kanálem do Save-Module. Parametr Path určuje umístění pro uložení modulu. Podrobný parametr je volitelný parametr, ale zobrazuje stavový výstup v konzole PowerShellu. Podrobný výstup je vhodný pro řešení potíží.

Parametry

-AllowPrerelease

Zahrne do výsledků moduly označené jako předběžné verze.

Rutina proxy serveru mapuje tento parametr na parametr Předběžné verze pro Find-PSResource.

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

-AllVersions

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-Filter

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-MaximumVersion

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-MinimumVersion

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-ModuleName

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-Name

Určuje název příkazu, který se má vyhledat v úložišti. K oddělení pole názvů příkazů použijte čárky.

Rutina proxy serveru mapuje tento parametr na parametr CommandName pro Find-PSResource.

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

-Proxy

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-ProxyCredential

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-Repository

Určuje úložiště pro hledání příkazů. K oddělení pole názvů úložišť použijte čárky. Výchozí hodnota je všechna úložiště.

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

-RequiredVersion

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

-Tag

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje parametr CommandNameParameterSet z .Find-PSResource

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

Výstupy

PSGetCommandInfo

Find-Command výstup PSGetCommandInfo objekt.

Poznámky

Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Musíte použít protokol TLS 1.2 nebo novější. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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