다음을 통해 공유


Find-Module

리포지토리에서 지정된 조건과 일치하는 모듈을 찾습니다.

Syntax

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>]

Description

cmdlet은 Find-Module 지정된 조건과 일치하는 리포지토리에서 모듈을 찾습니다. Find-Module 는 찾은 각 모듈에 대해 PSRepositoryItemInfo 개체를 반환합니다. 개체는 파이프라인 아래로 와 같은 cmdlet으로 Install-Module보낼 수 있습니다.

Microsoft.PowerShell.PSResourceGetFind-PSResource cmdlet에 대한 프록시 cmdlet입니다. 자세한 내용은 Find-PSResource를 참조하세요.

예제

예제 1: 이름으로 모듈 찾기

이 예제에서는 기본 리포지토리에서 모듈을 찾습니다.

Find-Module -Name PowerShellGet

Version   Name              Repository           Description
-------   ----              ----------           -----------
2.1.0     PowerShellGet     PSGallery            PowerShell module with commands for discovering...

cmdlet은 Find-ModuleName 매개 변수를 사용하여 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

cmdlet은 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...

cmdlet은 Find-ModuleName 매개 변수를 사용하여 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...

cmdlet은 Find-ModuleName 매개 변수를 사용하여 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...

cmdlet은 Register-PSRepository 새 리포지토리를 등록합니다. Name 매개 변수는 MySource라는 이름을 할당합니다. SourceLocation 매개 변수는 리포지토리의 주소를 지정합니다.

cmdlet은 Find-Module 별표(*) 와일드카드와 함께 Name 매개 변수를 사용하여 Contoso 모듈을 지정합니다. 리포지토리 매개 변수는 PSGalleryMySource의 두 리포지토리를 검색하도록 지정합니다.

예제 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...

cmdlet은 Find-Module리포지토리 매개 변수를 사용하여 리포지토리 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...

cmdlet은 Find-ModuleFilter 매개 변수를 사용하여 AppDomain에 대한 리포지토리를 검색합니다.

예제 9: 태그로 모듈 찾기

이 예제에서는 태그로 모듈을 찾는 방법을 보여 줍니다. 값은 CrescendoBuiltMicrosoft.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

시험판으로 표시된 결과 모듈에 포함됩니다.

프록시 cmdlet은 이 매개 변수를 의 Prerelease 매개 변수에 Find-PSResource매핑합니다.

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

-AllVersions

결과에 모듈의 모든 버전을 포함하도록 지정합니다. MinimumVersion, MaximumVersion 또는 RequiredVersion 매개 변수에는 AllVersions 매개 변수를 사용할 수 없습니다.

프록시 cmdlet은 를 호출Find-PSResource하기 전에 이 매개 변수를 로 -Version * 변환합니다.

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

-Command

프록시 cmdlet은 의 NameParameterSetFind-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

프록시 cmdlet은 의 NameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.

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

-Filter

프록시 cmdlet은 의 NameParameterSetFind-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

프록시 cmdlet은 의 NameParameterSetFind-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

프록시 cmdlet은 이 매개 변수의 값을 사용하여 의 Version 매개 변수 Find-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.

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

-MinimumVersion

프록시 cmdlet은 이 매개 변수의 값을 사용하여 의 Version 매개 변수 Find-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.

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

프록시 cmdlet은 의 NameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.

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

-ProxyCredential

프록시 cmdlet은 의 NameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.

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

-Repository

리포지토리 매개 변수를 사용하여 모듈을 검색할 리포지토리를 지정합니다. 여러 리포지토리가 등록될 때 사용됩니다. 쉼표로 구분된 리포지토리 목록을 허용합니다. 리포지토리를 등록하려면 를 사용합니다 Register-PSRepository. 등록된 리포지토리를 표시하려면 를 사용합니다 Get-PSRepository.

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

-RequiredVersion

프록시 cmdlet은 이 매개 변수의 값을 사용하여 의 Version 매개 변수 Find-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.

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

-RoleCapability

프록시 cmdlet은 의 NameParameterSetFind-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 개체를 와 같은 cmdlet으로 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