Find-Module
Находит модули в репозитории, который соответствует указанным критериям.
Синтаксис
All
Find-Module
[[-Name] <string[]>]
[-MinimumVersion <string>]
[-MaximumVersion <string>]
[-RequiredVersion <string>]
[-AllVersions]
[-IncludeDependencies]
[-Filter <string>]
[-Tag <string[]>]
[-Includes <string[]>]
[-DscResource <string[]>]
[-RoleCapability <string[]>]
[-Command <string[]>]
[-Proxy <uri>]
[-ProxyCredential <pscredential>]
[-Repository <string[]>]
[-Credential <pscredential>]
[-AllowPrerelease]
[<CommonParameters>]
Описание
Командлет Find-Module находит модули в репозитории, соответствующие указанным критериям.
Find-Module возвращает объект PSRepositoryItemInfo для каждого модуля, который он находит. Объекты можно отправлять по конвейеру командлетам, таким как Install-Module.
При первом Find-Module попытке использовать репозиторий может потребоваться установить обновления.
Если источник репозитория не зарегистрирован в Register-PSRepository командлете, возвращается ошибка.
Find-Module возвращает последнюю версию модуля, если параметры не используются, ограничивающие версию. Чтобы получить список версий модуля репозитория, используйте параметр AllVersions.
Если указан параметр MinimumVersion , возвращает версию модуля, Find-Module которая равна минимальному или больше. Если в репозитории доступна более новая версия, возвращается новая версия.
Если указан параметр MaximumVersion , Find-Module возвращает последнюю версию модуля, которая не превышает указанную версию.
Если указан параметр RequiredVersion , Find-Module возвращается только версия модуля, которая соответствует указанной версии.
Find-Module выполняет поиск по всем доступным модулям, так как могут возникать конфликты имен между источниками.
Параметры, которые принимают номера версий модуля, ожидают строки, отформатированные как номера версий.
- Номера стандартных версий имеют формат
x.y.z, в котором x, y и z являются числами - Предварительные версии имеют формат
x.y.z-<prerelease_label>, в котором<prerelease_label>является произвольная строка, назначенная данному выпуску.
В следующих примерах коллекция PowerShell используется в качестве единственного зарегистрированного репозитория.
Get-PSRepository отображает зарегистрированные репозитории. Если у вас несколько зарегистрированных репозиториев, используйте -Repository этот параметр, чтобы указать имя репозитория.
Примеры
Пример 1. Поиск модуля по имени
Этот пример находит модуль в репозитории по умолчанию.
Find-Module -Name PowerShellGet
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Командлет Find-Module использует параметр Name для указания модуля PowerShellGet .
Пример 2. Поиск модулей с похожими именами
В этом примере используется подстановочный знак звездочки (*) для поиска модулей с аналогичными именами.
Find-Module -Name PowerShell*
Version Name Repository Description
------- ---- ---------- -----------
0.4.0 powershell-yaml PSGallery Powershell module for serializing and...
2.1.0 PowerShellGet PSGallery PowerShell module with commands for...
1.9 Powershell.Helper.Extension PSGallery # Powershell.Helper.Extension...
3.1 PowerShellHumanizer PSGallery PowerShell Humanizer wraps Humanizer...
4.0 PowerShellISEModule PSGallery a module that adds capability to the ISE
Командлет Find-Module использует параметр Name со звездочкой (*) для поиска всех модулей, содержащих PowerShell.
Пример 3. Поиск модуля по минимальной версии
В этом примере выполняется поиск минимальной версии модуля. Если репозиторий содержит более новую версию модуля, возвращается новая версия.
Find-Module -Name PowerShellGet -MinimumVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Командлет Find-Module использует параметр Name для указания модуля PowerShellGet .
MinimumVersion указывает версию 1.6.5.
Find-Module возвращает PowerShellGet версии 2.1.0 , так как она превышает минимальную версию и является самой текущей.
Пример 4. Поиск модуля по определенной версии
В этом примере показано, как установить определенную предварительную версию модуля. Предварительные версии имеют формат <version_number>-<prerelease_label>.
Find-Module PSReadLine -AllowPrerelease -RequiredVersion 2.2.4-beta1
Version Name Repository Description
------- ---- ---------- -----------
2.2.4-beta1 PSReadLine PSGallery Great command line editing in the PowerS…
Пример 5. Поиск модуля в определенном репозитории
В этом примере используется параметр репозитория для поиска модуля в определенном репозитории.
Find-Module -Name PowerShellGet -Repository PSGallery
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Командлет Find-Module использует параметр Name для указания модуля PowerShellGet . Параметр репозитория указывает для поиска репозитория PSGallery .
Пример 6. Поиск модуля в нескольких репозиториях
В этом примере используется Register-PSRepository для указания репозитория.
Find-Module использует репозиторий для поиска модуля.
Register-PSRepository -Name MySource -SourceLocation https://www.myget.org/F/powershellgetdemo/
Find-Module -Name Contoso* -Repository PSGallery, MySource
Repository Version Name Description
---------- ------- ---- -----------
PSGallery 2.0.0.0 ContosoServer Cmdlets and DSC resources for managing Contoso Server...
MySource 1.2.0.0 ContosoClient Cmdlets and DSC resources for managing Contoso Client...
Командлет Register-PSRepository регистрирует новый репозиторий. Параметр Name присваивает имя MySource. Параметр SourceLocation указывает адрес репозитория.
Командлет Find-Module использует параметр Name со звездочкой (*) для указания модуля Contoso . Параметр репозитория указывает для поиска двух репозиториев, PSGallery и MySource.
Пример 7. Поиск модуля, содержащего ресурс DSC
Эта команда возвращает модули, содержащие ресурсы DSC. Параметр "Включает" имеет четыре предопределенных функциональных возможностей, которые используются для поиска в репозитории. С помощью вкладки можно отобразить четыре функциональные возможности, поддерживаемые параметром "Включить ".
Find-Module -Repository PSGallery -Includes DscResource
Version Name Repository Description
------- ---- ---------- -----------
2.7.0 Carbon PSGallery Carbon is a PowerShell module...
8.5.0.0 xPSDesiredStateConfiguration PSGallery The xPSDesiredStateConfiguration module...
1.3.1 PackageManagement PSGallery PackageManagement (a.k.a. OneGet) is...
2.7.0.0 xWindowsUpdate PSGallery Module with DSC Resources...
3.2.0.0 xCertificate PSGallery This module includes DSC resources...
3.1.0.0 xPowerShellExecutionPolicy PSGallery This DSC resource can change the user...
Командлет Find-Module использует параметр репозитория для поиска репозитория PSGallery.
Параметр "Включает " указывает DscResource, который является функциональностью, которую параметр может выполнять поиск в репозитории.
Пример 8. Поиск модуля с фильтром
В этом примере для поиска модулей используется фильтр для поиска репозитория.
Для репозитория на основе NuGet параметр фильтра выполняет поиск по имени, описанию и тегам аргумента.
Find-Module -Filter AppDomain
Version Name Repository Description
------- ---- ---------- -----------
1.0.0.0 AppDomainConfig PSGallery Manipulate AppDomain configuration...
1.1.0 ClassExplorer PSGallery Quickly search the AppDomain for classes...
Командлет Find-Module использует параметр Filter для поиска репозитория для AppDomain.
Пример 9. Поиск модуля по тегу
В этом примере показано, как найти модули по тегу. Значением CrescendoBuilt является тег, который автоматически добавляется в модули, созданные с помощью модуля Microsoft.PowerShell.Crescendo .
Find-Module -Tag CrescendoBuilt
Version Name Repository Description
------- ---- ---------- -----------
0.1.0 Foil PSGallery A PowerShell Crescendo wrapper for Chocolatey
0.3.1 Cobalt PSGallery A PowerShell Crescendo wrapper for WinGet
1.1.0 SysInternals PSGallery PowerShell cmdlets for SysInternal tools
0.0.4 Croze PSGallery A PowerShell Crescendo wrapper for Homebrew
0.0.2 AptPackage PSGallery PowerShell Crescendo-generated Module to query APT-Package Information
1.0.1 RoboCopy PSGallery PowerShell cmdlet for the official RoboCopy.exe
1.0.2 TShark PSGallery PowerShell cmdlet for tshark.exe
1.0.0 SpeedTestCLI PSGallery PowerShell cmdlets speedtest-cli
1.0.0 SpeedTest-CLI PSGallery PowerShell cmdlets for Internet Speed Test
1.0.2 Image2Text PSGallery PowerShell Images into ASCII art
0.1.1 Quser.Crescendo PSGallery This module displays session information of users logged onto a local or remote m...
1.0.2 Takeown PSGallery Crescendo Powershell wrapper of takeown.exe
Параметры
-AllowPrerelease
Включает в модули результатов, помеченные как предварительный выпуск.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AllVersions
Указывает, чтобы включить все версии модуля в результаты. Параметр AllVersions нельзя использовать с параметрами MinimumVersion, MaximumVersion или RequiredVersion .
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Command
Задает массив команд для поиска в модулях. Команда может быть функцией или рабочим процессом.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, которая имеет права на установку модуля для указанного поставщика пакетов или источника.
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-DscResource
Указывает имя или часть имени модулей, содержащих ресурсы DSC. Для соглашений PowerShell выполняется поиск ИЛИ при предоставлении нескольких аргументов.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Filter
Задает фильтр на основе синтаксиса поиска для конкретного поставщика PackageManagement . Для модулей NuGet этот параметр эквивалентен поиску с помощью панели поиска на веб-сайте коллекции PowerShell .
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeDependencies
Указывает, что эта операция включает все модули, зависящие от модуля, указанного в параметре Name .
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Includes
Возвращает только те модули, которые включают определенные типы функций PowerShell. Например, может потребоваться найти только модули, включающие DSCResource. Допустимые значения для этого параметра приведены следующим образом:
- cmdlet
- DscResource
- Функция
- RoleCapability
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Принимаемые значения: | DscResource, Cmdlet, Function, RoleCapability |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MaximumVersion
Указывает максимальную или последнюю версию модуля, включаемую в результаты поиска. MaximumVersion и RequiredVersion нельзя использовать в той же команде.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-MinimumVersion
Указывает минимальную версию модуля, включаемую в результаты. MinimumVersion и RequiredVersion нельзя использовать в той же команде.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имена модулей для поиска в репозитории. Принимается разделенный запятыми список имен модулей. Подстановочные знаки принимаются.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | True |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | 0 |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Proxy
Указывает прокси-сервер для запроса, а не подключение непосредственно к интернет-ресурсу.
Свойства параметров
| Тип: | Uri |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ProxyCredential
Указывает учетную запись пользователя, которая имеет разрешение на использование прокси-сервера, указанного параметром Proxy .
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Repository
Используйте параметр репозитория , чтобы указать, какой репозиторий будет искать модуль. Используется при регистрации нескольких репозиториев. Принимает разделенный запятыми список репозиториев. Чтобы зарегистрировать репозиторий, используйте Register-PSRepository. Чтобы отобразить зарегистрированные репозитории, используйте Get-PSRepository.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RequiredVersion
Указывает точный номер версии модуля для включения в результаты. RequiredVersion нельзя использовать в той же команде, что и MinimumVersion или MaximumVersion.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-RoleCapability
Задает массив возможностей ролей.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Tag
Задает массив тегов. Примеры тегов: DesiredStateConfiguration, DSC, DSCResourceKit или PSModule.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входы
String
String
Uri
PSCredential
Выходы
PSRepositoryItemInfo
Find-Module создает объекты PSRepositoryItemInfo , которые можно отправить по конвейеру командлетам, таким как Install-Module.
Примечания
PowerShell включает следующие псевдонимы для Find-Module:
- Все платформы:
fimo
Это важно
По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Дополнительные сведения см. в объявления
