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

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>
    [-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 átirányítja a kimenetet, vagyis 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

PS C:\> 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
...

Ez a parancs 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.

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

PS C:\> Get-Process notepad | Tee-Object -Variable proc | Select-Object processname,handles
ProcessName                              Handles
-----------                              -------
notepad                                  43
notepad                                  37
notepad                                  38
notepad                                  38

Ez a parancs lekéri a számítógépen futó folyamatok listáját, és elküldi az eredményt egy proc nevű változónak. Ezután az eredményül kapott objektumokat a Select-Object elemhez csövezi, amely kiválasztja a ProcessName és a Handles tulajdonságot. Vegye figyelembe, hogy a $proc változó tartalmazza a Get-Process által visszaadott alapértelmezett információkat.

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

PS C:\> Get-ChildItem -Path D: -File -System -Recurse | Tee-Object -FilePath "c:\test\AllSystemFiles.txt" -Append | Out-File c:\test\NewSystemFiles.txt

Ez a parancs a rendszerfájlok listáját két naplófájlba, egy összegző fájlba és egy aktuális fájlba menti.

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 fájlba.

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:None
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 a Tee-Objectis csövezheti.

Ha a InputObject paramétert Tee-Objecthasználatával használja, ahelyett, hogy a parancseredményeket a Tee-Objectpipázta volna, az InputObject értéket akkor is, ha az érték egy parancs eredménye, például , egyetlen objektumként lesz kezelve. Mivel InputObject nem tud egyedi tulajdonságokat visszaadni egy tömbből vagy objektumgyűjteményből, javasoljuk, hogy ha Tee-Object használatával hajt végre műveleteket azon objektumok gyűjteményén, amelyek meghatározott tulajdonságokkal rendelkeznek a meghatározott tulajdonságokban, Tee-Object kell használnia a folyamatban, ahogyan az a jelen témakör példáiban is látható.

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

Objektumokat Tee-Object.

Kimenetek

PSObject

Tee-Object visszaadja az átirányított objektumot.

Jegyzetek

  • 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 kódolást használ, amikor fájlokat ír. Emiatt előfordulhat, hogy a kimenet nem megfelelően van formázva más kódolású fájlokban. A kódolás megadásához használja a Out-File parancsmagot.