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. Поиск модуля в определенном репозитории

В этом примере используется параметр Repository для поиска модуля в определенном репозитории.

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 . Параметр Repository указывает на поиск в репозитории 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 . Параметр Repository указывает на поиск в двух репозиториях: PSGallery и MySource.

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

Эта команда возвращает модули, содержащие ресурсы DSC. Параметр Includes имеет четыре предопределенные функции, которые используются для поиска в репозитории. Используйте tab-complete для отображения четырех функций, поддерживаемых параметром Includes .

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 использует параметр Repository для поиска в репозитории PSGallery. Параметр Includes указывает DscResource, который является функцией, которую параметр может искать в репозитории.

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

В этом примере для поиска модулей используется фильтр для поиска в репозитории.

Для репозитория на основе NuGet параметр Filter выполняет поиск аргумента по имени, описанию и тегам.

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllVersions

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DscResource

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeDependencies

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Includes

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

Type:	String[]
Accepted values:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MinimumVersion

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-Proxy

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

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ProxyCredential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Repository

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredVersion

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RoleCapability

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Указывает массив тегов. Примеры тегов включают DesiredStateConfiguration, DSC, DSCResourceKit или PSModule.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

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

Примечания

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

Обратная связь

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