Tee-Object

Referencia

Modul:: Microsoft.PowerShell.Utility

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, azaz két irányban küldi el a parancs kimenetét (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 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: 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 $consoleDevice változót 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 /dev/tty filepathot használja.

Ezután a $frontMatterPattern változót egy olyan reguláris kifejezésre állítja be, amely akkor egyezik meg, 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 Get-ChildItem használ a About mappában lévő összes fájl lekéréséhez. Tee-Object a FileName paraméterrel nyomtatja ki a vezetékes eredményeket a konzolra. Where-Object a fájlokat úgy szűri, hogy a tartalmat egyetlen sztringként kapja meg a Get-Content paraméterével, és összehasonlítja a sztringet $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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Encoding

Megadja a célfájl kódolási típusát. Az alapértelmezett érték a 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 alapértelmezett kódolást használja MS-DOS és konzolprogramokhoz.
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átumú kódolók byte order mark (BOM) használatával
utf8NoBOM: UTF-8 formátumban kódol byte order mark (BOM) nélkül
utf32: 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 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.

Jegyzet

UTF-7* már nem ajánlott. A PowerShell 7.1-ről figyelmeztetést írunk, ha utf7 a Kódolás paraméterhez.

Típus:	Encoding
Elfogadott értékek:	ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	1
Alapértelmezett érték:	UTF8NoBOM
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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\\.\CON windowsos vagy nem Windows rendszerű rendszereken /dev/tty adja meg, a 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 kinyomtathatja a InputObject, és egyetlen paranccsal elküldheti a kimeneti streambe.

Típus:	String
Aliasok:	Path
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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. 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.

Típus:	PSObject
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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 ú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.

Típus:	String
Aliasok:	PSPath, LP
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

PSObject

Ehhez a parancsmaghoz csövezhet objektumokat.

Kimenetek