Saves command output in a file or variable, and displays it in the console. (Tee-Object)
NAMETee-ObjectSYNOPSISSaves command output in a file or variable, and displays it in the console.SYNTAXTee-Object [-FilePath] <string> [-InputObject <psobject>] [<CommonParameters>] Tee-Object -Variable <string> [-InputObject <psobject>] [<CommonParameters>]DESCRIPTIONThe Tee-Object cmdlet sends the output of a command in two directions (like the letter "T"). It stores the output in a file or variable and also sends it down the pipeline. If Tee-Object is the last command in the pipeline, the command output is displayed in the console.PARAMETERS-FilePath <string> Specifies the file where the cmdlet stores the object. Accepts wildcards that resolve to a single file. Required? true Position? 1 Default value Accept pipeline input? false Accept wildcard characters? false -InputObject <psobject> Specifies the object input to the cmdlet. Enter a variable that contains the objects or type a command or expression that gets the objects. Required? false Position? named Default value Accept pipeline input? true (ByValue) Accept wildcard characters? false -Variable <string> Assigns a reference to the input objects to the specified variable. Required? true Position? named Default value Accept pipeline input? false Accept wildcard characters? false <CommonParameters> This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, type, "get-help about_commonparameters".INPUTSSystem.Management.Automation.PSObject You can pipe objects to be redirected to Tee-Object.OUTPUTSSystem.Management.Automation.PSObject Tee-Object returns the object that it redirected.NOTESYou can also use the Out-File cmdlet or the redirection operator, both of which save the output in a file but do not send it down the pipeline. Tee-Object uses Unicode encoding when it writes to files. As a result, the output might not be formatted properly in files with a different encoding. To specify the encoding, use the Out-File cmdlet.Examples
EXAMPLE 1C:\PS>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 ...Description----------- This command gets a list of the processes running on the computer and sends the result to a file. Because a second path is not specified, the result will be displayed in the console.EXAMPLE 2C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles ProcessName Handles ----------- ------- notepad 43 notepad 37 notepad 38 notepad 38Description----------- This command gets a list of the processes running on the computer and sends the result to a variable named "proc". It then pipes the resulting objects along to Select-Object, which selects the ProcessName and Handles property. Note that the $proc variable includes the default information returned by Get-Process. RELATED LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113417 about_Redirection Select-Object C:\Windows>powershell get-help Measure-Command -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
