about_Output_Streams
간단한 설명
PowerShell에서 출력 스트림의 가용성 및 용도를 설명합니다.
자세한 설명
PowerShell은 여러 출력 스트림을 제공합니다. 스트림은 다양한 유형의 메시지에 대한 채널을 제공합니다. 연결된 cmdlet 또는 리디렉션을 사용하여 이러한 스트림에 쓸 수 있습니다. 자세한 information내용은 about_Redirection 참조하세요.
PowerShell은 다음 출력 스트림을 지원합니다.
| 시내 # | 설명 | 소개 | 쓰기 Cmdlet |
|---|---|---|---|
| 1 | Success 시내 | PowerShell 2.0 | Write-Output |
| 2 | Error 시내 | PowerShell 2.0 | Write-Error |
| 3 | Warning 시내 | PowerShell 2.0 | Write-Warning |
| 4 | Verbose 시내 | PowerShell 2.0 | Write-Verbose |
| 5 | Debug 시내 | PowerShell 2.0 | Write-Debug |
| 6 | Information 시내 | PowerShell 5.0 | Write-Information |
| 해당 없음 | Progress 시내 | PowerShell 2.0 | Write-Progress |
참고 항목
스트림은 Progress 리디렉션을 지원하지 않습니다.
Success 시내
스트림은 Success 정상의 성공적인 결과를 위한 기본 스트림입니다.
이 스트림에 Write-Output 개체를 명시적으로 쓰려면 cmdlet을 사용합니다. 이 스트림은 PowerShell 파이프라인을 통해 개체를 전달하는 데 사용됩니다. Success 스트림은 네이티브 애플리케이션에 대한 stdout 스트림에 연결됩니다.
Error 시내
스트림은 Error 결과의 기본 스트림입니다 error . 이 스트림에 Write-Error 명시적으로 쓰려면 cmdlet을 사용합니다. Error 스트림은 네이티브 애플리케이션에 대한 stderr 스트림에 연결됩니다. 대부분의 조건에서 이러한 오류는 실행 파이프라인을 종료할 수 있습니다. 이 스트림에 기록된 오류도 자동 변수에 $Error 추가됩니다. 자세한 information내용은 about_Automatic_Variables 참조하세요.
Warning 시내
스트림은 Warning 스트림에 기록된 오류보다 덜 심각한 조건을 위한 error 것입니다 Error . 정상적인 조건에서는 이러한 경고가 실행을 종료하지 않습니다. 경고는 자동 변수에 $Error 기록되지 않습니다. 이 스트림에 Write-Warning 명시적으로 쓰려면 cmdlet을 사용합니다.
Verbose 시내
스트림은 Verbose 사용자가 대화형으로 또는 스크립트에서 실행될 때 명령 문제를 해결하는 데 도움이 되는 메시지를 위한 것입니다. cmdlet을 Write-Verbose 사용하여 이 스트림에 메시지를 명시적으로 씁니다. 많은 cmdlet은 cmdlet의 내부 작동을 이해하는 데 유용한 출력을 제공합니다 verbose . 메시지는 verbose 공통 매개 변수를 사용하는 경우에만 출력됩니다 -Verbose . 자세한 information내용은 about_CommonParameters 참조하세요.
Debug 시내
스트림은 Debug 스크립터에서 코드가 실패하는 이유를 이해하는 데 도움이 되는 메시지에 사용됩니다. 이 스트림에 Write-Debug 명시적으로 쓰려면 cmdlet을 사용합니다. 메시지는 debug 공통 매개 변수를 사용하는 경우에만 출력됩니다 -Debug . 자세한 information내용은 about_CommonParameters 참조하세요.
Debug 메시지는 최종 사용자보다 스크립트 및 cmdlet 개발자를 위한 것입니다. 이러한 debug 메시지에는 심층적인 문제 해결에 필요한 내부 세부 정보가 포함될 수 있습니다.
Information 시내
Information 스트림은 사용자가 스크립트가 수행하는 작업을 이해하는 데 도움이 되는 메시지를 제공하기 위한 것입니다. 개발자는 PowerShell을 통과하는 information 데 사용되는 추가 스트림으로 사용할 수도 있습니다. 개발자는 스트림 데이터에 태그를 지정하고 해당 스트림에 대한 특정 처리를 수행할 수 있습니다. 이 스트림에 Write-Information 명시적으로 쓰려면 cmdlet을 사용합니다.
Write-Host 또한 스트림에 Information 씁니다. cmdlet Write-Host 간의 차이점은 스트림을 리디렉션 Information 하지 않는 한 호스트 콘솔에도 씁니다. Write-Information 스트림에 쓰기만 합니다 Information .
Progress 시내
Progress 스트림은 더 오래 실행되는 명령 및 스크립트에서 통신 progress 하는 메시지에 사용됩니다. cmdlet을 Write-Progress 사용하여 이 스트림에 메시지를 명시적으로 씁니다. 스트림은 Progress 리디렉션을 지원하지 않습니다.
참고 항목
PowerShell