about_Output_Streams
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 informationfinns 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 |
| saknas | Progress ström | PowerShell 2.0 | Write-Progress |
Kommentar
Strömmen Progress stöder inte omdirigering.
Success ström
Strömmen Success ä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. Strömmen Success är ansluten till stdout-strömmen för inbyggda program.
Error ström
Strömmen Error är standardströmmen för error resultat. Använd cmdleten Write-Error för att uttryckligen skriva till den här strömmen. Strömmen Error är ansluten till stderr-strömmen för inbyggda program. Under de flesta förhållanden kan dessa fel avsluta körningspipelinen. Fel som skrivs till den här dataströmmen läggs också till i den $Error automatiska variabeln. Mer information informationfinns i about_Automatic_Variables.
Warning ström
Strömmen Warning är avsedd för error villkor som är mindre allvarliga än fel som skrivits till Error strömmen. Under normala förhållanden avslutas inte körningen av dessa varningar. 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ändarna att felsöka kommandon när de 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 verbose utdata som är användbara för att förstå cmdletens interna funktioner. Meddelandena verbose matas bara ut när du använder den -Verbose gemensamma parametern. Mer information informationfinns i about_CommonParameters.
Debug ström
Strömmen Debug 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. Meddelandena debug matas bara ut när du använder den -Debug gemensamma parametern. Mer information informationfinns i about_CommonParameters.
Debug meddelanden är avsedda för skript- och cmdlet-utvecklare mer än slutanvändare. Dessa debug meddelanden kan innehålla intern information som krävs för djup felsökning.
Information ström
Dataströmmen Information ä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 passera information genom 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 även skriver till värdkonsolen om du inte omdirigerar Information strömmen. Write-Information skriver bara till Information strömmen.
Progress ström
Strömmen Progress används för meddelanden som kommunicerar progress i kommandon och skript som körs längre. Använd cmdleten Write-Progress för att uttryckligen skriva meddelanden till den här strömmen. Strömmen Progress stöder inte omdirigering.
