Dela via

om_utmatningsströmmar

Kort beskrivning

Förklarar tillgängligheten och syftet med utdataströmmar i PowerShell.

Lång beskrivning

PowerShell tillhandahåller flera utdataströmmar. Strömmarna tillhandahåller kanaler för olika typer av meddelanden. Du kan skriva till dessa strömmar med hjälp av den associerade cmdleten eller omdirigeringen. Mer information finns i about_Redirection.

PowerShell stöder följande utdataströmmar.

Ström # Beskrivning Introducerad i Skriv cmdlet
1 Success ström PowerShell 2.0 Write-Output
2 Error ström PowerShell 2.0 Write-Error
3 Warning ström PowerShell 2.0 Write-Warning
4 Verbose ström PowerShell 2.0 Write-Verbose
5 Debug ström PowerShell 2.0 Write-Debug
6 Information ström PowerShell 5.0 Write-Information
n/a Progress ström PowerShell 2.0 Write-Progress

Not

Den Progress strömmen stöder inte omdirigering.

Success ström

Den Success strömmen är standardströmmen för normala, lyckade resultat. Använd cmdleten Write-Output för att uttryckligen skriva objekt till den här strömmen. Den här strömmen används för att skicka objekt via PowerShell-pipelinen. Den Success strömmen är ansluten till stdout ström för inbyggda program.

Error ström

Error-strömmen är standardströmmen för felresultat. Använd cmdleten Write-Error för att uttryckligen skriva till den här strömmen. Den Error strömmen är ansluten till stderr ström för inbyggda program. Under de flesta förhållanden kan dessa fel stoppa exekveringskedjan. Fel som skrivs till den här strömmen läggs också till i den $Error automatiska variabeln. Mer information finns i about_Automatic_Variables.

Warning ström

Warning-dataströmmen är avsedd för fel som är mindre allvarliga än de som skrivs till Error-dataströmmen. Under normala förhållanden leder dessa varningar inte till avbrott i körningen. Varningar skrivs inte till den $Error automatiska variabeln. Använd cmdleten Write-Warning för att uttryckligen skriva till den här strömmen.

Verbose ström

Strömmen Verbose är avsedd för meddelanden som hjälper användare att felsöka kommandon som körs interaktivt eller från ett skript. Använd cmdleten Write-Verbose för att uttryckligen skriva meddelanden till den här strömmen. Många cmdletar ger utförliga utdata som är användbara för att förstå cmdletens interna funktioner. Utförliga meddelanden matas bara ut när du använder den gemensamma parametern -Verbose. Mer information finns i about_CommonParameters.

Debug ström

Den Debug strömmen används för meddelanden som hjälper skriptare att förstå varför deras kod misslyckas. Använd cmdleten Write-Debug för att uttryckligen skriva till den här strömmen. Felsökningsmeddelandena matas bara ut när du använder den -Debug gemensamma parametern. Mer information finns i about_CommonParameters.

Debug meddelanden är avsedda för skript- och cmdlet-utvecklare mer än slutanvändare. Dessa felsökningsmeddelanden kan innehålla intern information som krävs för djup felsökning.

Information ström

Den Information strömmen är avsedd att ge meddelanden som hjälper en användare att förstå vad ett skript gör. Det kan också användas av utvecklare som en ytterligare ström som används för att skicka information via PowerShell. Utvecklaren kan tagga dataströmmar och ha specifik hantering för dataströmmen. Använd cmdleten Write-Information för att uttryckligen skriva till den här strömmen.

Write-Host skriver också till Information strömmen. Skillnaden mellan cmdletarna är att Write-Host också skriver till värdkonsolen om du inte omdirigerar Information strömmen. Write-Information skriver endast till dataströmmen Information.

Progress ström

Progress-strömmen används för meddelanden som rapporterar framsteg i kommandon och skript som körs under längre tid. Använd cmdleten Write-Progress för att uttryckligen skriva meddelanden till den här strömmen. Den Progress strömmen stöder inte omdirigering.

Se även

  • Last updated on