about_Output_Streams

  • 아티클

간단한 설명

PowerShell에서 출력 스트림의 가용성 및 용도를 설명합니다.

자세한 설명

PowerShell은 여러 출력 스트림을 제공합니다. 스트림은 다양한 유형의 메시지에 대한 채널을 제공합니다. 연결된 cmdlet 또는 리디렉션을 사용하여 이러한 스트림에 쓸 수 있습니다. 자세한 내용은 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 오류 결과의 기본 스트림입니다. 이 스트림에 Write-Error 명시적으로 쓰려면 cmdlet을 사용합니다. Error 스트림은 네이티브 애플리케이션에 대한 stderr 스트림에 연결됩니다. 대부분의 조건에서 이러한 오류는 실행 파이프라인을 종료할 수 있습니다. Error이 스트림에 기록된 s도 자동 변수에 $Error 추가됩니다. 자세한 내용은 about_Automatic_Variables를 참조하세요.

Warning 스트림

스트림은 Warning 스트림에 기록된 오류보다 덜 심각한 오류 조건을 위한 것입니다 Error . 정상적인 조건에서는 이러한 경고가 실행을 종료하지 않습니다. Warning은 자동 변수에 $Error 기록되지 않습니다. 이 스트림에 Write-Warning 명시적으로 쓰려면 cmdlet을 사용합니다.

Verbose 스트림

스트림은 Verbose 사용자가 대화형으로 또는 스크립트에서 실행될 때 명령 문제를 해결하는 데 도움이 되는 메시지를 위한 것입니다. cmdlet을 Write-Verbose 사용하여 이 스트림에 메시지를 명시적으로 씁니다. 많은 cmdlet은 cmdlet의 내부 작동을 이해하는 데 유용한 자세한 출력을 제공합니다. 자세한 내용은 공통 매개 변수를 사용하는 경우에만 출력됩니다 -Verbose . 자세한 내용은 about_CommonParameters를 참조하세요.

Debug 스트림

스트림은 Debug 스크립터에서 코드가 실패하는 이유를 이해하는 데 도움이 되는 메시지에 사용됩니다. 이 스트림에 Write-Debug 명시적으로 쓰려면 cmdlet을 사용합니다. 디버그 메시지는 공통 매개 변수를 사용하는 경우에만 출력됩니다 -Debug . 자세한 내용은 about_CommonParameters를 참조하세요.

Debug 메시지는 최종 사용자보다 스크립트 및 cmdlet 개발자를 위한 것입니다. 이러한 디버그 메시지에는 심층적인 문제 해결에 필요한 내부 세부 정보가 포함될 수 있습니다.

Information 스트림

Information 스트림은 사용자가 스크립트가 수행하는 작업을 이해하는 데 도움이 되는 메시지를 제공하기 위한 것입니다. 개발자는 PowerShell을 통해 정보를 전달하는 데 사용되는 추가 스트림으로 사용할 수도 있습니다. 개발자는 스트림 데이터에 태그를 지정하고 해당 스트림에 대한 특정 처리를 수행할 수 있습니다. 이 스트림에 Write-Information 명시적으로 쓰려면 cmdlet을 사용합니다.

Write-Host 또한 스트림에 Information 씁니다. cmdlet Write-Host 간의 차이점은 스트림을 리디렉션 Information 하지 않는 한 호스트 콘솔에도 씁니다. Write-Information 스트림에 쓰기만 합니다 Information .

Progress 스트림

Progress 스트림은 더 오래 실행되는 명령 및 스크립트에서 진행률을 전달하는 메시지에 사용됩니다. cmdlet을 Write-Progress 사용하여 이 스트림에 메시지를 명시적으로 씁니다. 스트림은 Progress 리디렉션을 지원하지 않습니다.

참고 항목