Tee-Object

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee wordt de opdrachtuitvoer opgeslagen in een bestand of variabele en wordt deze ook naar beneden verzonden naar de pijplijn.

Syntaxis

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

De Tee-Object cmdlet leidt uitvoer, dat wil gezegd, verzendt de uitvoer van een opdracht in twee richtingen (zoals de letter T). De uitvoer wordt opgeslagen in een bestand of variabele en verzendt deze ook naar beneden in de pijplijn. Als Tee-Object de laatste opdracht in de pijplijn is, wordt de opdrachtuitvoer weergegeven bij de prompt.

Voorbeelden

Voorbeeld 1: Uitvoerprocessen naar een bestand en naar de console

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

Voorbeeld 2: Uitvoerprocessen naar een variabele en Select-Object

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.

Voorbeeld 3: Systeembestanden uitvoeren naar twee logboekbestanden

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.

Voorbeeld 4: Uitvoer naar console afdrukken en gebruiken in de pijplijn

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.

Parameters

-Append

Geeft aan dat de cmdlet de uitvoer toevoegt aan het opgegeven bestand. Zonder deze parameter vervangt de nieuwe inhoud alle bestaande inhoud in het bestand zonder waarschuwing.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:	SwitchParameter
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Encoding

Hiermee geeft u het type codering voor het doelbestand. De standaardwaarde is utf8NoBOM.

De acceptabele waarden voor deze parameter zijn als volgt:

ascii: maakt gebruik van de codering voor de ASCII-tekenset (7-bits).
ansi: gebruikt de codering voor de ANSI-codepagina van de huidige cultuur. Deze optie is toegevoegd in PowerShell 7.4.
bigendianunicode: Codeert in UTF-16-indeling met behulp van de bytevolgorde big-endian.
oem: maakt gebruik van de standaardcodering voor MS-DOS- en consoleprogramma's.
unicode: Codeert in UTF-16-indeling met de bytevolgorde little-endian.
utf7: Codeert in UTF-7-indeling.
utf8: Codeert in UTF-8-indeling.
utf8BOM: Codeert in UTF-8-indeling met Byte Order Mark (BOM)
utf8NoBOM: Codeert in UTF-8-indeling zonder Byte Order Mark (BOM)
utf32: Codeert in UTF-32-indeling.

Vanaf PowerShell 6.2 staat de parameter Coderings- ook numerieke id's toe van geregistreerde codepagina's (zoals -Encoding 1251) of tekenreeksnamen van geregistreerde codepagina's (zoals -Encoding "windows-1251"). Zie de .NET-documentatie voor Encoding.CodePagevoor meer informatie.

Vanaf PowerShell 7.4 kunt u de Ansi waarde voor de -coderingsparameter gebruiken om de numerieke id voor de ANSI-codepagina van de huidige cultuur door te geven zonder deze handmatig op te geven.

Deze parameter is geïntroduceerd in PowerShell 7.2.

Notitie

UTF-7* wordt niet meer aanbevolen om te gebruiken. Vanaf PowerShell 7.1 wordt een waarschuwing geschreven als u utf7 opgeeft voor de parameter codering.

Type:	Encoding
Geaccepteerde waarden:	ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	1
Default value:	UTF8NoBOM
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-FilePath

Hiermee geeft u een bestand op dat het object door deze cmdlet wordt opgeslagen in jokertekens, maar moet worden omgezet in één bestand.

Wanneer u in PowerShell 7 de FilePath- opgeeft als \\.\CON in Windows of /dev/tty op niet-Windows-systemen, wordt de InputObject- afgedrukt in de console. Deze bestandspaden komen overeen met het consoleapparaat van de huidige terminal op het systeem, zodat u de InputObject- kunt afdrukken en met één opdracht naar de uitvoerstroom kunt verzenden.

Type:	String
Aliassen:	Path
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-InputObject

Hiermee geeft u het object op dat moet worden opgeslagen en weergegeven. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald. U kunt ook een object doorsluisen naar Tee-Object.

Wanneer u de parameter InputObject gebruikt met Tee-Object, Tee-Objectwordt de InputObject waarde beschouwd als één object, zelfs als de waarde een verzameling is.

Type:	PSObject
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-LiteralPath

Hiermee geeft u een bestand op waarnaar het object door deze cmdlet wordt opgeslagen. In tegenstelling tot FilePath, wordt de waarde van de parameter LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:	String
Aliassen:	PSPath, LP
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Variable

Hiermee geeft u een variabele op waarnaar het object wordt opgeslagen door de cmdlet. Voer een variabelenaam in zonder het voorgaande dollarteken ($).

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

PSObject

U kunt objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden