![]() NAME Tee-Object SYNOPSIS Saves command output in a file or variable, and displays it in the console. SYNTAX Tee-Object [-FilePath] Tee-Object -Variable DESCRIPTION The Tee-Object cmdlet sends the output of a command in two directions (like the letter "T"). It stores the output i n a file or variable and also sends it down the pipeline. If Tee-Object is the last command in the pipeline, the co mmand output is displayed in the console. PARAMETERS -FilePath 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 Specifies the object input to the cmdlet. Enter a variable that contains the objects or type a command or expre ssion that gets the objects. Required? false Position? named Default value Accept pipeline input? true (ByValue) Accept wildcard characters? false -Variable 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 This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, type, "get-help about_commonparameters". INPUTS System.Management.Automation.PSObject You can pipe objects to be redirected to Tee-Object. OUTPUTS System.Management.Automation.PSObject Tee-Object returns the object that it redirected. NOTES You can also use the Out-File cmdlet or the redirection operator, both of which save the output in a file but d o 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 proper ly in files with a different encoding. To specify the encoding, use the Out-File cmdlet. -------------------------- EXAMPLE 1 -------------------------- C:\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 2 -------------------------- C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles ProcessName Handles ----------- ------- notepad 43 notepad 37 notepad 38 notepad 38 Description ----------- 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. Not e 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 |