Aracılığıyla paylaş

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.

Dere # Açıklama Tanıtılan: Cmdlet Yazma
1 Success dere PowerShell 2.0 Write-Output
2 Error dere PowerShell 2.0 Write-Error
3 Warning dere PowerShell 2.0 Write-Warning
4 Verbose dere PowerShell 2.0 Write-Verbose
5 Debug dere PowerShell 2.0 Write-Debug
6 Information dere PowerShell 5.0 Write-Information
yok Progress dere PowerShell 2.0 Write-Progress

Not

Akış Progress yeniden yönlendirmeyi desteklemiyor.

Success dere

Akış Success , 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. AkışSuccess, yerel uygulamalar için stdout akışına bağlanır.

Error dere

Error 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. AkışError, 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.

Warning dere

Warning akışı, Error 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ılamaz. Bu akışa Write-Warning açıkça yazmak için cmdlet'ini kullanın.

Verbose dere

Akış Verbose , kullanıcıların etkileşimli olarak veya bir betikten çalıştırılırken komut sorunlarını gidermelerine 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ışma şekillerini anlamak için yararlı olan ayrıntılı bir çıkış sağlar. Ayrıntılı iletiler yalnızca ortak -Verbose parametresini kullandığınızda oluşturulur. Daha fazla bilgi için bkz. about_CommonParameters.

Debug dere

Akış Debug , 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 -Debug parametresini kullandığınızda oluşturulur. Daha fazla bilgi için bkz. about_CommonParameters.

Debug iletileri, son kullanıcılardan daha çok betik ve cmdlet geliştiricilerine yöneliktir. Bu hata ayıklama iletileri, derin sorun giderme için gerekli iç ayrıntıları içerebilir.

Information dere

Akış Information , kullanıcının bir betiğin ne yaptığını anlamasına yardımcı olacak iletiler sağlamaya yöneliktir. Ayrıca geliştiriciler tarafından PowerShell üzerinden 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.

Write-Host ayrıca akışa Information yazar. Cmdlet'ler arasındaki fark, akışı yeniden yönlendirmediğiniz sürece konak konsoluna da yazmanızdır Write-HostInformation . Write-Information yalnızca akışa Information yazar.

Progress dere

Progress 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. Akış Progress yeniden yönlendirmeyi desteklemiyor.

Ayrıca bkz.