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, 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.