ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2009 Microsoft Corporation.

C:\Windows-7>Powershell get-help Tee-Object -full

# NAME
Tee-Object

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

# SYNTAX
Tee-Object [-FilePath] <string> [-InputObject <psobject>] [<CommonParameters>]

Tee-Object -Variable <string> [-InputObject <psobject>] [<CommonParameters>]

# DESCRIPTION
The 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".

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

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