about_Output_Streams
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 information, lihat about_Redirection.
PowerShell mendukung aliran output berikut.
| Kali # | Deskripsi | Diperkenalkan di | Tulis Cmdlet |
|---|---|---|---|
| 1 | Success kali | PowerShell 2.0 | Write-Output |
| 2 | Error kali | PowerShell 2.0 | Write-Error |
| 3 | Warning kali | PowerShell 2.0 | Write-Warning |
| 4 | Verbose kali | PowerShell 2.0 | Write-Verbose |
| 5 | Debug kali | PowerShell 2.0 | Write-Debug |
| 6 | Information kali | PowerShell 5.0 | Write-Information |
| n/a | Progress kali | PowerShell 2.0 | Write-Progress |
Catatan
Aliran Progress tidak mendukung pengalihan.
Success kali
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 kali
Aliran Error adalah aliran default untuk error hasil. 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. Kesalahan yang ditulis ke aliran ini juga ditambahkan ke $Error variabel otomatis. Untuk informasi selengkapnya information, lihat about_Automatic_Variables.
Warning kali
Aliran Warning ini ditujukan untuk error kondisi yang kurang parah daripada kesalahan yang ditulis ke Error aliran. Dalam kondisi normal, peringatan ini tidak mengakhiri eksekusi. Peringatan tidak ditulis ke $Error variabel otomatis. Write-Warning Gunakan cmdlet untuk menulis secara eksplisit ke aliran ini.
Verbose kali
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 verbose output yang berguna untuk memahami pekerjaan internal cmdlet. Pesan verbose hanya output saat Anda menggunakan -Verbose parameter umum. Untuk informasi selengkapnya information, lihat about_CommonParameters.
Debug kali
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 information, lihat about_CommonParameters.
Debug pesan ditujukan untuk pengembang skrip dan cmdlet lebih dari pengguna akhir. Pesan ini debug dapat berisi detail internal yang diperlukan untuk pemecahan masalah mendalam.
Information kali
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 melewati information 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 kali
Aliran Progress digunakan untuk pesan yang berkomunikasi progress 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.
