다음을 통해 공유


Find-Command

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

구문

All

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
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Filter

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MaximumVersion

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

매개 변수 속성

형식:Version
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MinimumVersion

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

매개 변수 속성

형식:Version
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ModuleName

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Proxy

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

매개 변수 속성

형식:Uri
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ProxyCredential

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

매개 변수 속성

형식:PSCredential
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Repository

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RequiredVersion

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

매개 변수 속성

형식:Version
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Tag

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

출력

PSGetCommandInfo

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