Bagikan melalui

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.

Kali # Deskripsi Diperkenalkan dalam Tulis Cmdlet
1 aliran Success PowerShell 2.0 Write-Output
2 aliran Error PowerShell 2.0 Write-Error
3 aliran Warning PowerShell 2.0 Write-Warning
4 aliran Verbose PowerShell 2.0 Write-Verbose
5 aliran Debug PowerShell 2.0 Write-Debug
6 aliran Information PowerShell 5.0 Write-Information
N/a aliran Progress PowerShell 2.0 Write-Progress

Nota

Aliran Progress tidak mendukung pengalihan.

aliran Success

Aliran Success adalah aliran default untuk hasil normal yang berhasil. Gunakan cmdlet Write-Output 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.

aliran Error

Aliran Error adalah aliran default untuk hasil kesalahan. Gunakan cmdlet Write-Error 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 variabel otomatis $Error. Untuk informasi selengkapnya, lihat about_Automatic_Variables.

aliran Warning

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 variabel otomatis $Error. Gunakan cmdlet Write-Warning untuk menulis secara eksplisit ke aliran ini.

aliran Verbose

Aliran Verbose ditujukan untuk pesan yang membantu pengguna memecahkan masalah perintah saat dijalankan secara interaktif atau dari skrip. Gunakan cmdlet Write-Verbose 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 parameter umum -Verbose. Untuk informasi selengkapnya, lihat about_CommonParameters.

aliran Debug

Aliran Debug digunakan untuk pesan yang membantu skrip memahami mengapa kode mereka gagal. Gunakan cmdlet Write-Debug untuk menulis secara eksplisit ke aliran ini. Pesan debug hanya output 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.

aliran Information

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. Gunakan cmdlet Write-Information untuk menulis secara eksplisit ke aliran ini.

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

aliran Progress

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

Lihat juga

  • Last updated on