about_Output_Streams

  • Artikel

Deskripsi singkat

Menjelaskan ketersediaan dan tujuan aliran output di PowerShell.

Deskripsi panjang

PowerShell menyediakan beberapa aliran output. Aliran menyediakan saluran untuk berbagai jenis pesan. Anda dapat menulis ke aliran ini menggunakan cmdlet atau pengalihan terkait. Untuk informasi selengkapnya, lihat about_Redirection.

PowerShell mendukung aliran output berikut.

Stream # Deskripsi Diperkenalkan di Tulis Cmdlet
1 Success Stream PowerShell 2.0 Write-Output
2 Error Stream PowerShell 2.0 Write-Error
3 Warning Stream PowerShell 2.0 Write-Warning
4 Verbose Stream PowerShell 2.0 Write-Verbose
5 Debug Stream PowerShell 2.0 Write-Debug
6 Information Stream PowerShell 5.0 Write-Information
n/a Progress Stream PowerShell 2.0 Write-Progress

Catatan

Aliran Progress tidak mendukung pengalihan.

Success Stream

Aliran Success adalah aliran default untuk hasil normal yang berhasil. Write-Output Gunakan cmdlet untuk menulis objek secara eksplisit ke aliran ini. Aliran ini digunakan untuk meneruskan objek melalui alur PowerShell. Aliran Success terhubung ke aliran stdout untuk aplikasi asli.

Error Stream

Aliran Error adalah aliran default untuk hasil kesalahan. Write-Error Gunakan cmdlet untuk menulis secara eksplisit ke aliran ini. Aliran Error terhubung ke aliran stderr untuk aplikasi asli. Dalam sebagian besar kondisi, kesalahan ini dapat mengakhiri alur eksekusi. Errors yang ditulis ke aliran ini juga ditambahkan ke $Error variabel otomatis. Untuk informasi selengkapnya, lihat about_Automatic_Variables.

Warning Stream

Aliran Warning ini ditujukan untuk kondisi kesalahan yang kurang parah daripada kesalahan yang ditulis ke Error aliran. Dalam kondisi normal, peringatan ini tidak mengakhiri eksekusi. Warnings tidak ditulis ke $Error variabel otomatis. Write-Warning Gunakan cmdlet untuk menulis secara eksplisit ke aliran ini.

Verbose Stream

Aliran Verbose ditujukan untuk pesan yang membantu pengguna memecahkan masalah perintah saat dijalankan secara interaktif atau dari skrip. Write-Verbose Gunakan cmdlet untuk menulis pesan secara eksplisit ke aliran ini. Banyak cmdlet menyediakan output verbose yang berguna untuk memahami pekerjaan internal cmdlet. Pesan verbose hanya dihasilkan saat Anda menggunakan -Verbose parameter umum. Untuk informasi selengkapnya, lihat about_CommonParameters.

Debug Stream

Aliran Debug digunakan untuk pesan yang membantu skrip memahami mengapa kode mereka gagal. Write-Debug Gunakan cmdlet untuk menulis secara eksplisit ke aliran ini. Pesan debug hanya output saat Anda menggunakan -Debug parameter umum. Untuk informasi selengkapnya, lihat about_CommonParameters.

Debug pesan ditujukan untuk pengembang skrip dan cmdlet lebih dari pengguna akhir. Pesan debug ini dapat berisi detail internal yang diperlukan untuk pemecahan masalah mendalam.

Information Stream

Aliran Information dimaksudkan untuk menyediakan pesan yang membantu pengguna memahami apa yang dilakukan skrip. Ini juga dapat digunakan oleh pengembang sebagai aliran tambahan yang digunakan untuk meneruskan informasi melalui PowerShell. Pengembang dapat menandai streaming data dan memiliki penanganan khusus untuk aliran tersebut. Write-Information Gunakan cmdlet untuk menulis secara eksplisit ke aliran ini.

Write-Host juga menulis ke Information aliran. Perbedaan antara cmdlet adalah yang Write-Host juga menulis ke konsol host kecuali Anda mengalihkan Information aliran. Write-Information hanya menulis ke Information aliran.

Progress Stream

Aliran Progress digunakan untuk pesan yang mengomunikasikan kemajuan dalam perintah dan skrip yang berjalan lebih lama. Write-Progress Gunakan cmdlet untuk menulis pesan secara eksplisit ke aliran ini. Aliran Progress tidak mendukung pengalihan.

Lihat juga