Find-Command
Ищет команды PowerShell в модулях.
Синтаксис
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>]Описание
Командлет Find-Command находит команды PowerShell, такие как командлеты, псевдонимы, функции и рабочие процессы. Find-Command выполняет поиск модулей в зарегистрированных репозиториях.
Это прокси-командлет для командлета Find-PSResource в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в разделе Find-PSResource.
Примеры
Пример 1. Поиск команды по имени
Find-Command может использовать имя команды для поиска модуля в репозитории. Возможно, имя команды существует в нескольких именах модулей.
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 использует параметр Repository для поиска в PSGallery. Параметр Name указывает команду Get-TargetResource.
Пример 2. Поиск команд по имени и установка модуля
Find-Command может найти команду и модуль, а затем отправить объект в Install-Module. Если команда включена в несколько модулей, используйте Find-Command параметр ModuleName командлетов.
В противном случае могут быть установлены модули, которые вы не хотите устанавливать.
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 использует параметр Name для указания команды Get-TargetResource. Параметр Repository выполняет поиск в PSGallery. Параметр ModuleName указывает модуль, который требуется установить, SystemLocaleDsc. Объект отправляется по конвейеру Install-Module и устанавливается модуль. После завершения установки можно использовать для Get-InstalledModule отображения результатов.
Пример 3. Поиск команды и сохранение ее модуля
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 использует параметры Имя и Репозиторий для поиска команды Invoke-ScriptAnalyzer в репозитории PSGallery . Объект отправляется по конвейеру в .Save-Module Параметр Path определяет расположение для сохранения модуля. Verbose является необязательным параметром, но отображает выходные данные состояния в консоли PowerShell. Подробные выходные данные полезны для устранения неполадок.
Параметры
-AllowPrerelease
Включает в результаты модули, помеченные как предварительные выпуски.
Командлет прокси-сервера сопоставляет этот параметр с параметром prerelease объекта Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Указывает имя команды для поиска в репозитории. Используйте запятые для разделения массива имен команд.
Командлет прокси-сервера сопоставляет этот параметр с параметром CommandName объекта Find-PSResource.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Указывает репозиторий для поиска команд. Используйте запятые для разделения массива имен репозитория. Значение по умолчанию — все репозитории.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается CommandNameParameterSet .Find-PSResource
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Выходные данные
PSGetCommandInfo
Find-Command выводит объект PSGetCommandInfo .
Примечания
Коллекция PowerShell больше не поддерживает протокол TLS версий 1.0 и 1.1. Необходимо использовать TLS 1.2 или более поздней версии. Чтобы проверить, используется ли TLS 1.2, выполните следующую команду:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Связанные ссылки
PSResourceGet