Find-Command
Znajduje polecenia programu PowerShell w modułach.
Składnia
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>]Opis
Polecenie Find-Command cmdlet znajduje polecenia programu PowerShell, takie jak polecenia cmdlet, aliasy, funkcje i przepływy pracy. Find-Command wyszukuje moduły w zarejestrowanych repozytoriach.
To jest polecenie cmdlet serwera proxy dla Find-PSResource polecenia cmdlet w elemecie Microsoft.PowerShell.PSResourceGet. Aby uzyskać więcej informacji, zobacz Find-PSResource.
Przykłady
Przykład 1. Znajdowanie polecenia według nazwy
Find-Command może użyć nazwy polecenia, aby zlokalizować moduł w repozytorium. Istnieje możliwość, że nazwa polecenia istnieje w wielu nazwach modułów.
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 PSGalleryFind-Command używa parametru Repository do przeszukiwania bazy danych PSGallery. Parametr Name określa polecenie Get-TargetResource.
Przykład 2. Znajdowanie poleceń według nazwy i instalowanie modułu
Find-Command może zlokalizować polecenie i moduł, a następnie wysłać obiekt do Install-Moduleobiektu . Jeśli polecenie jest zawarte w wielu modułach, użyj parametru Find-CommandModuleName poleceń cmdlet.
W przeciwnym razie moduły mogą być zainstalowane, których nie chcesz instalować.
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 używa parametru Name , aby określić polecenie Get-TargetResource. Parametr Repozytoriumwyszukuje plik PSGallery. Parametr ModuleName określa moduł, który chcesz zainstalować , SystemLocaleDsc. Obiekt jest wysyłany w dół potoku do Install-Module , a moduł jest zainstalowany. Po zakończeniu instalacji można użyć Get-InstalledModule polecenia , aby wyświetlić wyniki.
Przykład 3. Znajdowanie polecenia i zapisywanie modułu
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 używa parametrów Nazwa i Repozytorium , aby wyszukać polecenie Invoke-ScriptAnalyzer w repozytorium PSGallery . Obiekt jest wysyłany w dół potoku do Save-Module. Parametr Path określa lokalizację do zapisania modułu. Pełne jest opcjonalnym parametrem, ale wyświetla dane wyjściowe stanu w konsoli programu PowerShell. Pełne dane wyjściowe są korzystne dla rozwiązywania problemów.
Parametry
-AllowPrerelease
Zawiera moduły oznaczone jako wersję wstępną w wynikach.
Polecenie cmdlet serwera proxy mapuje ten parametr na parametr wersji wstępnej .Find-PSResource
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Określa nazwę polecenia do wyszukania w repozytorium. Użyj przecinków, aby oddzielić tablicę nazw poleceń.
Polecenie cmdlet serwera proxy mapuje ten parametr na parametr CommandName polecenia Find-PSResource.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Określa repozytorium do wyszukiwania poleceń. Użyj przecinków, aby oddzielić tablicę nazw repozytoriów. Wartość domyślna to wszystkie repozytoria.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr CommandNameParameterSet klasy Find-PSResource.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wyjściowe
PSGetCommandInfo
Find-Command zwraca obiekt PSGetCommandInfo .
Uwagi
Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Należy użyć protokołu TLS 1.2 lub nowszego. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
