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, 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-Objectcsö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-Processalapé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-Objecta AllSystemFiles.txt fájlhoz, és átadja a listát a Out-File parancsmagnak, amely menti a listát a NewSystemFiles.txt fileparancsmagban.

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-Objecta 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.
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ü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.

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-Objecthasználja a parancs eredményeinek Tee-Objectpipá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

PSObject

Ehhez a parancsmaghoz csövezhet objektumokat.

Kimenetek

PSObject

Ez a parancsmag visszaadja az átirányított objektumot.

Jegyzetek

A PowerShell a következő aliasokat Tee-Objecttartalmazza:

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.

Tee-Object

Syntax

Description

Példák

1. példa: Kimeneti folyamatok fájlba és konzolra

2. példa: Folyamatok kimenete változóhoz és "Select-Object"

3. példa: Rendszerfájlok kimenete két naplófájlba

4. példa: Kimenet nyomtatása konzolra, és használat a folyamatban

Paraméterek

-Append

-Encoding

-FilePath

-InputObject

-LiteralPath

-Variable

Bevitelek

Kimenetek

Jegyzetek

Visszajelzés

További források

Tee-Object

Syntax

Description

Példák

1. példa: Kimeneti folyamatok fájlba és konzolra

2. példa: Folyamatok kimenete változóhoz és "Select-Object"

3. példa: Rendszerfájlok kimenete két naplófájlba

4. példa: Kimenet nyomtatása konzolra, és használat a folyamatban

Paraméterek

-Append

-Encoding

-FilePath

-InputObject

-LiteralPath

-Variable

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés

További források