Stuurt de opgegeven objecten naar de volgende opdracht in de pijplijn. Als het commando het laatste commando in de pijplijn is, worden de objecten weergegeven in de console.
Syntaxis
Beschrijving
De Write-Output cmdlet stuurt het opgegeven object door de pijplijn naar het volgende commando. Als het commando het laatste commando in de pijplijn is, zal het object wordt weergegeven in de console.
Write-Output stuurt objecten door de primaire pijplijn, ook bekend als de “uitvoerstroom” of de “succespijplijn”. Gebruik Write-Error om foutobjecten door de foutpijplijn te sturen.
Deze cmdlet wordt meestal gebruikt in scripts om strings en andere objecten op de console weer te geven. Een van de ingebouwde aliassen voor Write-Output is echo en vergelijkbaar met andere shells die echo is het standaardgedrag om de uitvoer aan het einde van een pijplijn weer te geven. In PowerShell is het over het algemeen niet nodig om de cmdlet te gebruiken in gevallen waarin de uitvoer standaard wordt weergegeven. Get-Process | Write-Output is bijvoorbeeld gelijk aan Get-Process. Of echo "Home directory: $HOME" kan worden geschreven, "Home directory: $HOME".
Standaard Write-Output inventariseert via verzamelingen die aan de cmdlet zijn geleverd. Write-Output kan echter ook worden gebruikt om verzamelingen door de pijplijn door te geven als een enkel object met de parameter NoEnumerate.
Voorbeelden
Voorbeeld 1: Haal objecten op en schrijf ze naar de console
De eerste opdracht zorgt ervoor dat processen op de computer worden uitgevoerd en slaat ze op in de $P variabele.
De tweede en derde opdracht geven de procesobjecten weer in $P op de console.
Voorbeeld 2: uitvoer doorgeven naar een andere cmdlet
Deze opdracht leidt de “test output” -reeks naar de Get-Member cmdlet, die de leden van de klasse System.String, waarmee wordt aangetoond dat de tekenreeks langs de pijplijn is doorgegeven.
Voorbeeld 3: opsomming in uitvoer onderdrukken
Deze opdracht voegt de parameter NoEnumerate toe om een verzameling of array als een enkel object door de pijplijn te behandelen.
Parameters
Specificeert de objecten die door de pijplijn moeten worden verzonden. Voer een variabele in die de objecten bevat, of typ een opdracht of uitdrukking die de objecten ophaalt.
| Type: | PSObject |
| Positie: | 0 |
| Standaardwaarde: | Geen |
| Pijplijninvoer accepteren: | Waar |
| Jokertekens accepteren: | False |
Standaard is de Write-Output cmdlet somt altijd zijn uitvoer op. De parameter NoEnumerate onderdrukt het standaardgedrag en voorkomt dat Write-Output uitvoer kan opsommen. De parameterNoEnumerate heeft geen effect als de opdracht tussen haakjes staat, omdat de haakjes opsomming afdwingen. (Write-Output 1,2,3) somt bijvoorbeeld nog steeds de array op.
Opmerking
Deze switch werkt alleen correct met PowerShell Core 6.2 en nieuwer. Op oudere versies van PowerShell Core wordt de verzameling nog steeds opgesomd, zelfs met gebruik van deze schakelaar.
| Type: | SwitchParameter |
| Positie: | Named |
| Standaardwaarde: | Geen |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Inputs
PSObject
U kunt pipe objecten naar Write-Output.
Uitgangen
PSObject
Write-Output geeft de objecten terug die als invoer zijn ingediend.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Write-Debug
- Schrijffout
- Write-Host
- Write-informatie
- Write-voortgang
- Write-verbose
- Schrijfwaarschuwing