다음을 통해 공유


Find-Command

모듈에서 PowerShell 명령을 찾습니다.

구문

Find-Command
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-AllVersions]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

Find-Command cmdlet은 cmdlet, 별칭, 함수 및 워크플로와 같은 PowerShell 명령을 찾습니다. Find-Command 등록된 리포지토리에서 모듈을 검색합니다.

Find-Command찾은 각 명령에 대해 PSGetCommandInfo 개체가 반환됩니다. PSGetCommandInfo 개체는 파이프라인을 Install-Module cmdlet으로 보낼 수 있습니다. Install-Module 명령이 포함된 모듈을 설치합니다.

예제

예제 1: 지정된 리포지토리에서 모든 명령 찾기

Find-Command cmdlet은 등록된 리포지토리에서 모듈을 검색합니다.

Find-Command -Repository PSGallery | Select-Object -First 10

Name                                Version    ModuleName          Repository
----                                -------    ----------          ----------
Disable-AzureRmDataCollection       5.8.3      AzureRM.profile     PSGallery
Disable-AzureRmContextAutosave      5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmDataCollection        5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmContextAutosave       5.8.3      AzureRM.profile     PSGallery
Remove-AzureRmEnvironment           5.8.3      AzureRM.profile     PSGallery
Get-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Set-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Add-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Get-AzureRmSubscription             5.8.3      AzureRM.profile     PSGallery
Connect-AzureRmAccount              5.8.3      AzureRM.profile     PSGallery

Find-Command 리포지토리 매개 변수를 사용하여 등록된 리포지토리의 이름을 지정합니다. 개체가 파이프라인 아래로 전송됩니다. Select-Object 개체를 수신하고 First 매개 변수를 사용하여 처음 10개의 결과를 표시합니다.

예제 2: 이름으로 명령 찾기

Find-Command 명령의 이름을 사용하여 리포지토리에서 모듈을 찾을 수 있습니다. 여러 ModuleNames명령 이름이 있을 수 있습니다.

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명령을 지정합니다.

예제 3: 이름으로 명령 찾기 및 모듈 설치

Find-Command 명령 및 모듈을 찾은 다음 개체를 Install-Module보낼 수 있습니다. 명령이 여러 모듈에 포함된 경우 module-Name 매개 변수를 cmdlet을 사용합니다. 그렇지 않으면 설치하지 않으려는 모듈이 설치될 수 있습니다.

PS> Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
    Install-Module

PS> Get-InstalledModule

Version   Name               Repository   Description
-------   ----               ----------   -----------
1.2.0.0   SystemLocaleDsc    PSGallery    This DSC Resource allows configuration of the Windows...

Name 매개 변수를 사용하여 Get-TargetResource명령을 지정합니다. 리포지토리 매개 변수는 PSGallery검색합니다. ModuleName 매개 변수는 SystemLocaleDsc설치하려는 모듈을 지정합니다. 개체가 파이프라인 아래로 전송되어 Install-Module 모듈이 설치됩니다. 설치가 완료되면 Get-InstalledModule 사용하여 결과를 표시할 수 있습니다.

예제 4: 명령 찾기 및 모듈 저장

PS> 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'.

이름리포지토리 매개 변수를 사용하여 PSGallery 리포지토리에서 Invoke-ScriptAnalyzer 명령을 검색합니다. 개체가 파이프라인 아래로 전송되어 Save-Module. Path 매개 변수는 모듈을 저장할 위치를 결정합니다. 자세한 정보 표시 선택적 매개 변수이지만 PowerShell 콘솔에 상태 출력을 표시합니다. 자세한 정보 출력은 문제 해결에 유용합니다.

매개 변수

-AllVersions

이 cmdlet은 모듈의 모든 버전을 가져옵니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Filter

PackageManagement 공급자의 검색 구문을 기반으로 모듈을 찾습니다. 예를 들어 ModuleNameDescription 속성 내에서 검색할 단어를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MaximumVersion

결과에 포함할 모듈의 최대 버전을 지정합니다. MaximumVersionRequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.

형식:Version
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MinimumVersion

결과에 포함할 모듈의 최소 버전을 지정합니다. MinimumVersionRequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.

형식:Version
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ModuleName

명령을 검색할 모듈의 이름을 지정합니다. 기본값은 모든 모듈입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

리포지토리에서 검색할 명령 이름을 지정합니다. 쉼표로 명령 이름 배열을 구분합니다.

형식:String[]
Position:0
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Proxy

인터넷 리소스에 대한 직접 연결이 아닌 요청에 대한 프록시 서버를 지정합니다.

형식:Uri
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ProxyCredential

Proxy 매개 변수로 지정된 프록시 서버를 사용할 수 있는 권한이 있는 사용자 계정을 지정합니다.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Repository

명령을 검색할 리포지토리를 지정합니다. 쉼표로 리포지토리 이름 배열을 구분합니다. 기본값은 모든 리포지토리입니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RequiredVersion

결과에 포함할 모듈의 버전을 지정합니다.

형식:Version
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Tag

리포지토리에서 모듈을 분류하는 태그를 지정합니다. 쉼표를 사용하여 태그 배열을 구분합니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

PSGetCommandInfo

Find-Command PSGetCommandInfo 개체를 출력합니다.