powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Tee-Object



NAME
Tee-Object

SYNOPSIS
Saves command output in a file or variable, and displays it in the console.

SYNTAX
Tee-Object [-FilePath] [-InputObject ] []

Tee-Object -Variable [-InputObject ] []


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