Find-Module

Ссылка

Модуль:: PowerShellGet

Находит модули в репозитории, который соответствует указанным критериям.

Синтаксис

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-PSResource в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в разделе Find-PSResource.

Примеры

Пример 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

Включает в модули результатов, помеченные как предварительный выпуск.

Командлет прокси-сервера сопоставляет этот параметр с параметром Find-PSResourcePrerelease .

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AllVersions

Указывает, чтобы включить все версии модуля в результаты. Параметр AllVersions нельзя использовать с параметрами MinimumVersion, MaximumVersion или RequiredVersion .

Командлет прокси-сервера преобразует этот параметр в параметр перед вызовом -Version *Find-PSResource.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Command

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается набором NameParameterSetFind-PSResource.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает учетную запись пользователя, которая имеет права на установку модуля для указанного поставщика пакетов или источника.

Тип:	PSCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-DscResource

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Filter

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IncludeDependencies

Указывает, что эта операция включает все модули, зависящие от модуля, указанного в параметре Name .

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Includes

Тип:	String[]
Допустимые значения:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaximumVersion

Командлет прокси-сервера использует значение этого параметра для создания строки поиска версий NuGet для использования с параметром Find-PSResourceVersion.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-MinimumVersion

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Name

Указывает имена модулей для поиска в репозитории. Принимается разделенный запятыми список имен модулей. Подстановочные знаки принимаются.

Тип:	String[]
Position:	0
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	True

-Proxy

Тип:	Uri
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ProxyCredential

Тип:	PSCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Repository

Используйте параметр репозитория , чтобы указать, какой репозиторий будет искать модуль. Используется при регистрации нескольких репозиториев. Принимает разделенный запятыми список репозиториев. Чтобы зарегистрировать репозиторий, используйте Register-PSRepository. Чтобы отобразить зарегистрированные репозитории, используйте Get-PSRepository.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RequiredVersion

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-RoleCapability

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Tag

Задает массив тегов. Примеры тегов: DesiredStateConfiguration, DSC, DSCResourceKit или PSModule.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

String[]

String

Uri

PSCredential

Выходные данные

PSRepositoryItemInfo

Find-Module создает объекты PSRepositoryItemInfo , которые можно отправить по конвейеру командлетам, таким как Install-Module.

Примечания

PowerShell включает следующие псевдонимы для Find-Module:

Все платформы:
- fimo

Коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Необходимо использовать TLS 1.2 или более поздней версии. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:

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

Поделиться через

Find-Module

Синтаксис

Описание

Примеры

Пример 1. Поиск модуля по имени

Пример 2. Поиск модулей с похожими именами

Пример 3. Поиск модуля по минимальной версии

Пример 4. Поиск модуля по определенной версии

Пример 5. Поиск модуля в определенном репозитории

Пример 6. Поиск модуля в нескольких репозиториях

Пример 7. Поиск модуля, содержащего ресурс DSC

Пример 8. Поиск модуля с фильтром

Пример 9. Поиск модуля по тегу

Параметры

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Входные данные

Выходные данные

Примечания

Дополнительные ресурсы

Поделиться через

Find-Module

Синтаксис

Описание

Примеры

Пример 1. Поиск модуля по имени

Пример 2. Поиск модулей с похожими именами

Пример 3. Поиск модуля по минимальной версии

Пример 4. Поиск модуля по определенной версии

Пример 5. Поиск модуля в определенном репозитории

Пример 6. Поиск модуля в нескольких репозиториях

Пример 7. Поиск модуля, содержащего ресурс DSC

Пример 8. Поиск модуля с фильтром

Пример 9. Поиск модуля по тегу

Параметры

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Входные данные

Выходные данные

Примечания

Связанные ссылки

Дополнительные ресурсы