Sender de angitte objektene til neste kommando i rørledningen. Hvis kommandoen er den siste kommandoen i rørledningen, vises objektene i konsollen.
Syntaks
Beskrivelse
Write-Output cmdlet sender det spesifiserte objektet nedover i rørledningen til neste kommando. Hvis kommandoen er den siste kommandoen i rørledningen, blir objektet vises i konsollen.
Write-Output sender objekter nedover den primære rørledningen, også kjent som «output stream» eller «success pipeline.» For å sende feilobjekter nedover feilrørledningen, bruk skrivfeil.
Denne cmdleten brukes vanligvis i skript for å vise strenger og andre objekter på konsollen. Et av de innebygde aliasene for Write-Output er echo og ligner på andre skjell som bruker echo, standard oppførsel er å vise utdata på slutten av en rørledning. I PowerShell er det vanligvis ikke nødvendig å bruke cmdlet i tilfeller der utdataene vises som standard. For eksempel Get-Process | Write-Output tilsvarer Get-Process. Eller echo "Home directory: $HOME" kan skrives, "Home directory: $HOME".
Som standard er Write-Output oppregner gjennom samlinger gitt til cmdleten. Imidlertid kan Write-Output også brukes til å sende samlinger nedover rørledningen som et enkelt objekt med parameteren NoEnumerate.
Eksempler
Eksempel 1: Få objekter og skriv dem til konsollen
Den første kommandoen får prosesser som kjører på datamaskinen, og lagrer dem i $P variabel.
Den andre og tredje kommandoen viser prosessobjektene i $P på konsollen.
Eksempel 2: Bestått utgang til en annen cmdlet
Denne kommandoen rør «testoutput» -strengen til Get-Member cmdlet, som viser medlemmer av System.String-klassen, som demonstrerer at strengen ble sendt langs rørledningen.
Eksempel 3: Undertrykk oppregning i utdata
Denne kommandoen legger til NoEnumerate-parameteren for å behandle en samling eller matrise som et enkelt objekt gjennom rørledningen.
Parametere
Spesifiserer objektene som skal sendes ned i rørledningen. Skriv inn en variabel som inneholder objektene, eller skriv kommandoen eller uttrykket som får objektene.
| Type: | PSObject |
| Posisjon: | 0 |
| Standardverdi: | Ingen |
| Godta rørinngang: | True |
| Godta jokertegn: | Usann |
Som standard er Write-Output cmdlet teller alltid utdataene. NoEnumerate-parametrene undertrykker standardadferd og forhindrer Write-Output i å telle utdata. Parameteren NoEnumerate har ingen effekt hvis kommandoen er pakket inn i parentes, fordi parentesene tvinger opptelling. For eksempel teller (Write-Output 1,2,3) fortsatt matrisen.
Merk
Denne bryteren fungerer bare riktig med PowerShell Core 6.2 og nyere. På eldre versjoner av PowerShell Core er samlingen fortsatt oppført selv ved bruk av denne bryteren.
| Type: | SwitchParameter |
| Posisjon: | Navngitt |
| Standardverdi: | Ingen |
| Godta rørinngang: | Falsk |
| Godta jokertegn: | Falsk |
Innganger
PSObject
Du kan rør objekter til Write-Output.
Utganger
PSObject
Write-Output returnerer objektene som sendes som input.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Skriv-feilsøking
- Skrivfeil
- Skrivvert
- Skrivinformasjon
- Skriv-fremgang
- Skriv-uttalt
- Skriveadvarsel