about_Output_Streams
Kısa açıklama
PowerShell'de çıkış akışlarının kullanılabilirliğini ve amacını açıklar.
Uzun açıklama
PowerShell birden çok çıkış akışı sağlar. Akışlar farklı ileti türleri için kanallar sağlar. İlişkili cmdlet'i veya yeniden yönlendirmeyi kullanarak bu akışlara yazabilirsiniz. Daha fazla bilgi için bkz. about_Redirection.
PowerShell aşağıdaki çıkış akışlarını destekler.
Stream # | Description | Şu sürümde tanıtıldı: | Cmdlet Yazma |
---|---|---|---|
1 | Başarı akışı | PowerShell 2.0 | Write-Output |
2 | Hata akışı | PowerShell 2.0 | Write-Error |
3 | Uyarı akışı | PowerShell 2.0 | Write-Warning |
4 | Ayrıntılı akış | PowerShell 2.0 | Write-Verbose |
5 | Akışta hata ayıklama | PowerShell 2.0 | Write-Debug |
6 | Bilgi akışı | PowerShell 5.0 | Write-Information |
yok | İlerleme akışı | PowerShell 2.0 | Write-Progress |
Not
İlerleme akışı yeniden yönlendirmeyi desteklemiyor.
Başarı akışı
Başarılı akışı, normal ve başarılı sonuçlar için varsayılan akıştır.
Bu akışa Write-Output
açıkça nesne yazmak için cmdlet'ini kullanın. Bu akış, Nesneleri PowerShell işlem hattından geçirmek için kullanılır. Success akışı yerel uygulamalar için stdout akışına bağlanır.
Hata akışı
Hata akışı, hata sonuçları için varsayılan akıştır. Bu akışa Write-Error
açıkça yazmak için cmdlet'ini kullanın. Hata akışı yerel uygulamalar için stderr akışına bağlanır. Çoğu koşulda, bu hatalar yürütme işlem hattını sonlandırabilir. Bu akışa yazılan hatalar da otomatik değişkene $Error
eklenir. Daha fazla bilgi için bkz. about_Automatic_Variables.
Uyarı akışı
Uyarı akışı, Hata akışına yazılan hatalardan daha az ciddi hata koşullarına yöneliktir. Normal koşullarda, bu uyarılar yürütmeyi sonlandırmaz. Uyarılar otomatik değişkene $Error
yazılmaz. Bu akışa Write-Warning
açıkça yazmak için cmdlet'ini kullanın.
Ayrıntılı akış
Ayrıntılı akış, kullanıcıların etkileşimli olarak veya bir betikten çalıştırılırken komutların sorunlarını gidermesine yardımcı olan iletilere yöneliktir. Bu akışa Write-Verbose
açıkça ileti yazmak için cmdlet'ini kullanın. Birçok cmdlet, cmdlet'in iç çalışmalarını anlamak için yararlı olan ayrıntılı çıkış sağlar. Ayrıntılı iletiler yalnızca ortak parametreyi -Verbose
kullandığınızda çıkış olur. Daha fazla bilgi için bkz. about_CommonParameters.
Akışta hata ayıklama
Hata ayıklama akışı, betikçilerin kodlarının neden başarısız olduğunu anlamasına yardımcı olan iletiler için kullanılır. Bu akışa Write-Debug
açıkça yazmak için cmdlet'ini kullanın. Hata ayıklama iletileri yalnızca ortak parametreyi -Debug
kullandığınızda oluşturulur. Daha fazla bilgi için bkz. about_CommonParameters.
Hata ayıklama iletileri, son kullanıcılardan daha çok betik ve cmdlet geliştiricilerine yöneliktir. Bu hata ayıklama iletileri, ayrıntılı sorun giderme için gerekli iç ayrıntıları içerebilir.
Bilgi akışı
Bilgi akışı, bir kullanıcının betiğin ne yaptığını anlamasına yardımcı olan bir ileti sağlamaya yöneliktir. Ayrıca geliştiriciler tarafından PowerShell aracılığıyla bilgi geçirmek için kullanılan ek bir akış olarak da kullanılabilir. Geliştirici akış verilerini etiketleyebilir ve bu akış için belirli işlemeye sahip olabilir. Bu akışa Write-Information
açıkça yazmak için cmdlet'ini kullanın.
İlerleme akışı
İlerleme akışı, daha uzun süre çalışan komutlarda ve betiklerde ilerleme durumunu bildiren iletiler için kullanılır. Bu akışa Write-Progress
açıkça ileti yazmak için cmdlet'ini kullanın. İlerleme akışı yeniden yönlendirmeyi desteklemiyor.