출력을 명령줄로 보냅니다.
구문
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에 변수를 지정합니다.
참고 항목