Skickar de angivna objekten till nästa kommando i pipelinen. Om kommandot är det sista kommandot i rörledningen visas objekten i konsolen.
Syntax
Beskrivning
cmdlet skickar det angivna objektet ner i pipelinen till nästa kommando. Om kommandot är det sista kommandot i pipelinen, kommer objektet visas i konsolen.
Write-Output skickar objekt ner i den primära pipelinen, även känd som ”output stream” eller ”success pipeline.” För att skicka felobjekt ner i felrörledningen använder du Skrivfel.
Denna cmdlet används vanligtvis i skript för att visa strängar och andra objekt på konsolen. Ett av de inbyggda alias för Write-Output är echo och liknar andra skal som använder echo, är standardbeteendet att visa utdata i slutet av en rörledning. I PowerShell är det vanligtvis inte nödvändigt att använda cmdlet i fall där utdata visas som standard. Till exempel är Get-Process | Write-Output ekvivalent med Get-Process. Eller, echo "Home directory: $HOME" kan skrivas, "Home directory: $HOME".
Som standard Write-Output räknar upp genom samlingar som tillhandahålls till cmdlet. Write-Output kan emellertid också användas för att skicka samlingar längs rörledningen som ett enda objekt med parametern NoEnumerate.
Exempel
Exempel 1: Skaffa objekt och skriv dem till konsolen
Det första kommandot hämtar processer som körs på datorn och lagrar dem i $P variabel.
Det andra och tredje kommandot visar processobjekten i $P på konsolen.
Exempel 2: Passera utdata till en annan cmdlet
Detta kommando rör ”strängen testutmatning” till Get-Member cmdlet, som visar medlemmar av System.String-klassen, som visar att strängen skickades längs rörledningen.
Exempel 3: Undertrycka uppräkning i utdata
Detta kommando lägger till parametern NoEnumerate för att behandla en samling eller en array som ett enda objekt genom pipelinen.
Parametrar
Anger objekten som ska skickas ner i rörledningen. Ange en variabel som innehåller objekten eller typea-kommandot eller uttrycket som får objekten.
| Typ: | PSObject |
| Position: | 0 |
| Standardvärde: | Ingen |
| Acceptera pipelineingång: | True |
| Acceptera jokertecken: | Falskt |
Som standard är Write-Output cmdlet räknar alltid utdata. Parametrarna NoEnumerate undertrycker standardbeteendet och förhindrar att Write-Output räknar utdata. ParameternNoEnumerate har ingen effekt om kommandot är inslagna inom parentes, eftersom parenteserna tvingar uppräkning. Till exempel (Write-Output 1,2,3) räknar fortfarande upp matrisen.
Obs
Denna omkopplare fungerar bara korrekt med PowerShell Core 6.2 och senare. På äldre versioner av PowerShell Core räknas fortfarande samlingen även med den här växeln.
| Typ: | SwitchParameter |
| Position: | Namngiven |
| Standardvärde: | Ingen |
| Acceptera pipelineingång: | Falskt |
| Acceptera jokertecken: | Falskt |
Ingångar
PSObject
Du kan rör objekt till Write-Output.
Utgångar
PSObject
Write-Output returnerar objekten som skickas som input.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Write-Debug
- Skriv-fel
- Skriv-värd
- Skriv-information
- Skriv-framsteg
- Skriv-Verb
- Skrivvarning