about_Output_Streams

  • Makale

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.

Akışı # 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

Akış Progress yeniden yönlendirmeyi desteklemiyor.

Success Akışı

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 Akışı

Akış Error , 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. Errorbu akışa yazılanlar da otomatik değişkene $Error eklenir. Daha fazla bilgi için bkz . about_Automatic_Variables.

Warning Akışı

Akış Warning , akışa yazılan hatalardan daha az ciddi hata koşullarına yöneliktir Error . Normal koşullarda, bu uyarılar yürütmeyi sonlandırmaz. Warningotomatik değişkene $Error yazılamaz. Bu akışa Write-Warning açıkça yazmak için cmdlet'ini kullanın.

Verbose Akışı

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ışmalarını anlamak için yararlı olan ayrıntılı bir çıkış sağlar. Ayrıntılı iletiler yalnızca ortak parametreyi -Verbose kullandığınızda çıkıştır. Daha fazla bilgi için bkz . about_CommonParameters.

Debug Akışı

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 parametreyi -Debug 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 Akışı

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 Akışı

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