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 호스트가 페이징 매개 변수를 지원하는 것은 아닙니다. 예를 들어 Windows PowerShell ISE에서 페이징 매개 변수를 사용하는 경우 다음 오류가 표시됩니다.

out-lineoutput: 메서드 또는 작업이 구현되지 않았습니다.

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

cmdlet은 Out- 파일에서 입력을 읽지 않습니다. cmdlet에 Out- 데이터를 보내려면 파이프라인을 사용하여 cmdlet에 데이터를 보냅니다. 또는 변수에 데이터를 저장하고 InputObject 매개 변수를 사용하여 데이터를 cmdlet에 전달할 수 있습니다.

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