Tee-Object

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

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

Tee-Object
    -Variable <String>
    [-InputObject <PSObject>]
    [<CommonParameters>]

De Tee-Object cmdlet schrijft uitvoer in twee richtingen. De uitvoer wordt opgeslagen in een bestand of variabele en verzendt deze ook naar beneden in de pijplijn. Als Tee-Object dit de laatste opdracht in de pijplijn is, wordt de opdrachtuitvoer weergegeven in de console.

Intern gebruikt Tee-Object u de Set-Variable en Out-File opdrachten. Deze opdrachten ondersteunen de WhatIf-parameter . De Tee-Object opdracht biedt geen ondersteuning voor de WhatIf-parameter . Als u echter een script of functie verpakt Tee-Object die ondersteuning biedt voor de WhatIf-parameter , Tee-Object geeft u de status van WhatIf door aan de Set-Variable en Out-File opdrachten.

In dit voorbeeld wordt een lijst weergegeven met de processen die op de computer worden uitgevoerd en wordt het resultaat naar een bestand verzonden. Omdat er geen tweede pad is opgegeven, worden de processen ook weergegeven in de console.

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

In dit voorbeeld wordt een lijst weergegeven met de processen die op de computer worden uitgevoerd, worden deze opgeslagen in de $proc variabele en worden ze door leidingen naar Select-Object.

Get-Process notepad | Tee-Object -Variable proc | Select-Object ProcessName, Handles

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

De cmdlet Select-Object selecteert de ProcessName- en verwerkt eigenschappen. Houd er rekening mee dat de variabele $proc de standaardgegevens bevat die worden geretourneerd door Get-Process.

In dit voorbeeld wordt een lijst met systeembestanden opgeslagen in twee logboekbestanden, een cumulatief bestand en een huidig bestand.

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

De opdracht maakt gebruik van de Get-ChildItem cmdlet om een recursieve zoekopdracht uit te voeren naar systeembestanden op het station D: . Een pijplijnoperator (|) verzendt de lijst naar Tee-Object, waarmee de lijst wordt toegevoegd aan het AllSystemFiles.txt bestand en de lijst wordt doorgegeven aan de Out-File-cmdlet, waarmee de lijst in de NewSystemFiles.txt filewordt opgeslagen.

In dit voorbeeld worden de bestanden in een map opgehaald, afgedrukt naar de console en worden de bestanden gefilterd op bestanden met een gedefinieerd metagegevensblok voor front-matter. Ten slotte worden de namen vermeld van de artikelen met 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

In het voorbeeld wordt de variabele $consoleDevice ingesteld op de waarde van het consoleapparaat van de huidige terminal. In Windows kunt u naar het huidige consoleapparaat schrijven door de uitvoer om te leiden naar het \\.\CON bestandspad. Op niet-Windows-systemen gebruikt u het /dev/tty bestandspad.

Vervolgens wordt de variabele $frontMatterPattern ingesteld op een reguliere expressie die overeenkomt wanneer een tekenreeks begint met drie streepjes (---) en inhoud heeft vóór nog eens drie streepjes. Wanneer dit patroon overeenkomt met de inhoud van een artikel, heeft het artikel een gedefinieerd metagegevensblok voor front-matter.

Vervolgens wordt in het voorbeeld Get-ChildItem gebruikt om elk bestand in de map About op te halen. Tee-Object de gesluisde resultaten naar de console afdrukken met behulp van de parameter FileName. Where-Object de bestanden filtert door hun inhoud als één tekenreeks op te halen met de parameter Raw van Get-Content en die tekenreeks te vergelijken met $frontMatterPattern.

Ten slotte worden in het voorbeeld de namen van de bestanden in de map afgedrukt met een gedefinieerd metagegevensblok voor front-matter.

De Tee-Object opdracht biedt geen ondersteuning voor de WhatIf-parameter . Als u echter een script of functie verpakt Tee-Object die ondersteuning biedt voor de WhatIf-parameter , Tee-Object geeft u de status van WhatIf door aan de Set-Variable en Out-File opdrachten die intern worden gebruikt.

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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt objecten doorsluisen naar deze cmdlet.

Met deze cmdlet wordt het object geretourneerd dat wordt omgeleid.

PowerShell bevat de volgende aliassen voor Tee-Object:

• Windows:
  • tee

U kunt ook de Out-File-cmdlet of de omleidingsoperator gebruiken, die beide de uitvoer in een bestand opslaan, maar deze niet naar de pijplijn verzenden.

Vanaf PowerShell 6 gebruikt Tee-Object bomloze UTF-8-codering wanneer deze naar bestanden schrijft. Als u een andere codering nodig hebt, gebruikt u de cmdlet Out-File met de parameter Codering.