Tee-Object
Fájlba vagy változóba menti a parancskimenetet, és elküldi a folyamatnak.
Syntax
File (Alapértelmezett)
Tee-Object
[-FilePath] <String>
[-InputObject <PSObject>]
[-Append]
[<CommonParameters>]
LiteralFile
Tee-Object
-LiteralPath <String>
[-InputObject <PSObject>]
[<CommonParameters>]
Variable
Tee-Object
-Variable <String>
[-InputObject <PSObject>]
[<CommonParameters>]
Description
A Tee-Object parancsmag két irányban írja a kimenetet. A kimenetet egy fájlban vagy változóban tárolja, és a folyamaton keresztül is elküldi. Ha Tee-Object a folyamat utolsó parancsa, a parancs kimenete megjelenik a konzolon.
Belsőleg a Tee-Object parancsokat és Out-File a Set-Variable parancsokat használja. Ezek a parancsok támogatják a WhatIf paramétert. A Tee-Object parancs nem támogatja a WhatIf paramétert. Ha azonban a WhatIf paramétert támogató szkriptet vagy függvényt burkolTee-Object, Tee-Object a WhatIf állapotát átadja a parancsok és Out-File a Set-Variable parancsok számára.
Példák
1. példa: Kimeneti folyamatok fájlba és konzolra
Ez a példa lekéri a számítógépen futó folyamatok listáját, és elküldi az eredményt egy fájlnak. Mivel nincs megadva második elérési út, a folyamatok a konzolon is megjelennek.
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
...
2. példa: Folyamatok kimenete változóhoz és "Select-Object"
Ez a példa lekéri a számítógépen futó folyamatok listáját, menti őket a $proc változóba, és Select-Object.
Get-Process notepad | Tee-Object -Variable proc | Select-Object ProcessName, Handles
ProcessName Handles
----------- -------
notepad 43
notepad 37
notepad 38
notepad 38
A Select-Object parancsmag kiválasztja a ProcessName és Handles tulajdonságokat. Vegye figyelembe, hogy a $proc változó tartalmazza a Get-Processáltal visszaadott alapértelmezett adatokat.
3. példa: Rendszerfájlok kimenete két naplófájlba
Ez a példa a rendszerfájlok listáját két naplófájlba, egy összegző fájlba és egy aktuális fájlba menti.
Get-ChildItem -Path D: -File -System -Recurse |
Tee-Object -FilePath "C:\test\AllSystemFiles.txt" -Append |
Out-File C:\test\NewSystemFiles.txt
A parancs a Get-ChildItem parancsmaggal végez rekurzív keresést a D: meghajtón található rendszerfájlokban. A folyamatkezelő (|) elküldi a listát Tee-Object, amely hozzáfűzi a listát a AllSystemFiles.txt fájlhoz, és átadja a listát a folyamatnak a Out-File parancsmagnak, amely menti a listát a NewSystemFiles.txt file.
4. példa: A "Tee-Object" használata a **WhatIf** paraméterrel rendelkező szkriptben
A Tee-Object parancs nem támogatja a WhatIf paramétert. Ha azonban a WhatIf paramétert támogató szkriptet vagy függvényt burkolTee-Object, Tee-Object a WhatIf állapotát átadja a Set-VariableOut-File belsőleg használt parancsnak.
PS> function Test-Tee {
[Cmdletbinding(SupportsShouldProcess)]
Param()
$true|tee -Variable b
"Variable `$b is set to '$b'"
}
PS> Test-Tee
True
Variable $b is set to 'True'
PS> Test-Tee -WhatIf
True
What if: Performing the operation "Set variable" on target "Name: b Value: True".
Variable $b is set to ''
Paraméterek
-Append
Azt jelzi, hogy a parancsmag hozzáfűzi a kimenetet a megadott fájlhoz. E paraméter nélkül az új tartalom figyelmeztetés nélkül lecseréli a fájl meglévő tartalmát.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
File
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-FilePath
Olyan fájlt ad meg, amelyet ez a parancsmag az objektumot helyettesítő karakterekre ment, engedélyezett, de egyetlen fájlra kell feloldania.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
File
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Megadja a menteni és megjeleníteni kívánt objektumot. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat. Az objektumokat Tee-Objectis becsúszthatja.
Ha a InputObject paramétert Tee-Objecthasználja, a parancsok eredményeinek Tee-Objecthelyett az InputObject érték egyetlen objektumként lesz kezelve, még akkor is, ha az érték gyűjtemény.
Paramétertulajdonságok
| Típus: | PSObject |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Megadja azt a fájlt, amelybe a parancsmag menti az objektumot. A FilePath-tal ellentétben a LiteralPath paraméter értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
Paraméterkészletek
LiteralFile
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Variable
Megadja azt a változót, amelybe a parancsmag menti az objektumot. Adjon meg egy változónevet az előző dollárjel ($) nélkül.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Variable
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSObject
Ehhez a parancsmaghoz csövezhet objektumokat.
Kimenetek
PSObject
Ez a parancsmag visszaadja az átirányított objektumot.
Jegyzetek
A Windows PowerShell a Tee-Objectkövetkező aliasait tartalmazza:
tee
Használhatja a Out-File parancsmagot vagy az átirányítási operátort is, amelyek mindegyike fájlba menti a kimenetet, de nem küldi el a folyamaton.
Tee-Object "Unicode" (UTF-16LE) kódolást használ, amikor fájlokat ír. Ha más kódolásra van szüksége, használja a Out-File parancsmagot a Kódolás paraméterrel.
