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 informationinformatie.
PowerShell ondersteunt de volgende uitvoerstromen.
Stroom # | Beschrijving | Geïntroduceerd in | Cmdlet schrijven |
---|---|---|---|
1 | Success stroom | PowerShell 2.0 | Write-Output |
2 | Error stroom | PowerShell 2.0 | Write-Error |
3 | Warning stroom | PowerShell 2.0 | Write-Warning |
4 | Verbose stroom | PowerShell 2.0 | Write-Verbose |
5 | Debug stroom | PowerShell 2.0 | Write-Debug |
6 | Information stroom | PowerShell 5.0 | Write-Information |
n.v.t. | Progress stroom | PowerShell 2.0 | Write-Progress |
Notitie
De Progress stream biedt geen ondersteuning voor omleiding.
Success stroom
De Success stream is de standaardstream voor normale, geslaagde resultaten.
Gebruik de Write-Output
cmdlet om expliciet objecten naar deze stream te schrijven. Deze stroom wordt gebruikt voor het doorgeven van objecten via de PowerShell-pijplijn. De Success stream is verbonden met de stdout-stream voor systeemeigen toepassingen.
Error stroom
De Error stream is de standaardstream voor error resultaten. Gebruik de Write-Error
cmdlet om expliciet naar deze stream te schrijven. De Error stream is verbonden met de stderr-stream voor systeemeigen toepassingen. Onder de meeste omstandigheden kunnen deze fouten de uitvoeringspijplijn beëindigen. Fouten die naar deze stream worden geschreven, worden ook toegevoegd aan de $Error
automatische variabele. Zie about_Automatic_Variables voor meer informationinformatie.
Warning stroom
De Warning stream is bedoeld voor error voorwaarden die minder ernstig zijn dan fouten die naar de Error stream zijn geschreven. Onder normale omstandigheden beëindigen deze waarschuwingen de uitvoering niet. Waarschuwingen worden niet naar de $Error
automatische variabele geschreven. Gebruik de Write-Warning
cmdlet om expliciet naar deze stream te schrijven.
Verbose stroom
De Verbose stream is bedoeld voor berichten waarmee gebruikers problemen met opdrachten kunnen oplossen wanneer ze interactief of vanuit een script worden uitgevoerd. Gebruik de Write-Verbose
cmdlet om expliciet berichten naar deze stream te schrijven. Veel cmdlets bieden verbose uitvoer die handig is om inzicht te krijgen in de interne werking van de cmdlet. De verbose berichten worden alleen uitgevoerd wanneer u de -Verbose
algemene parameter gebruikt. Zie about_CommonParameters voor meer informationinformatie.
Debug stroom
De Debug stream 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 debug berichten worden alleen uitgevoerd wanneer u de -Debug
algemene parameter gebruikt. Zie about_CommonParameters voor meer informationinformatie.
Debug berichten zijn bedoeld voor script- en cmdlet-ontwikkelaars meer dan eindgebruikers. Deze debug berichten kunnen interne gegevens bevatten die nodig zijn voor uitgebreide probleemoplossing.
Information stroom
De Information stream is bedoeld om berichten te verstrekken die een gebruiker helpen begrijpen wat een script doet. Het kan ook door ontwikkelaars worden gebruikt als een extra stroom die wordt gebruikt om PowerShell door te geven information . De ontwikkelaar kan streamgegevens taggen en specifieke verwerking voor die stream hebben. Gebruik de Write-Information
cmdlet om expliciet naar deze stream te schrijven.
Write-Host
schrijft ook naar de Information stream. Het verschil tussen de cmdlets is dat Write-Host
ook naar de hostconsole wordt geschreven, tenzij u de Information stream omleidt. Write-Information
schrijft alleen naar de Information stream.
Progress stroom
De Progress stream wordt gebruikt voor berichten die communiceren progress in langer uitgevoerde opdrachten en scripts. Gebruik de Write-Progress
cmdlet om expliciet berichten naar deze stream te schrijven. De Progress stream biedt geen ondersteuning voor omleiding.