다음을 통해 공유

Out-Host

  • 참조
모듈:
Microsoft.PowerShell.Core

명령줄에 출력을 보냅니다.

구문

Out-Host
   [-Paging]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Out-Host cmdlet은 표시를 위해 출력을 PowerShell 호스트로 보냅니다. 호스트는 명령줄에 출력을 표시합니다. Out-Host 기본값이므로 매개 변수를 사용하지 않는 한 지정할 필요가 없습니다.

Out-Host 실행되는 모든 명령에 자동으로 추가됩니다. 파이프라인의 출력을 명령을 실행하는 호스트에 전달합니다. Out-Host ANSI 이스케이프 시퀀스를 무시합니다. 이스케이프 시퀀스는 호스트에서 처리됩니다. Out-Host 해석하거나 변경하지 않고 ANSI 이스케이프 시퀀스를 호스트에 전달합니다.

예제

예제 1: 출력을 한 번에 한 페이지씩 표시

다음은 시스템이 한 번에 한 페이지를 처리하는 예제입니다.

Get-Process | Out-Host -Paging

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     30    24.12      36.95      15.86   21004  14 ApplicationFrameHost
     55    24.33      60.48      10.80   12904  14 BCompare
<SPACE> next page; <CR> next line; Q quit
      9     4.71       8.94       0.00   16864  14 explorer
<SPACE> next page; <CR> next line; Q quit

Get-Process 시스템 프로세스를 가져오고 개체를 파이프라인 아래로 보냅니다. Out-Host 페이징 매개 변수를 사용하여 한 번에 한 페이지의 데이터를 표시합니다.

예제 2: 변수를 입력으로 사용

이 예제에서는 변수에 저장된 개체를 Out-Host입력으로 사용합니다.

$io = Get-History
Out-Host -InputObject $io

Get-History PowerShell 세션의 기록을 가져오고 개체를 $io 변수에 저장합니다. Out-Host InputObject 매개 변수를 사용하여 $io 변수를 지정하고 기록을 표시합니다.

매개 변수

-InputObject

콘솔에 기록되는 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

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

-Paging

Out-Host 한 번에 한 페이지의 출력을 표시하고 나머지 페이지가 표시되기 전에 사용자 입력을 기다립니다. 기본적으로 모든 출력은 단일 페이지에 표시됩니다. 페이지 크기는 호스트의 특성에 따라 결정됩니다.

공백 표시줄을 눌러 출력의 다음 페이지 또는 Enter 키를 표시하여 다음 출력 줄을 봅니다. Q 눌러 종료합니다.

페이징더 명령과 유사합니다.

메모

페이징 매개 변수는 PowerShell ISE 호스트에서 지원되지 않습니다.

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

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다. 표시를 위해 호스트에 개체를 보냅니다.

참고

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

  • 모든 플랫폼:
    • oh

페이징 매개 변수는 모든 PowerShell 호스트에서 지원되지 않습니다. 예를 들어 PowerShell ISE에서 페이징 매개 변수를 사용하는 경우 다음과 같은 오류가 표시됩니다. out-lineoutput : The method or operation is not implemented.

Out 동사(Out-)가 포함된 cmdlet은 개체의 서식을 지정하지 않습니다. 개체를 렌더링하고 지정된 표시 대상으로 보냅니다. 형식이 지정되지 않은 개체를 Out- cmdlet에 보내는 경우 cmdlet은 렌더링하기 전에 서식 cmdlet으로 보냅니다.

Out- cmdlet에는 이름 또는 파일 경로에 대한 매개 변수가 없습니다. 데이터를 Out- cmdlet으로 보내려면 파이프라인을 사용하여 PowerShell 명령의 출력을 cmdlet에 보냅니다. 또는 변수에 데이터를 저장하고 InputObject 매개 변수를 사용하여 데이터를 cmdlet에 전달할 수 있습니다.

Out-Host 데이터를 전송하지만 출력 개체는 생성하지 않습니다. Out-Host 출력을 Get-Member cmdlet에 파이프라인하는 경우 Get-Member 개체가 지정되지 않았다고 보고합니다.