about_Output_Streams
Korte beschrijving
Hierin wordt de beschikbaarheid en het doel van uitvoerstromen in PowerShell uitgelegd.
Lange beschrijving
PowerShell biedt meerdere uitvoerstromen. De streams bieden kanalen voor verschillende typen berichten. U kunt naar deze streams schrijven met behulp van de bijbehorende cmdlet of omleiding. Zie about_Redirection voor meer informatie.
PowerShell ondersteunt de volgende uitvoerstromen.
| Stream # | Description | Geïntroduceerd in | Cmdlet schrijven |
|---|---|---|---|
| 1 | Successtream | PowerShell 2.0 | Write-Output |
| 2 | Foutstroom | PowerShell 2.0 | Write-Error |
| 3 | Waarschuwingsstroom | PowerShell 2.0 | Write-Warning |
| 4 | Uitgebreide stream | PowerShell 2.0 | Write-Verbose |
| 5 | Foutopsporingsstroom | PowerShell 2.0 | Write-Debug |
| 6 | Informatiestroom | PowerShell 5.0 | Write-Information |
| n.v.t. | Voortgangsstroom | PowerShell 2.0 | Write-Progress |
Notitie
De voortgangsstroom biedt geen ondersteuning voor omleiding.
Successtream
De stream Geslaagd is de standaardstream voor normale, succesvolle resultaten.
Gebruik de Write-Output cmdlet om expliciet objecten naar deze stroom te schrijven. Deze stroom wordt gebruikt voor het doorgeven van objecten via de PowerShell-pijplijn. De successtream is verbonden met de stdout-stream voor systeemeigen toepassingen.
Foutstroom
De foutstroom is de standaardstream voor foutresultaten. Gebruik de Write-Error cmdlet om expliciet naar deze stream te schrijven. De foutstroom is verbonden met de stderr-stroom voor systeemeigen toepassingen. In de meeste gevallen kunnen deze fouten de uitvoeringspijplijn beëindigen. Fouten die naar deze stroom worden geschreven, worden ook toegevoegd aan de $Error automatische variabele. Zie about_Automatic_Variables voor meer informatie.
Waarschuwingsstroom
De waarschuwingsstroom is bedoeld voor foutvoorwaarden die minder ernstig zijn dan fouten die naar de foutstroom worden geschreven. Onder normale omstandigheden wordt de uitvoering niet beëindigd door deze waarschuwingen. Waarschuwingen worden niet naar de $Error automatische variabele geschreven. Gebruik de Write-Warning cmdlet om expliciet naar deze stream te schrijven.
Uitgebreide stream
De uitgebreide stream is bedoeld voor berichten die gebruikers helpen bij het oplossen van problemen met opdrachten die interactief of vanuit een script worden uitgevoerd. Gebruik de Write-Verbose cmdlet om berichten expliciet naar deze stream te schrijven. Veel cmdlets bieden uitgebreide uitvoer die handig is om inzicht te krijgen in de interne werking van de cmdlet. De uitgebreide berichten worden alleen uitgevoerd wanneer u de -Verbose algemene parameter gebruikt. Zie about_CommonParameters voor meer informatie.
Foutopsporingsstroom
De foutopsporingsstroom wordt gebruikt voor berichten die scripters helpen begrijpen waarom hun code mislukt. Gebruik de Write-Debug cmdlet om expliciet naar deze stream te schrijven. De foutopsporingsberichten worden alleen uitgevoerd wanneer u de -Debug algemene parameter gebruikt. Zie about_CommonParameters voor meer informatie.
Foutopsporingsberichten zijn meer bedoeld voor script- en cmdlet-ontwikkelaars dan eindgebruikers. Deze foutopsporingsberichten kunnen interne details bevatten die nodig zijn voor grondige probleemoplossing.
Informatiestroom
De informatiestroom is bedoeld om een bericht te bieden waarmee een gebruiker begrijpt wat een script doet. Het kan ook door ontwikkelaars worden gebruikt als een extra stroom die wordt gebruikt om informatie door te geven via PowerShell. De ontwikkelaar kan stroomgegevens taggen en specifieke afhandeling voor die stream hebben. Gebruik de Write-Information cmdlet om expliciet naar deze stream te schrijven.
Voortgangsstroom
De voortgangsstroom wordt gebruikt voor berichten die de voortgang communiceren in opdrachten en scripts die langer worden uitgevoerd. Gebruik de Write-Progress cmdlet om berichten expliciet naar deze stream te schrijven. De voortgangsstroom biedt geen ondersteuning voor omleiding.