Show-Command

참조

모듈:: Microsoft.PowerShell.Utility

그래픽 명령 창에서 Windows PowerShell 명령을 만듭니다.

Syntax

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

Description

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

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

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

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

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

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

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

예제

예제 1: 명령 창 열기

PS C:\> Show-Command

이 명령은 Show-Command 창의 기본 뷰를 표시합니다. 명령 창에는 컴퓨터에 설치된 모든 모듈의 모든 명령 목록이 표시됩니다.

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

PS C:\> Show-Command -Name "Invoke-Command"

이 명령은 표시 명령 창에서 Invoke-Command cmdlet 표시를 엽니다. Invoke-Command 디스플레이를 사용하여 Invoke-Command 명령을 실행할 수 있습니다.

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

PS C:\> Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

이 명령은 Connect-PSSession cmdlet에 대한 Show-Command 창을 엽니다. Height 및 Width 매개 변수를 사용하여 명령 창의 치수를 지정하고 ErrorPopup 매개 변수를 사용하여 오류 명령 창을 표시합니다.

Run을 클릭하면 명령줄에서 Connect-PSSession 명령을 입력하는 경우와 마찬가지로 Connect-PSSession 명령이 실행됩니다.

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

PS C:\> $PSDefaultParameterValues = @{"Show-Command:Height" = 700; "Show-Command:Width" = 1000; "Show-Command:ErrorPopup" = $True}

이 명령은 $PSDefaultParameterValues 자동 변수를 사용하여 Show-Command cmdlet의 Height, Width 및 ErrorPopup 매개 변수에 대한 새로운 기본값을 설정합니다. 이제 Show-Command 명령을 실행하면 새 기본값이 자동으로 적용됩니다.

모든 Windows PowerShell 세션에서 이러한 기본값을 사용하려면 Windows PowerShell 프로필에 $PSDefaultParameterValues 변수를 추가합니다. 자세한 내용은 about_Profiles 및 about_Parameters_Default_Values 참조하세요.

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

PS C:\> Show-Command Get-ChildItem | Out-GridView

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

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

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

PS C:\> Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5

이 명령은 Show-Command 창에서 생성한 명령을 보여 줍니다. 명령은 문자열의 Show-Command 결과를 반환하는 PassThru 매개 변수를 사용합니다.

예를 들어 Show-Command 창을 사용하여 Windows PowerShell 이벤트 로그에서 5개의 최신 이벤트를 가져오는 Get-EventLog 명령을 만든 다음 확인을 클릭하면 명령이 다음 출력을 반환합니다.

명령 문자열을 보면 Windows PowerShell에 대해서도 쉽게 익숙해질 수 있습니다.

예제 7: 변수에 명령 저장

PS C:\> $C = Show-Command -PassThru

This command displays the command string in the $C variable.
PS C:\> $C
Get-EventLog -LogName "Windows PowerShell" -Newest 5

These commands use the Invoke-Expression cmdlet to run the string in the $C variable. The first command uses the full cmdlet name. The second command uses the "iex" alias for the **Invoke-Expression** cmdlet. These commands are equivalent and you can use them interchangeably.The output shows the five newest events in the Windows PowerShell event log.
PS C:\> Invoke-Expression $C

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

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

첫 번째 명령은 Show-Command cmdlet의 PassThru 매개 변수를 사용하여 명령의 결과를 $C 변수에 저장합니다.

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

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

PS C:\> $P = Show-Command Get-Process -ErrorPopup

The second command displays the value in the $P variable.
PS C:\> $P
Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName

-------  ------    -----      ----- -----   ------     -- -----------

    473      33    94096     112532   709     2.06   4492 powershell

이러한 명령은 Show-Command cmdlet의 ErrorPopup 매개 변수를 사용하여 명령의 출력을 변수에 저장합니다.

첫 번째 명령은 ErrorPopup 매개 변수와 함께 Show-Command cmdlet을 실행합니다. 창에서 오류를 표시할 수 있을 뿐 아니라 ErrorPopup은 새 명령을 만들지 않고 명령 출력을 현재 명령에 반환합니다.

이 명령을 실행하면 Show-Command 창이 열립니다. 창 기능을 사용하여 매개 변수 값을 설정할 수 있습니다. 명령을 실행하려면 Show-Command 창에서 Run 단추를 클릭합니다.

매개 변수

-ErrorPopup

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

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

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

-Height

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

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

-Name

지정된 명령에 대한 명령 창을 표시합니다. 한 명령의 이름(예: cmdlet, 함수, 워크플로 또는 CIM 명령의 이름)을 입력합니다. 이 매개 변수를 생략하면 Show-Command에서 컴퓨터에 설치된 모든 모듈의 Windows PowerShell 명령을 모두 나열하는 명령 창을 표시합니다.

Type:	String
Aliases:	CommandName
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoCommonParameter

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

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

문자열을 실행하려면 명령 프롬프트에서 해당 문자열을 복사하여 붙이거나 변수에 저장한 다음 Invoke-Expression cmdlet을 사용하여 변수에 문자열을 실행합니다.

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

-Width

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

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

입력

None

입력을 Show-Command로 파이프할 수 없습니다.

출력

System.String, System.Object

PassThru 매개 변수를 사용하면 Show-Command에서 명령 문자열을 반환합니다. ErrorPopup 매개 변수를 사용하면 Show-Command에서 명령 출력(개체)을 반환합니다. 그러지 않으면 Show-Command에서 어떤 출력도 생성하지 않습니다.

참고

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

다음을 통해 공유