Write-Host

사용자 지정된 출력을 호스트에 씁니다.

구문

Write-Host [[-Object] <Object>] [-BackgroundColor {<Black> | <DarkBlue> | <DarkGreen> | <DarkCyan> | <DarkRed> | <DarkMagenta> | <DarkYellow> | <Gray> | <DarkGray> | <Blue> | <Green> | <Cyan> | <Red> | <Magenta> | <Yellow> | <White>}] [-ForegroundColor {<Black> | <DarkBlue> | <DarkGreen> | <DarkCyan> | <DarkRed> | <DarkMagenta> | <DarkYellow> | <Gray> | <DarkGray> | <Blue> | <Green> | <Cyan> | <Red> | <Magenta> | <Yellow> | <White>}] [-NoNewline] [-Separator <Object>] [<CommonParameters>]

설명

Write-Host cmdlet은 출력을 사용자 지정합니다. ForegroundColor 매개 변수를 사용하여 텍스트 색을 지정하고 BackgroundColor 매개 변수를 사용하여 배경색을 지정할 수 있습니다. Separator 매개 변수를 사용하면 문자열을 지정하여 표시된 개체를 구분하는 데 사용할 수 있습니다. 구체적인 결과는 Windows PowerShell을 호스팅하는 프로그램에 따라 다릅니다.

매개 변수

-BackgroundColor <ConsoleColor>

배경색을 지정합니다. 기본값은 없습니다.

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

-ForegroundColor <ConsoleColor>

텍스트 색을 지정합니다. 기본값은 없습니다.

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

-NoNewline

줄 바꿈 문자를 사용해도 콘솔에 표시되는 내용이 끝나지 않도록 지정합니다.

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

-Object <Object>

콘솔에 표시할 개체입니다.

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

-Separator <Object>

콘솔에 표시되는 개체 사이에 출력할 문자열입니다.

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

<CommonParameters>

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

입력 및 출력

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

입력	System.Object 기록할 개체를 호스트로 파이프할 수 있습니다.
출력	없음 Write-Host는 개체를 호스트로 보내며 어떠한 개체도 반환하지 않습니다. 그러나 호스트는 Write-Host가 보내는 개체를 표시할 수 있습니다.

예 1

C:\PS>write-host "no newline test " -nonewline

no newline test C:\PS>

설명
-----------
이 명령은 입력을 콘솔에 표시하지만 NoNewline 매개 변수 때문에 출력 바로 뒤에 프롬프트가 표시됩니다.

예 2

C:\PS>write-host (2,4,6,8,10,12) -Separator ", +2= "

2, +2= 4, +2= 6, +2= 8, +2= 10, +2= 12

설명
-----------
이 명령은 2부터 12까지의 짝수를 표시합니다. Separator 매개 변수를 사용하여 +2=(쉼표, 공백, +, 2, =, 공백) 문자열을 추가합니다.

예 3

C:\PS>write-host (2,4,6,8,10,12) -Separator ", -> " -foregroundcolor DarkGreen -backgroundcolor white

설명
-----------
이 명령은 2부터 12까지의 짝수를 표시합니다. ForegroundColor 매개 변수를 사용하여 출력을 진한 녹색 텍스트로 표시하고 BackgroundColor 매개 변수를 사용하여 배경을 흰색으로 표시합니다.

예 4

C:\PS>write-host "Red on white text." -ForegroundColor red -BackgroundColor white

Red on white text.

설명
-----------
이 명령은 "Red on white text."라는 문자열을 표시합니다. 텍스트는 ForegroundColor 매개 변수에 정의된 대로 빨강이고 배경은 BackgroundColor 매개 변수에 정의된 대로 흰색입니다.

참고 항목

개념

Write-Verbose
Write-Error
Write-Progress
Write-Debug
Write-Output
Write-Warning
Out-Host