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 akışı	PowerShell 2.0	Write-Output
2	Error akışı	PowerShell 2.0	Write-Error
3	Warning akışı	PowerShell 2.0	Write-Warning
4	Verbose akışı	PowerShell 2.0	Write-Verbose
5	Debug akışı	PowerShell 2.0	Write-Debug
6	Information akışı	PowerShell 5.0	Write-Information
Yok	Progress akışı	PowerShell 2.0	Write-Progress

Not

Progress akışı yeniden yönlendirmeyi desteklemez.

Success akışı

Success akışı, normal ve başarılı sonuçlar için varsayılan akıştır. Bu akışa açıkça nesne yazmak için Write-Output 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.

Error akışı

Error akışı, hata sonuçları için varsayılan akıştır. Bu akışa açıkça yazmak için Write-Error cmdlet'ini kullanın. Error 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 $Error otomatik değişkenine de eklenir. Daha fazla bilgi için bkz. about_Automatic_Variables.

Warning akışı

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

Verbose akışı

Verbose akışı, 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 açıkça ileti yazmak için Write-Verbose cmdlet'ini kullanın. Birçok cmdlet, cmdlet'in iç çalışmalarını 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 akışı

Debug 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 açıkça yazmak için Write-Debug 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ştiricileri için tasarlanmıştır. Bu hata ayıklama iletileri, derin sorun giderme için gerekli iç ayrıntıları içerebilir.

Information akışı

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

Write-Host Information akışına da yazar. Cmdlet'ler arasındaki fark, Write-HostInformation akışını yeniden yönlendirmediğiniz sürece konak konsoluna da yazmasıdır. Write-Information yalnızca Information akışına yazar.

Progress akışı

Progress akışı, daha uzun süre çalışan komutlarda ve betiklerde ilerleme durumunu bildiren iletiler için kullanılır. Bu akışa açıkça ileti yazmak için Write-Progress cmdlet'ini kullanın. Progress akışı yeniden yönlendirmeyi desteklemez.

Ayrıca bakınız

• about_CommonParameters
• about_Redirection
• Write-Debug
• Write-Error
• Write-Host
• Write-Information
• Write-Output
• Write-Progress
• Write-Verbose
• Write-Warning