Tee-Object

Modul:: Microsoft.PowerShell.Utility Module

Fájlba vagy változóba menti a parancskimenetet, és elküldi a folyamatnak.

Syntax

File (Alapértelmezett)

Tee-Object
    [-FilePath] <String>
    [[-Encoding] <Encoding>]
    [-InputObject <PSObject>]
    [-Append]
    [<CommonParameters>]

LiteralFile

Tee-Object
    [[-Encoding] <Encoding>]
    -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: 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.

5. 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

-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: Az UTF-16 formátumú kódolást a big-endian bájtsorrend alkalmazásával végzi.
oem: Az alapértelmezett kódolást használja MS-DOS és konzolprogramokhoz.
unicode: Az UTF-16 formátumban kódol kis végű bájtsorrend használatával.
utf7: UTF-7 formátumban kódol.
utf8: UTF-8 formátumban kódol.
utf8BOM: UTF-8 formátumban kódolódik bájt sorrendi jel (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.

Megjegyzés:

UTF-7* már nem ajánlott. PowerShell 7.1-től kezdve figyelmeztetés jelenik meg, ha utf7-et ad meg a kódolás paraméterhez.

Paramétertulajdonságok

Típus:	Encoding
Alapértelmezett érték:	UTF8NoBOM
Elfogadott értékek:	ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	1
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.

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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False
Aliasok:	Útvonal

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, LP

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 PowerShell a következő aliasokat tartalmazza Tee-Object:

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 folyamaton.

A PowerShell 6-tól kezdve 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.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Megosztás a következőn keresztül:

Tee-Object

Syntax

File (Alapértelmezett)

LiteralFile

Variable

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

5. példa: A "Tee-Object" használata a **WhatIf** paraméterrel rendelkező szkriptben

Paraméterek

-Append

Paramétertulajdonságok

Paraméterkészletek

-Encoding

Paramétertulajdonságok

Paraméterkészletek

-FilePath

Paramétertulajdonságok

Paraméterkészletek

-InputObject

Paramétertulajdonságok

Paraméterkészletek

-LiteralPath

Paramétertulajdonságok

Paraméterkészletek

-Variable

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Bevitelek

PSObject

Kimenetek

PSObject

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés

5. példa: A "Tee-Object" használata a WhatIf paraméterrel rendelkező szkriptben