Write-Output
Sendet die angegebenen Objekte an den nächsten Befehl in der Pipeline. Wenn der Befehl der letzte Befehl in der Pipeline ist, werden die Objekte in der Konsole angezeigt.
Syntax
Default (Standard)
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Beschreibung
Das cmdlet Write-Output sendet das angegebene Objekt an den nächsten Befehl nach unten. Wenn der Befehl der letzte Befehl in der Pipeline ist, wird das Objekt in der Konsole angezeigt.
Write-Output- sendet Objekte an die primäre Pipeline, auch als "Ausgabestream" oder "Erfolgspipeline" bezeichnet. Verwenden Sie "Write-Error", um Fehlerobjekte nach unten in der Fehlerpipeline zu senden.
Dieses Cmdlet wird in der Regel in Skripts zum Anzeigen von Zeichenfolgen und anderen Objekten auf der Konsole verwendet.
Da das Standardverhalten jedoch darin besteht, die Objekte am Ende einer Pipeline anzuzeigen, ist es in der Regel nicht erforderlich, das Cmdlet zu verwenden.
Beispielsweise entspricht Get-Process | Write-OutputGet-Process.
Beispiele
Beispiel 1: Abrufen von Objekten und Ausgabe auf die Konsole
PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P
Der erste Befehl ruft Prozesse auf dem Computer ab und speichert sie in der $P Variablen.
Die zweiten und dritten Befehle zeigen die Prozessobjekte in $P auf der Konsole an.
Beispiel 2: Übergeben der Ausgabe an ein anderes Cmdlet
PS C:\> Write-Output "test output" | Get-Member
Mit diesem Befehl wird die Zeichenfolge "Testausgabe" an das Cmdlet Get-Member weitergeleitet, das die Member der System.String Klasse anzeigt, die zeigt, dass die Zeichenfolge entlang der Pipeline übergeben wurde.
Beispiel 3: Unterdrücken der Enumeration in der Ausgabe
PS C:\> Write-Output @(1,2,3) | measure
Count : 3
...
PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure
Count : 1
Dieser Befehl fügt den NoEnumerate-Parameter hinzu, um eine Auflistung oder ein Array als ein einzelnes Objekt über die Pipeline zu verarbeiten.
Parameter
-InputObject
Gibt die Objekte an, die über die Pipeline gesendet werden sollen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte ermittelt.
Parametereigenschaften
| Typ: | PSObject[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-NoEnumerate
Standardmäßig zählt das Cmdlet Write-Output die Ausgabe immer auf. Das NoEnumerate Parameter unterdrückt das Standardverhalten und verhindert, dass Write-Output- die Ausgabe aufzählt. Die NoEnumerate Parameter hat keine Auswirkungen auf Auflistungen, die durch Umbruchbefehle in Klammern erstellt wurden, da die Enumeration der Klammern erzwungen wird.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
PSObject
Sie können Objekte an Write-Output-pfeifen.
Ausgaben
PSObject
Write-Output- gibt die Objekte zurück, die als Eingabe übermittelt werden.