Tee-Object
Hiermee wordt de opdrachtuitvoer opgeslagen in een bestand of variabele en wordt deze ook naar beneden verzonden naar de pijplijn.
Syntaxis
Tee-Object
[-InputObject <PSObject>]
[-FilePath] <String>
[-Append]
[<CommonParameters>]
Tee-Object
[-InputObject <PSObject>]
-LiteralPath <String>
[<CommonParameters>]
Tee-Object
[-InputObject <PSObject>]
-Variable <String>
[<CommonParameters>]
Description
De Tee-Object
cmdlet stuurt uitvoer om, dat wil gezegd, de uitvoer van een opdracht in twee richtingen (zoals de letter T). De uitvoer wordt opgeslagen in een bestand of variabele en verzendt deze ook naar beneden in de pijplijn. Als Tee-Object
dit de laatste opdracht in de pijplijn is, wordt de opdrachtuitvoer weergegeven bij de prompt.
Voorbeelden
Voorbeeld 1: Uitvoerprocessen naar een bestand en naar de console
In dit voorbeeld wordt een lijst weergegeven met de processen die op de computer worden uitgevoerd en wordt het resultaat naar een bestand verzonden. Omdat er geen tweede pad is opgegeven, worden de processen ook weergegeven in de console.
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
...
Voorbeeld 2: Uitvoerprocessen naar een variabele en Select-Object
In dit voorbeeld wordt een lijst weergegeven met de processen die op de computer worden uitgevoerd, worden ze opgeslagen in de $proc
variabele en worden ze door leidingen naar Select-Object
.
Get-Process notepad | Tee-Object -Variable proc | Select-Object processname,handles
ProcessName Handles
----------- -------
notepad 43
notepad 37
notepad 38
notepad 38
De Select-Object
cmdlet selecteert de eigenschappen ProcessName en Handles . Houd er rekening mee dat de $proc
variabele de standaardgegevens bevat die worden geretourneerd door Get-Process
.
Voorbeeld 3: Systeembestanden uitvoeren naar twee logboekbestanden
In dit voorbeeld wordt een lijst met systeembestanden opgeslagen in twee logboekbestanden, een cumulatief bestand en een huidig bestand.
Get-ChildItem -Path D: -File -System -Recurse |
Tee-Object -FilePath "c:\test\AllSystemFiles.txt" -Append |
Out-File c:\test\NewSystemFiles.txt
De opdracht gebruikt de Get-ChildItem
cmdlet om een recursieve zoekopdracht uit te voeren naar systeembestanden op het station D: . Een pijplijnoperator (|
) verzendt de lijst naar Tee-Object
, waarmee de lijst wordt toegevoegd aan het AllSystemFiles.txt-bestand en de lijst wordt doorgegeven aan de Out-File
cmdlet, waarmee de lijst in de NewSystemFiles.txt file
lijst wordt opgeslagen.
Parameters
-Append
Geeft aan dat de cmdlet de uitvoer toevoegt aan het opgegeven bestand. Zonder deze parameter vervangt de nieuwe inhoud alle bestaande inhoud in het bestand zonder waarschuwing.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-FilePath
Hiermee geeft u een bestand op dat het object door deze cmdlet wordt opgeslagen in jokertekens, maar moet worden omgezet in één bestand.
Type: | String |
Position: | 0 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | True |
-InputObject
Hiermee geeft u het object op dat moet worden opgeslagen en weergegeven. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald. U kunt ook een object doorsluisen naar Tee-Object
.
Wanneer u de parameter InputObject gebruikt met Tee-Object
, in plaats van de opdrachtresultaten Tee-Object
door te geven , wordt de Waarde InputObject behandeld als één object, zelfs als de waarde een verzameling is.
Type: | PSObject |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-LiteralPath
Hiermee geeft u een bestand op waarnaar het object door deze cmdlet wordt opgeslagen. In tegenstelling tot FilePath wordt de waarde van de Parameter LiteralPath precies gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.
Type: | String |
Aliassen: | PSPath |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Variable
Hiermee geeft u een variabele op waarnaar het object wordt opgeslagen door de cmdlet. Voer een variabelenaam in zonder het voorgaande dollarteken ($
).
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
U kunt objecten doorsluisen naar deze cmdlet.
Uitvoerwaarden
Met deze cmdlet wordt het object geretourneerd dat wordt omgeleid.
Notities
Windows PowerShell bevat de volgende aliassen voor Tee-Object
:
tee
U kunt ook de Out-File
cmdlet of de omleidingsoperator gebruiken, die beide de uitvoer opslaan in een bestand, maar deze niet naar de pijplijn verzenden.
Tee-Object
gebruikt UTF-16LE-codering (Unicode) wanneer deze naar bestanden schrijft. Als u een andere codering nodig hebt, gebruikt u de Out-File
cmdlet met de parameter Encoding .