다음을 통해 공유

Write-Host

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

구문

Write-Host
     [[-Object] <Object>]
     [-NoNewline]
     [-Separator <Object>]
     [-ForegroundColor <ConsoleColor>]
     [-BackgroundColor <ConsoleColor>]
     [<CommonParameters>]

Description

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

메모

Windows PowerShell 5.0부터 Write-HostWrite-Information 대한 래퍼입니다. 이렇게 하면 Write-Host 사용하여 정보 스트림으로 출력을 내보낸다. 이렇게 하면 이전 버전과의 호환성을 유지하면서 Write-Host 사용하여 작성된 데이터의 캡처 또는 억제 수 있습니다.

$InformationPreference 기본 설정 변수 및 InformationAction 공통 매개 변수는 Write-Host 메시지에 영향을 미치지 않습니다. 이 규칙의 예외는 Write-Host 출력을 효과적으로 표시하지 않는 -InformationAction Ignore. ("예제 5" 참조)

예제

예제 1: 새 줄을 추가하지 않고 콘솔에 쓰기

Write-Host "no newline test " -NoNewline
Write-Host "second string"

no newline test second string

이 명령은 NoNewline 매개 변수를 사용하여 문자열 '줄 바꿈 테스트 없음'을 표시합니다.

두 번째 문자열은 작성되지만 문자열을 구분하는 줄 바꿈이 없으므로 첫 번째 문자열과 동일한 줄로 끝납니다.

예제 2: 콘솔에 쓰기 및 구분 기호 포함

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= (comma, space, +, 2, =, space)추가하는 데 사용됩니다.

예제 3: 다른 텍스트 및 배경색으로 쓰기

Write-Host (2,4,6,8,10,12) -Separator ", -> " -ForegroundColor DarkGreen -BackgroundColor White

2, -> 4, -> 6, -> 8, -> 10, -> 12

이 명령은 2에서 12까지의 짝수 숫자를 표시합니다. ForegroundColor 매개 변수를 사용하여 '진한 녹색' 텍스트를 출력하고 BackgroundColor 매개 변수를 사용하여 '흰색' 배경을 표시합니다.

예제 4: 다른 텍스트 및 배경색으로 쓰기

Write-Host "Red on white text." -ForegroundColor red -BackgroundColor white

Red on white text.

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

예제 5: Write-Host 출력 표시 안 함

# The following two statements can be used to effectively suppress output from Write-Host
Write-Host "I won't print" -InformationAction Ignore
Write-Host "I won't print" 6>$null

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

매개 변수

-BackgroundColor

배경색을 지정합니다. 기본값은 없습니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 검정
  • DarkBlue
  • DarkGreen
  • DarkCyan
  • 어둡게
  • DarkMagenta
  • DarkYellow
  • 회색
  • DarkGray
  • 파랑
  • 녹색
  • 청록색
  • 빨강
  • 자홍색
  • 황색
  • 하얀
형식:ConsoleColor
허용되는 값:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForegroundColor

텍스트 색을 지정합니다. 기본값은 없습니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 검정
  • DarkBlue
  • DarkGreen
  • DarkCyan
  • 어둡게
  • DarkMagenta
  • DarkYellow
  • 회색
  • DarkGray
  • 파랑
  • 녹색
  • 청록색
  • 빨강
  • 자홍색
  • 황색
  • 하얀
형식:ConsoleColor
허용되는 값:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NoNewline

입력 개체의 문자열 표현은 출력을 형성하기 위해 연결됩니다. 출력 문자열 사이에 공백이나 줄 바꿈이 삽입되지 않습니다. 마지막 출력 문자열 이후에 줄 바꿈이 추가되지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Object

호스트에 표시할 개체입니다.

형식:Object
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Separator

호스트에서 표시하는 개체 사이에 삽입할 구분 기호 문자열을 지정합니다.

형식:Object
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Object

호스트에 쓸 개체를 파이프할 수 있습니다.

출력

None

Write-Host 호스트에 개체를 보냅니다. 개체를 반환하지 않습니다. 그러나 호스트는 Write-Host 보내는 개체를 표시할 수 있습니다.