Sdílet prostřednictvím

Find-Command

  • Reference
Modul:
PowershellGet

Vyhledá příkazy PowerShellu v modulech.

Syntaxe

Find-Command
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-AllVersions]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

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

Pro každý příkaz nalezený Find-Command, PSGetCommandInfo objektu. Objekt PSGetCommandInfo lze odeslat kanál do rutiny Install-Module. Install-Module nainstaluje modul, který obsahuje příkaz.

Příklady

Příklad 1: Vyhledání všech příkazů v zadaném úložišti

Rutina Find-Command prohledá zaregistrované úložiště modulů.

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

používá parametr úložiště k zadání názvu registrovaného úložiště. Objekty se odesílají do kanálu. Select-Object obdrží objekty a pomocí parametru First zobrazí prvních 10 výsledků.

Příklad 2: 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 3: Vyhledání příkazů podle názvu a instalace modulu

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

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

používá parametr Název k zadání příkazu Get-TargetResource. Parametr Repository prohledá PSGallery. Parametr ModuleName určuje modul, který chcete nainstalovat, SystemLocaleDsc. Objekt se odešle do kanálu do Install-Module a modul se nainstaluje. Po dokončení instalace můžete výsledky zobrazit pomocí Get-InstalledModule.

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

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

Parametry

-AllVersions

Označuje, že tato rutina získá všechny verze modulu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Filter

Vyhledá moduly založené na syntaxi vyhledávání poskytovatele PackageManagement. Zadejte například slova, která se mají hledat v ModuleName a Popis vlastnosti.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaximumVersion

Určuje maximální verzi modulu, která se má zahrnout do výsledků. MaximumVersion a parametry RequiredVersion nelze použít ve stejném příkazu.

Typ:Version
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MinimumVersion

Určuje minimální verzi modulu, která se má zahrnout do výsledků. Parametry MinimumVersion a RequiredVersion nelze použít ve stejném příkazu.

Typ:Version
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ModuleName

Určuje název modulu, který má hledat příkazy. Výchozí hodnota je všechny moduly.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Proxy

Určuje proxy server pro požadavek, nikoli přímé připojení k internetovému prostředku.

Typ:Uri
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ProxyCredential

Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem Proxy.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Repository

Určuje úložiště, které má hledat příkazy. K oddělení pole názvů úložišť použijte čárky. Výchozí hodnota je všechna úložiště.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RequiredVersion

Určuje verzi modulu, která se má zahrnout do výsledků.

Typ:Version
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Určuje značky, které kategorizují moduly v úložišti. K oddělení pole značek použijte čárky.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

PSGetCommandInfo

Find-Command výstupy PSGetCommandInfo objektu.