Freigeben über

Write-Output

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Schreibt die angegebenen Objekte in die Pipeline.

Syntax

Write-Output
     [-InputObject] <PSObject[]>
     [-NoEnumerate]
     [<CommonParameters>]

Beschreibung

Schreibt die angegebenen Objekte in die Pipeline. Wenn Write-Output es sich um den letzten Befehl in der Pipeline handelt, werden die Objekte in der Konsole angezeigt.

Write-Output sendet Objekte an die primäre Pipeline, auch bekannt als Erfolgsstream. Um Fehlerobjekte an den Fehlerdatenstrom zu senden, verwenden Sie Write-Error.

Dieses Cmdlet wird in der Regel in Skripts verwendet, um Zeichenfolgen und andere Objekte in der Konsole anzuzeigen. Einer der integrierten Aliase ist Write-Output und ähnelt echo anderen Shells, die verwendet werden echo. Das Standardverhalten besteht darin, die Ausgabe am Ende einer Pipeline anzuzeigen. In PowerShell ist es in der Regel nicht erforderlich, das Cmdlet in Instanzen zu verwenden, in denen die Ausgabe standardmäßig angezeigt wird. Get-Process | Write-Output entspricht beispielsweise Get-Process. Oder kann geschrieben werden, echo "Home directory: $HOME" "Home directory: $HOME".

Standardmäßig Write-Output werden Objekte in einer Auflistung aufgezählt. Write-Output Kann jedoch auch Auflistungen als einzelnes Objekt mit dem Parameter NoEnumerate an die Pipeline übergeben.

Beispiele

Beispiel 1: Abrufen von Objekten und Schreiben in die Konsole

In diesem Beispiel werden die Ergebnisse des Get-Process Cmdlets in der $P Variablen gespeichert. Das Write-Output Cmdlet zeigt die Prozessobjekte in $P der Konsole an.

$P = Get-Process
Write-Output $P

Beispiel 2: Übergeben der Ausgabe an ein anderes Cmdlet

Mit diesem Befehl wird die Zeichenfolge "Testausgabe" an das Get-Member Cmdlet weitergeleitet, das die Member der System.String-Klasse anzeigt und zeigt, dass die Zeichenfolge entlang der Pipeline übergeben wurde.

Write-Output "test output" | Get-Member

Beispiel 3: Unterdrücken der Enumeration in der Ausgabe

Mit diesem Befehl wird der NoEnumerate-Parameter hinzugefügt, um eine Auflistung oder ein Array als einzelnes Objekt über die Pipeline zu behandeln.

Write-Output 1,2,3 | Measure-Object

Count    : 3
...

Write-Output 1,2,3 -NoEnumerate | Measure-Object

Count    : 1
...

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 einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Typ:PSObject[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NoEnumerate

Standardmäßig listet das Write-Output Cmdlet die Ausgabe immer auf. Der Parameter NoEnumerate unterdrückt das Standardverhalten und verhindert Write-Output das Aufzählen der Ausgabe. Der Parameter NoEnumerate hat keine Auswirkung, wenn der Befehl in Klammern eingeschlossen wird, da die Enumeration der Klammern erzwungen wird. Beispielsweise (Write-Output 1,2,3) zählt das Array weiterhin auf.

Der Parameter NoEnumerate ist nur in einer Pipeline nützlich. Der Versuch, die Auswirkungen von NoEnumerate in der Konsole zu sehen, ist problematisch, da PowerShell am Ende jeder Befehlszeile hinzufügt Out-Default , was zu Enumeration führt. Wenn Sie jedoch eine Weiterleitung an ein anderes Cmdlet ausführen Write-Output -NoEnumerate , empfängt das downstream-Cmdlet das Auflistungsobjekt, nicht die aufgezählten Elemente der Auflistung.

Wichtig

Es gibt ein Problem mit diesem Switch in Windows PowerShell, das in PowerShell 6.2 und höher behoben ist. Bei Verwendung von NoEnumerate und expliziter Verwendung des InputObject-Parameters zählt der Befehl weiterhin auf. Um dies zu umgehen, übergeben Sie das InputObject-Argument (n) positional.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSObject

Sie können Objekte an dieses Cmdlet weiterleiten.

Ausgaben

PSObject

Dieses Cmdlet gibt die Objekte zurück, die als Eingabe übermittelt werden.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Write-Output:

  • echo
  • write