Om utdataströ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.
Stream # | Description | Introducerades i | Skriva cmdlet |
---|---|---|---|
1 | Lyckad ström | PowerShell 2.0 | Write-Output |
2 | Felström | PowerShell 2.0 | Write-Error |
3 | Varningsström | PowerShell 3.0 | Write-Warning |
4 | Utförlig ström | PowerShell 3.0 | Write-Verbose |
5 | Felsöka dataström | PowerShell 3.0 | Write-Debug |
6 | Informationsström | PowerShell 5.0 | Write-Information |
saknas | Förloppsström | PowerShell 3.0 | Write-Progress |
Anteckning
Förloppsströmmen stöder inte omdirigering.
Lyckad ström
Dataströmmen Lyckades ä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. Dataströmmen lyckades är ansluten till stdout-strömmen för interna program.
Felström
Felströmmen är standardströmmen för felresultat. Använd cmdleten Write-Error
för att uttryckligen skriva till den här dataströmmen. Felströmmen är ansluten till stderr-dataströmmen för interna 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 finns i about_Automatic_Variables.
Varningsström
Varningsströmmen är avsedd för feltillstånd som är mindre allvarliga än fel som skrivs till felströ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 dataströmmen.
Utförlig ström
Den utförliga strömmen är avsedd för meddelanden som hjälper användare 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 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 -Verbose
gemensamma parametern. Mer information finns i about_CommonParameters.
Felsöka dataström
Felsökningsströ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 dataströmmen. Felsökningsmeddelandena matas bara ut när du använder den -Debug
gemensamma parametern. Mer information finns i about_CommonParameters.
Felsökningsmeddelanden ä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.
Informationsström
Informationsströmmen är avsedd att ge ett meddelande som hjälper en användare att förstå vad ett skript gör. Den kan också användas av utvecklare som ytterligare en 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 dataströmmen.
Förloppsström
Förloppsströmmen används för meddelanden som kommunicerar förlopp 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. Förloppsströmmen stöder inte omdirigering.