Tee-Object
Fájlba vagy változóba menti a parancskimenetet, és elküldi a folyamatnak.
Syntax
Tee-Object
[-InputObject <PSObject>]
[-FilePath] <String>
[-Append]
[[-Encoding] <Encoding>]
[<CommonParameters>]
Tee-Object
[-InputObject <PSObject>]
-LiteralPath <String>
[[-Encoding] <Encoding>]
[<CommonParameters>]
Tee-Object
[-InputObject <PSObject>]
-Variable <String>
[<CommonParameters>]
Description
A Tee-Object
parancsmag átirányítja a kimenetet, vagyis egy parancs kimenetét két irányban küldi el (például a T betűt). 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 parancssorban.
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 a következőre Select-Object
csövezi őket.
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 a Handles tulajdonságokat. Vegye figyelembe, hogy a $proc
változó tartalmazza a függvény által visszaadott Get-Process
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 parancsmagot használja a Get-ChildItem
rendszerfájlok rekurzív keresésére a D: meghajtón. A folyamat operátora (|
) elküldi a listát, amely hozzáfűzi a listát Tee-Object
a AllSystemFiles.txt fájlhoz, és átadja a listát a Out-File
parancsmagnak, amely menti a listát a NewSystemFiles.txt file
parancsmagban.
4. példa: Kimenet nyomtatása konzolra, és használat a folyamatban
Ez a példa beolvasja a fájlokat egy mappába, kinyomtatja őket a konzolra, majd szűri a fájlokat azok számára, akik egy meghatározott előtér-metaadat-blokkot használnak. Végül felsorolja az előtérbeli cikkeket.
$consoleDevice = if ($IsWindows) {
'\\.\CON'
} else {
'/dev/tty'
}
$frontMatterPattern = '(?s)^---(?<FrontMatter>.+)---'
$articles = Get-ChildItem -Path .\reference\7.4\PSReadLine\About\ |
Tee-Object -FilePath $consoleDevice |
Where-Object {
(Get-Content $_ -Raw) -match $frontMatterPattern
}
$articles.Name
Directory: C:\code\docs\PowerShell-Docs\reference\7.4\PSReadLine\About
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 12/13/2022 11:37 AM 384 .markdownlint.yaml
-a--- 4/25/2023 11:28 AM 40194 about_PSReadLine_Functions.md
-a--- 4/25/2023 10:58 AM 10064 about_PSReadLine.md
about_PSReadLine_Functions.md
about_PSReadLine.md
A példa a változót $consoleDevice
az aktuális terminál konzoleszközének értékére állítja. Windows rendszeren az aktuális konzoleszközre írhat úgy, hogy átirányítja a kimenetet a \\.\CON
filepathra. Nem Windows rendszerű rendszereken a filepathot /dev/tty
használja.
Ezután egy normál kifejezésre állítja a $frontMatterPattern
változót, amely akkor egyezik, ha egy sztring három kötőjellel (---
) kezdődik, és bármilyen tartalommal rendelkezik egy másik három kötőjel előtt. Ha ez a minta egyezik egy cikk tartalmával, a cikk egy meghatározott előtér-metaadat-blokktal rendelkezik.
Ezután a példa a mappában lévő összes fájl lekérésére About
használjaGet-ChildItem
. Tee-Object
a piped eredményeket a fájlnév paraméterrel nyomtatja ki a konzolra. Where-Object
a fájlokat úgy szűri, hogy a tartalmat egyetlen sztringként kapja meg a karakterlánc Raw paraméterével Get-Content
, és összehasonlítja a következővel $frontMatterPattern
: .
Végül a példa a megadott előtér-metaadatblokkot tartalmazó mappában lévő fájlok nevét nyomtatja ki.
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
Megadja a célfájl kódolási típusát. Az alapértelmezett érték utf8NoBOM
.
A paraméter elfogadható értékei a következők:
ascii
: Az ASCII (7 bites) karakterkészlet kódolását használja.ansi
: Az aktuális kultúra ANSI-kódlapjának kódolását használja. Ez a beállítás a PowerShell 7.4-ben lett hozzáadva.bigendianunicode
: UTF-16 formátumban kódolja a big-endian bájtsorrendet.oem
: Az MS-DOS és a konzolprogramok alapértelmezett kódolását használja.unicode
: UTF-16 formátumban kódolja a kis végű bájtsorrendet.utf7
: UTF-7 formátumban kódol.utf8
: UTF-8 formátumban kódol.utf8BOM
: UTF-8 formátumban kódol byte order mark (BOM)utf8NoBOM
: UTF-8 formátumban kódol byte order mark (BOM) nélkülutf32
: UTF-32 formátumban kódol.
A PowerShell 6.2-től kezdődően a Kódolás paraméter lehetővé teszi a regisztrált kódlapok (például -Encoding 1251
) numerikus azonosítóit vagy a regisztrált kódlapok sztringneveit (például -Encoding "windows-1251"
). További információt a Encoding.CodePage .NET-dokumentációjában talál.
A PowerShell 7.4-től kezdve a Ansi
Kódolás paraméter értékével anélkül adhat meg numerikus azonosítót az aktuális kultúra ANSI-kódlapjához, hogy manuálisan kellene megadnia.
Ez a paraméter a PowerShell 7.2-ben lett bevezetve.
Feljegyzés
Az UTF-7* már nem ajánlott. A PowerShell 7.1-ről figyelmeztetést ír, ha utf7
megadja a Kódolás paramétert.
Type: | Encoding |
Accepted values: | ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
Position: | 1 |
Default value: | UTF8NoBOM |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
A PowerShell 7-től kezdve, amikor a FilePath-t \\.\CON
windowsos vagy /dev/tty
nem Windows rendszerű rendszereken adja meg, az InputObject a konzolon lesz kinyomtatva. Ezek a fájlelérési utak az aktuális terminál konzoleszközének felelnek meg a rendszeren, így egyetlen paranccsal kinyomtathatja az InputObject fájlt, és elküldheti a kimeneti streambe.
Type: | String |
Aliases: | Path |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-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. Egy objektumot is becsúszthat a parancsba Tee-Object
.
Ha az InputObject paramétert Tee-Object
használja a parancs eredményeinek Tee-Object
pipálása helyett, az InputObject érték egyetlen objektumként lesz kezelve, még akkor is, ha az érték gyűjtemény.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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írt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.
Type: | String |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
Ehhez a parancsmaghoz csövezhet objektumokat.
Kimenetek
Ez a parancsmag visszaadja az átirányított objektumot.
Jegyzetek
A PowerShell a következő aliasokat Tee-Object
tartalmazza:
- Windows:
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 folyamatból.
A PowerShell 6-tól kezdődően Tee-Object
BOM-less UTF-8 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.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: