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 informationbilgi 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

Akış Error , sonuçlar için error 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 informationbilgi için bkz . about_Automatic_Variables.

Warning dere

AkışWarning, akışa yazılan Error hatalardan daha az ciddi koşullara yöneliktirerror. 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ışmalarını anlamak için yararlı olan bir çıkış sağlar verbose . İletiler verbose yalnızca ortak parametreyi -Verbose kullandığınızda oluşturulur. Daha fazla informationbilgi 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. İletiler debug yalnızca ortak parametreyi -Debug kullandığınızda oluşturulur. Daha fazla informationbilgi için bkz . about_CommonParameters.

Debug iletileri, son kullanıcılardan daha çok betik ve cmdlet geliştiricilerine yöneliktir. Bu debug iletiler, ayrıntılı 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. Geliştiriciler tarafından PowerShell'i geçirmek information 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-Host Information . Write-Information yalnızca akışa Information yazar.

Progress dere

Akış Progress , daha uzun süre çalışan komutlarda ve betiklerde iletişim progress kuran 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.