다음을 통해 공유


Show-Command

그래픽 창에 PowerShell 명령 정보를 표시합니다.

구문

Show-Command
    [[-Name] <String>]
    [-Height <Double>]
    [-Width <Double>]
    [-NoCommonParameter]
    [-ErrorPopup]
    [-PassThru]
    [<CommonParameters>]

Description

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

Show-Command cmdlet을 사용하면 명령 창에서 PowerShell 명령을 만들 수 있습니다. 명령 창의 기능을 사용하여 명령을 실행하거나 명령을 반환하도록 할 수 있습니다.

Show-Command 매우 유용한 교육 및 학습 도구입니다. Show-Command cmdlet, 함수, 워크플로 및 CIM 명령을 비롯한 모든 명령 형식에서 작동합니다.

매개 변수가 없으면 Show-Command 설치된 모든 모듈에서 사용 가능한 모든 명령을 나열하는 명령 창을 표시합니다. 모듈에서 명령을 찾으려면 모듈 드롭다운 목록에서 모듈을 선택합니다. 명령을 선택하려면 명령 이름을 클릭합니다.

명령 창을 사용하려면 이름을 사용하거나 명령 목록에서 명령 이름을 클릭하여 명령을 선택합니다. 각 매개 변수 집합은 별도의 탭에 표시됩니다. 별표는 필수 매개 변수를 나타냅니다. 매개 변수의 값을 입력하려면 텍스트 상자에 값을 입력하거나 드롭다운 상자에서 값을 선택합니다. 스위치 매개 변수를 추가하려면 클릭하여 매개 변수 확인란을 선택합니다.

준비가 되면 복사 클릭하여 만든 명령을 클립보드에 복사하거나 실행 클릭하여 명령을 실행할 수 있습니다. PassThru 매개 변수를 사용하여 PowerShell 콘솔과 같은 호스트 프로그램에 명령을 반환할 수도 있습니다. 명령 선택을 취소하고 모든 명령을 표시하는 보기로 돌아가려면 Ctrl 키를 누른 다음 선택한 명령을 클릭합니다.

PowerShell ISE(통합 스크립팅 환경)에서는 기본적으로 Show-Command 창의 변형이 표시됩니다. 이 명령 창 사용에 대한 자세한 내용은 PowerShell ISE 도움말 항목을 참조하세요.

이 cmdlet은 PowerShell 7에서 다시 도입되었습니다.

이 cmdlet에는 사용자 인터페이스가 필요하므로 Windows Server Core 또는 Windows Nano Server에서는 작동하지 않습니다. 이 cmdlet은 Windows 데스크톱을 지원하는 Windows 시스템에서만 사용할 수 있습니다.

예제

예제 1: 명령 창 열기

다음은 Show-Command 창의 기본 보기를 표시하는 예제입니다. 명령 창에는 컴퓨터에 설치된 모든 모듈의 모든 명령 목록이 표시됩니다.

Show-Command

예제 2: 명령 창에서 cmdlet 열기

다음은 명령 창에 Invoke-Command cmdlet을 표시하는 예제입니다. 이 표시를 사용하여 Invoke-Command 명령을 실행할 수 있습니다.

Show-Command -Name "Invoke-Command"

예제 3: 지정된 매개 변수를 사용하여 cmdlet 열기

이 명령은Connect-PSSessioncmdlet에 대한 Show-Command 창을 엽니다.

Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

HeightWidth 매개 변수는 명령 창의 차원을 지정합니다. ErrorPopup 매개 변수는 오류 명령 창을 표시합니다.

실행클릭하면 명령줄에 Connect-PSSession 명령을 입력한 것처럼 Connect-PSSession 명령이 실행됩니다.

예제 4: cmdlet에 대한 새 기본 매개 변수 값 지정

이 예제에서는 $PSDefaultParameterValues 자동 변수를 사용하여 Show-Command cmdlet의 Height, WidthErrorPopup 매개 변수에 대한 새 기본값을 설정합니다.

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $true
}

이제 Show-Command 명령을 실행하면 새 기본값이 자동으로 적용됩니다. 모든 PowerShell 세션에서 이러한 기본값을 사용하려면 powerShell 프로필에 $PSDefaultParameterValues 변수를 추가합니다. 자세한 내용은 about_Profilesabout_Parameters_Default_Values참조하세요.

예제 5: 그리드 보기로 출력 보내기

이 명령은 Show-CommandOut-GridView cmdlet을 함께 사용하는 방법을 보여 줍니다.

Show-Command Get-ChildItem | Out-GridView

이 명령은 Show-Command cmdlet을 사용하여Get-ChildItemcmdlet에 대한 명령 창을 엽니다. 실행 단추를 클릭하면 Get-ChildItem 명령이 실행되고 출력이 생성됩니다. 파이프라인 연산자(| )는 Get-ChildItem 명령의 출력을 대화형 창에 Get-ChildItem 출력을 표시하는 Out-GridView cmdlet으로 보냅니다.

예제 6: 명령 창에서 만든 명령 표시

이 예제에서는 Show-Command 창에서 만든 명령을 보여줍니다. 이 명령은 Show-Command 결과를 문자열로 반환하는 PassThru 매개 변수를 사용합니다.

Show-Command -PassThru

Get-EventLog -LogName "Windows PowerShell" -Newest 5

예를 들어 Show-Command 창을 사용하여 Windows PowerShell 이벤트 로그에서 5개의 최신 이벤트를 가져오는 Get-EventLog 명령을 만든 다음 확인클릭하면 위에 표시된 출력이 반환됩니다. 명령 문자열을 보면 PowerShell을 학습하는 데 도움이 됩니다.

예제 7: 변수에 명령 저장

이 예제에서는 Show-Command cmdlet의 PassThru 매개 변수를 사용할 때 가져오는 명령 문자열을 실행하는 방법을 보여줍니다. 이 전략을 사용하면 명령을 보고 사용할 수 있습니다.

$C = Show-Command -PassThru
$C
Invoke-Expression $C

Get-EventLog -LogName "PowerShell" -Newest 5

Index Time          EntryType   Source                 InstanceID Message
----- ----          ---------   ------                 ---------- -------
11520 Dec 16 16:37  Information Windows PowerShell            400 Engine state is changed from None to Available...
11519 Dec 16 16:37  Information Windows PowerShell            600 Provider "Variable" is Started. ...
11518 Dec 16 16:37  Information Windows PowerShell            600 Provider "Registry" is Started. ...
11517 Dec 16 16:37  Information Windows PowerShell            600 Provider "Function" is Started. ...
11516 Dec 16 16:37  Information Windows PowerShell            600 Provider "FileSystem" is Started. ...

첫 번째 명령은 Show-Command cmdlet의 PassThru 매개 변수를 사용하고 명령 결과를 $C 변수에 저장합니다. 이 경우 Show-Command 창을 사용하여 Windows PowerShell 이벤트 로그에서 5개의 최신 이벤트를 가져오는 Get-EventLog 명령을 만듭니다. 확인클릭하면 Show-Command$C 변수에 저장된 명령 문자열을 반환합니다.

예제 8: 명령의 출력을 변수에 저장

이 예제에서는 ErrorPopup 매개 변수를 사용하여 명령의 출력을 변수에 저장합니다.

$P = Show-Command Get-Process -ErrorPopup
$P

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    473      33    94096     112532   709     2.06   4492 powershell

창에 오류를 표시하는 것 외에도 ErrorPopup 새 명령을 만드는 대신 명령 출력을 현재 명령으로 반환합니다. 이 명령을 실행하면 Show-Command 창이 열립니다. 창 기능을 사용하여 매개 변수 값을 설정할 수 있습니다. 명령을 실행하려면 Show-Command 창에서 실행 단추를 클릭합니다.

매개 변수

-ErrorPopup

명령줄에 오류를 표시하는 것 외에도 cmdlet이 팝업 창에 오류를 표시한다는 것을 나타냅니다. 기본적으로 Show-Command 창에서 실행되는 명령이 오류를 생성하면 명령줄에만 오류가 표시됩니다.

또한 명령을 실행할 때(Show-Command 창에서 실행 단추를 사용하여) ErrorPopup 매개 변수는 명령을 실행하고 출력을 새 명령으로 반환하는 대신 명령 결과를 현재 명령으로 반환합니다. 이 기능을 사용하여 명령 결과를 변수에 저장할 수 있습니다.

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

-Height

Show-Command 창의 높이를 픽셀 단위로 지정합니다. 화면 해상도에서 300과 픽셀 수 사이의 값을 입력합니다. 값이 너무 커서 화면에 명령 창이 표시되지 않으면 Show-Command 오류가 발생합니다. 기본 높이는 600픽셀입니다. Name 매개 변수를 포함하는 Show-Command 명령의 경우 기본 높이는 300픽셀입니다.

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

-Name

지정된 명령에 대한 명령 창을 표시합니다. cmdlet, 함수 또는 CIM 명령의 이름과 같은 한 명령의 이름을 입력합니다. 이 매개 변수를 생략하면 Show-Command 컴퓨터에 설치된 모든 모듈의 모든 PowerShell 명령을 나열하는 명령 창을 표시합니다.

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

-NoCommonParameter

이 cmdlet은 명령 표시의 공통 매개 변수 섹션을 생략했음을 나타냅니다. 기본적으로 공통 매개 변수는 명령 창 아래쪽의 확장 가능한 섹션에 표시됩니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다. 명령 문자열을 실행하려면 명령 프롬프트에 복사하여 붙여넣거나 변수에 저장하고 Invoke-Expression cmdlet을 사용하여 변수에서 문자열을 실행합니다.

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

-Width

Show-Command 창의 너비를 픽셀 단위로 지정합니다. 화면 해상도에서 300과 픽셀 수 사이의 값을 입력합니다. 값이 너무 커서 화면에 명령 창이 표시되지 않으면 Show-Command 오류가 발생합니다. 기본 너비는 300픽셀입니다.

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

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

String

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 명령 문자열을 반환합니다.

Object

ErrorPopup 매개 변수를 사용하는 경우 이 cmdlet은 명령 출력(모든 개체)을 반환합니다.

참고

PowerShell에는 Show-Command다음과 같은 별칭이 포함되어 있습니다.

  • Windows:
    • shcm

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

Show-Command 원격 세션에서 작동하지 않습니다.