Skriv-output (Microsoft.PowerShell.Utility) - PowerShell | Microsoft Docs

-modul: Microsoft.PowerShell.Utility

Sender de angivne objekter til den næste kommando i pipelinen. Hvis kommandoen er den sidste kommando i rørledningen, vises objekterne i konsollen.

Syntaks

Beskrivelse

Write-Output cmdlet sender det angivne objekt ned ad pipelinen til den næste kommando. Hvis kommandoen er den sidste kommando i pipelinen, er objektet vises i konsollen.

Write-Output sender objekter ned ad den primære pipeline, også kendt som “output stream” eller “success pipeline.” Brug skrivefejl til at sende fejlobjekter ned ad fejlrørledningen.

Denne cmdlet bruges typisk i scripts til at vise strenge og andre objekter på konsollen. Et af de indbyggede aliasser til Write-Output er echo og ligner andre skaller, der bruger echo, standardadfærden er at vise output i slutningen af en rørledning. I PowerShell er det generelt ikke nødvendigt at bruge cmdlet i tilfælde, hvor output vises som standard. For eksempel svarer Get-Process | Write-Output til Get-Process. Eller echo "Home directory: $HOME" kan skrives, "Home directory: $HOME".

Som standard Write-Output opregner gennem samlinger, der leveres til cmdlet. Imidlertid kan Write-Output også bruges til at sende samlinger ned ad rørledningen som et enkelt objekt med parameteren NoEnumerate.

Eksempler

Eksempel 1: Få objekter og skriv dem til konsollen

Den første kommando henter processer, der kører på computeren, og gemmer dem i $P variabel.

Det andet og tredje kommando viser procesobjekterne i $P på konsollen.

Eksempel 2: Pass output til en anden cmdlet

Denne kommando leder “testoutput” -strengen til Get-Member cmdlet, som viser medlemmer af System.String-klassen, der viser, at strengen blev sendt langs pipelinen.

Eksempel 3: Undertryk optælling i output

Denne kommando tilføjer parameteren NoEnumerate for at behandle en samling eller et array som et enkelt objekt gennem pipelinen.

Parametre

-InputObject

Angiver de objekter, der skal sendes ned i rørledningen. Indtast en variabel, der indeholder objekterne, eller skriv kommandoen eller udtrykket, der får objekterne.

Type:	PSObject
Position:	0
Standardværdi:	Ingen
Accepter pipeline-input:	Sandt
Accepter jokertegntegn:	Falsk

-NoEnumerate

Som standard er Write-Output cmdlet tæller altid dens output. NoEnumerate-parametrene undertrykker standardadfærd og forhindrer Write-Output i at tælle output. Parameteren NoEnumerate har ingen virkning, hvis kommandoen er pakket i parentes, fordi parenteserne tvinger optælling. For eksempel tæller (Write-Output 1,2,3) arrayet stadig.

Bemærk

Denne switch fungerer kun korrekt med PowerShell Core 6.2 og nyere. På ældre versioner af PowerShell Core er samlingen stadig opregnet, selv ved brug af denne switch.

Type:	SwitchParameter
Position:	Navngivet
Standardværdi:	Ingen
Accepter pipeline-input:	Falsk
Accepter jokertegn:	Falsk

Indgange

PSObject

Du kan rør objekter til Write-Output.

Udgange