Udostępnij za pomocą

Find-Command

Moduł:
PowerShellGet Module

Znajduje polecenia programu PowerShell w modułach.

Składnia

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

Opis

Polecenie cmdlet Find-Command znajduje polecenia programu PowerShell, takie jak polecenia cmdlet, aliasy, funkcje i przepływy pracy. Find-Command wyszukuje moduły w zarejestrowanych repozytoriach.

Dla każdego polecenia znalezionego przez Find-Commandzwracany jest obiekt PSGetCommandInfo. Obiekt PSGetCommandInfo można wysłać w dół potoku do polecenia cmdlet Install-Module. Install-Module instaluje moduł zawierający polecenie .

Przykłady

Przykład 1. Znajdowanie wszystkich poleceń w określonym repozytorium

Polecenie cmdlet Find-Command wyszukuje zarejestrowane repozytorium dla modułów.

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

używa parametru repozytorium do określenia nazwy zarejestrowanego repozytorium. Obiekty są wysyłane w dół potoku. Select-Object odbiera obiekty i używa parametru First do wyświetlenia pierwszych 10 wyników.

Przykład 2. 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 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

używa parametru repozytorium do przeszukiwania PSGallery. Parametr Name określa polecenie Get-TargetResource.

Przykład 3. Znajdowanie poleceń według nazwy i instalowanie modułu

Find-Command można zlokalizować polecenie i moduł, a następnie wysłać obiekt do Install-Module. Jeśli polecenie znajduje się w wielu modułach, użyj parametru Find-CommandModuleName poleceń cmdlet. W przeciwnym razie moduły mogą być zainstalowane, których nie chcesz instalować.

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

Find-Command używa parametru Name , aby określić polecenie Get-TargetResource. Parametr Repository wyszukuje 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żesz użyć Get-InstalledModule, aby wyświetlić wyniki.

Przykład 4. Znajdowanie polecenia i zapisywanie modułu

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 Używa parametrów Name i Repository , aby wyszukać polecenie Invoke-ScriptAnalyzer w repozytorium PSGallery . Obiekt jest wysyłany w dół potoku do Save-Module. Parametr Path określa lokalizację zapisywania modułu. pełne jest opcjonalnym parametrem, ale wyświetla dane wyjściowe stanu w konsoli programu PowerShell. Pełne dane wyjściowe są przydatne do rozwiązywania problemów.

Parametry

-AllowPrerelease

Zawiera moduły oznaczone jako wersję wstępną w wynikach.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AllVersions

Wskazuje, że to polecenie cmdlet pobiera wszystkie wersje modułu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Filter

Znajduje moduły oparte na składni wyszukiwania dostawcy PackageManagement. Na przykład określ wyrazy do wyszukania w ModuleName i właściwości Description.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MaximumVersion

Określa maksymalną wersję modułu do uwzględnienia w wynikach. Nie można użyć parametrów MaximumVersion i parametrów RequiredVersion w tym samym poleceniu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MinimumVersion

Określa minimalną wersję modułu do uwzględnienia w wynikach. Parametrów MinimumVersion i RequiredVersion nie można użyć w tym samym poleceniu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ModuleName

Określa nazwę modułu do wyszukiwania poleceń. Wartość domyślna to wszystkie moduły.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwę polecenia do wyszukania w repozytorium. Użyj przecinków, aby oddzielić tablicę nazw poleceń.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:0
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Proxy

Określa serwer proxy dla żądania, a nie bezpośrednie połączenie z zasobem internetowym.

Właściwości parametrów

Typ:Uri
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do korzystania z serwera proxy określonego przez parametr proxy .

Właściwości parametrów

Typ:PSCredential
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Repository

Określa repozytorium do wyszukiwania poleceń. Użyj przecinków, aby oddzielić tablicę nazw repozytoriów. Wartość domyślna to wszystkie repozytoria.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RequiredVersion

Określa wersję modułu do uwzględnienia w wynikach.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Tag

Określa tagi, które kategoryzują moduły w repozytorium. Użyj przecinków, aby oddzielić tablicę tagów.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Obsługuje symbole wieloznaczne:False
Nie pokaż:False

Zestawy parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wyjść

PSGetCommandInfo

Find-Command generuje obiekt PSGetCommandInfo.

Notatki

Ważne

Od kwietnia 2020 r. galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do galerii programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz anons w blogu programu PowerShell.