Find-Command
Vyhledá příkazy PowerShellu v modulech.
Syntaxe
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
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.
Toto je rutina proxy pro tuto rutinu Find-PSResource v modulu Microsoft.PowerShell.PSResourceGet. Další informace naleznete 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 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 parametr ModuleName rutin.
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 určení 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 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 je odeslán potrubím 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
-AllowPrerelease
Zahrne do výsledků moduly označené jako předběžné verze.
Rutina proxy mapuje tento parametr na parametr Prerelease parametru Find-PSResource.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-AllVersions
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Filter
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MaximumVersion
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MinimumVersion
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ModuleName
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 mapuje tento parametr na parametr CommandName parametru Find-PSResource.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Proxy
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ProxyCredential
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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ě.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-RequiredVersion
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Tag
Rutina proxy ignoruje tento parametr, protože není podporován parametrem CommandNameParameterSet parametru Find-PSResource.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Výstupy
PSGetCommandInfo
Find-Command výstupy PSGetCommandInfo objektu.
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 vyšší. 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
