Tee-Object
Speichert die Befehlsausgabe in einer Datei oder Variablen und zeigt sie in der Konsole an.
Syntax
Tee-Object [-FilePath] <string> [-InputObject <psobject>] [<CommonParameters>]
Tee-Object -Variable <string> [-InputObject <psobject>] [<CommonParameters>]
Beschreibung
Das Cmdlet "Tee-Object" sendet die Ausgabe eines Befehls in zwei Richtungen (symbolisiert durch den Buchstaben "T"). Es speichert die Ausgabe in einer Datei oder Variablen und sendet sie außerdem über die Pipeline. Wenn Tee-Object der letzte Befehl in der Pipeline ist, wird die Befehlsausgabe in der Konsole angezeigt.
Parameter
-FilePath <string>
Gibt die Datei an, in der das Cmdlet das Objekt speichert. Akzeptiert Platzhalter, die in eine einzelne Datei aufgelöst werden können.
Erforderlich? |
true |
Position? |
1 |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-InputObject <psobject>
Gibt die Objekteingabe für das Cmdlet an. 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.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-Variable <string>
Weist der angegebenen Variablen einen Verweis auf die Eingabeobjekte zu.
Erforderlich? |
true |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
Eingaben |
System.Management.Automation.PSObject Sie können umzuleitende Objekte über die Pipeline an Tee-Object übergeben. |
Ausgaben |
System.Management.Automation.PSObject Tee-Object gibt das Objekt zurück, das von ihm umgeleitet wurde. |
Hinweise
Sie können auch das Cmdlet "Out-File" oder den Umleitungsoperator verwenden. Mit beiden Verfahren wird die Ausgabe in einer Datei gespeichert, jedoch nicht über die Pipeline gesendet.
Tee-Object verwendet beim Schreiben in Dateien Unicode-Codierung. Dies kann dazu führen, dass die Ausgabe in Dateien mit einer anderen Codierung nicht ordnungsgemäß formatiert ist. Geben Sie die Codierung mit dem Cmdlet "Out-File" an.
Beispiel 1
C:\PS>get-process | tee-object -filepath C:\Test1\testfile2.txt
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
83 4 2300 4520 39 0.30 4032 00THotkey
272 6 1400 3944 34 0.06 3088 alg
81 3 804 3284 21 2.45 148 ApntEx
81 4 2008 5808 38 0.75 3684 Apoint
...
Beschreibung
-----------
Mit diesem Befehl wird eine Liste der auf dem Computer ausgeführten Prozesse abgerufen und das Ergebnis an eine Datei gesendet. Da kein zweiter Pfad angegeben wurde, wird das Ergebnis in der Konsole angezeigt.
Beispiel 2
C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles
ProcessName Handles
----------- -------
notepad 43
notepad 37
notepad 38
notepad 38
Beschreibung
-----------
Mit diesem Befehl wird eine Liste der auf dem Computer ausgeführten Prozesse abgerufen und das Ergebnis an die Variable "proc" gesendet. Anschließend werden die resultierenden Objekte über die Pipeline an Select-Object übergeben, das die ProcessName-Eigenschaft und die Handles-Eigenschaft auswählt. Beachten Sie, dass die Variable "$proc" die von Get-Process zurückgegebenen Standardinformationen enthält.