about_Output_Streams

2025-01-23

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.

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 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. Kesalahan yang ditulis ke aliran ini juga ditambahkan ke $Error variabel otomatis. Untuk informasi lebih lanjut, lihat about_Automatic_Variables.

Warning kali

Aliran Warning ditujukan untuk kondisi kesalahan yang kurang parah daripada kesalahan yang ditulis ke aliran Error. 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 output verbose yang berguna untuk memahami cara kerja internal cmdlet. Pesan verbose hanya dihasilkan saat Anda menggunakan parameter umum -Verbose. Untuk informasi selengkapnya, 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 kesalahan debug hanya ditampilkan saat Anda menggunakan parameter umum -Debug. 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 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 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 kali

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.

Bagikan melalui