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 PSGallery
Find-Command использует параметр репозитория для поиска 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. Параметр репозитория выполняет поиск в 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 определяет расположение для сохранения модуля.
Подробные сведения — это необязательный параметр, но отображает выходные данные состояния в консоли PowerShell. Подробные выходные данные полезны для устранения неполадок.
Параметры
-AllowPrerelease
Включает модули, помеченные как предварительная версия в результатах.
Командлет прокси-сервера сопоставляет этот параметр с параметром Find-PSResourcePrerelease .
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AllVersions
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Filter
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MaximumVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MinimumVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ModuleName
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Указывает имя команды для поиска в репозитории. Используйте запятые для разделения массива имен команд.
Командлет прокси-сервера сопоставляет этот параметр с параметром Find-PSResourceCommandName .
| Тип: | String[] |
| Position: | 0 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Proxy
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | Uri |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ProxyCredential
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Repository
Указывает репозиторий для поиска команд. Используйте запятые для разделения массива имен репозитория. По умолчанию используется все репозитории.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RequiredVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Tag
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором CommandNameParameterSetFind-PSResource.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | 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