Tee-Object

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

Den Tee-Object cmdleten omdirigerar utdata, det vill: den skickar utdata från ett kommando i två riktningar (till exempel bokstaven T). Den lagrar utdata i en fil eller variabel och skickar den även nedåt i pipelinen. Om Tee-Object är det sista kommandot i pipelinen visas kommandoutdata i kommandotolken.

Exempel

Exempel 1: Utdataprocesser till en fil och till konsolen

Det här exemplet hämtar en lista över de processer som körs på datorn och skickar resultatet till en fil. Eftersom en andra sökväg inte har angetts visas även processerna i konsolen.

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

Exempel 2: Utdataprocesser till en variabel och "Select-Object"

Det här exemplet hämtar en lista över de processer som körs på datorn, sparar dem i variabeln $proc och skickar dem till Select-Object.

Get-Process notepad | Tee-Object -Variable proc | Select-Object processname,handles

ProcessName                              Handles
-----------                              -------
notepad                                  43
notepad                                  37
notepad                                  38
notepad                                  38

Cmdleten Select-Object väljer egenskaperna ProcessName och Handles. Observera att variabeln $proc innehåller standardinformationen som returneras av Get-Process.

Exempel 3: Mata ut systemfiler till två loggfiler

I det här exemplet sparas en lista över systemfiler i två loggfiler, en kumulativ fil och en aktuell fil.

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

Kommandot använder cmdleten Get-ChildItem för att göra en rekursiv sökning efter systemfiler på D:-enheten. En pipelineoperator (|) skickar listan till Tee-Object, som lägger till listan i AllSystemFiles.txt-filen och skickar listan nedåt i pipelinen till cmdleten Out-File, vilket sparar listan i NewSystemFiles.txt file.

Exempel 4: Skriv ut utdata till konsolen och använd i pipelinen

Det här exemplet hämtar filerna i en mapp, skriver ut dem till konsolen och filtrerar sedan filerna för dem som har ett definierat metadatablock för frontmaterial. Slutligen listar den namnen på de artiklar som har front matter.

$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

I exemplet anges variabeln $consoleDevice till värdet för den aktuella terminalens konsolenhet. I Windows kan du skriva till den aktuella konsolenheten genom att omdirigera dina utdata till \\.\CON-filsökvägen. På icke-Windows-system använder du /dev/tty-filsökvägen.

Sedan anges variabeln $frontMatterPattern till ett reguljärt uttryck som matchar när en sträng börjar med tre bindestreck (---) och har innehåll före ytterligare tre bindestreck. När det här mönstret matchar en artikels innehåll har artikeln ett definierat metadatablock för frontmaterial.

I exemplet används sedan Get-ChildItem för att hämta varje fil i mappen About. Tee-Object skriver ut pip-resultatet till konsolen med parametern FileName. Where-Object filtrerar filerna genom att hämta innehållet som en enda sträng med parametern Raw för Get-Content och jämföra strängen med $frontMatterPattern.

Slutligen skriver exemplet ut namnen på filerna i mappen som har ett definierat front matter-metadatablock.

Parametrar

-Append

-Encoding

-FilePath

-InputObject

-LiteralPath

-Variable

Indata

PSObject

Du kan skicka objekt till den här cmdleten.

Utdata

PSObject

Den här cmdleten returnerar det objekt som omdirigeras.

Kommentarer

PowerShell innehåller följande alias för Tee-Object:

• Windows:
  • tee

Du kan också använda cmdleten Out-File eller omdirigeringsoperatorn, som båda sparar utdata i en fil men inte skickar dem i pipelinen.

Från och med PowerShell 6 använder Tee-Object BOM-mindre UTF-8-kodning när den skriver till filer. Om du behöver en annan kodning använder du cmdleten Out-File med parametern Kodning.

Relaterade länkar

• Compare-Object
• ForEach-Object
• Group-Object
• Measure-Object
• New-Object
• Select-Object
• Sort-Object
• Where-Object
• about_Redirection