Out-Host

아티클
01/12/2010

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

구문

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

설명

Out-Host cmdlet은 출력을 표시할 수 있도록 Windows PowerShell 호스트로 보냅니다. 이 호스트는 명령줄에 출력을 표시합니다. Out-Host가 기본값이므로 매개 변수를 사용하여 표시를 변경하지 않으려면 따로 지정하지 않아도 됩니다.

매개 변수

-InputObject <psobject>

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

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	true (ByValue)
와일드카드 문자 적용 여부	false

-Paging

출력은 한 번에 한 페이지만 표시하고 나머지 페이지를 표시하려면 기존의 "more" 명령과 비슷한 사용자 입력을 기다립니다. 기본적으로 모든 출력은 한 페이지 표시됩니다. 호스트의 특징에 따라 페이지 크기가 결정됩니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSObject

임의의 개체를 Out-Host로 파이프할 수 있습니다.

출력

없음

Out-Host는 출력을 생성하지 않습니다. 그러나 호스트는 Out-Host가 보내는 개체를 표시할 수 있습니다.

참고

또한 해당 기본 제공 별칭("oh")으로 Out-Host를 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.

Out 동사를 포함하는 cmdlet(Out cmdlet)은 개체의 형식을 지정하지 않고 렌더링만 한 후 지정된 표시 대상으로 보냅니다. 형식을 지정하지 않은 개체를 Out cmdlet에 보내면 이 cmdlet이 형식 지정 cmdlet으로 보낸 후 렌더링합니다.

Out cmdlet에는 이름이나 파일 경로에 대한 매개 변수가 없습니다. 데이터를 Out cmdlet으로 보내려면 파이프라인 연산자(|)를 사용하여 Windows PowerShell 명령의 출력을 cmdlet으로 보내십시오. 데이터를 변수에 저장하고 InputObject 매개 변수를 사용하여 cmdlet에 데이터를 전달할 수도 있습니다. 자세한 내용은 예를 참조하십시오.

Out-Host는 데이터를 보내지만 출력 개체를 내보내지는 않습니다. Out-Host의 출력을 Get-Member로 파이프하면 Get-Member에서 지정된 개체가 없음을 보고합니다.

예 1

C:\PS>get-process | out-host -paging

설명
-----------
이 명령은 시스템의 프로세스를 한 번에 한 페이지씩 표시합니다. 이 명령은 Get-Process 명령을 사용하여 시스템의 모든 프로세스를 가져옵니다. 파이프라인 연산자(|)는 결과를 Out-Host로 보내고 Out-Host는 이 결과를 콘솔에 표시합니다. Paging 매개 변수는 데이터를 한 번에 한 페이지씩 표시합니다.

Windows PowerShell에서 기본 제공하는 Help 함수에도 같은 명령 형식이 사용됩니다. 이 함수는 Get-Help에서 데이터를 가져온 후 Out-Host의 Paging 매개 변수를 사용하여 get-help $args[0] | out-host -paging 명령 형식을 통해 데이터를 한 번에 한 페이지씩 표시합니다.

예 2

C:\PS>$a = get-history

C:\PS>out-host -InputObject $a

설명
-----------
이들 명령은 명령줄에 세션 기록을 표시합니다. 첫 번째 명령은 Get-History cmdlet을 사용하여 세션 기록을 가져온 다음 이 기록을 $a 변수에 저장합니다. 두 번째 명령은 Out-Host를 사용하여 $a 변수의 내용을 표시하고 InputObject 매개 변수를 사용하여 Out-Host에 변수를 지정합니다.

참고 항목

개념

Out-Printer
Out-Null
Out-File
Out-String
Out-Default
Write-Host

다음을 통해 공유