다음을 통해 공유

Out-Host

  • 참조
모듈:
Microsoft.PowerShell.Core

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

Syntax

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

Description

cmdlet은 Out-Host 표시를 위해 출력을 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

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

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

-Paging

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

스페이스바를 눌러 출력의 다음 페이지 또는 Enter 키를 표시하여 다음 출력 줄을 봅니다. 종료하려면 Q 키를 누릅니다.

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

참고 항목

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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을 렌더링하기 전에 서식 지정 cmdlet으로 보냅니다.

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

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