Because I spend a great part of my day creating PowerShell related content, I often need to copy command output from a PowerShell session. The quick and dirty solution is to pipe my expression to the Clip.exe command line utility.<\/p>\n
get-service | where { $_.status -eq 'running'} | clip<\/code><\/pre>\nThis works in both the console and PowerShell ISE. But there are situations where I'd like to see the result so that I know it is worth pasting into whatever I'm working on. In other words I want to send the results of the command to the pipeline and the clipboard at the same time. PowerShell can already do something similar with the Tee-Object<\/a> cmdlet. With that cmdlet you can tee output to a variable or a file. So I decided to build a wrapper around Tee-Object and add functionality to send tee output to the clipboard.<\/p>\nI created a copy of Tee-Object and started modifying. I didn't want to reverse-engineer the cmdlet. I simply wanted to add a new parameter. In some ways, my new command is like a proxy function.<\/p>\n
#requires -version 4.0\r\n\r\n\r\n<#\r\nThis is a copy of:\r\n\r\nCommandType Name ModuleName \r\n----------- ---- ---------- \r\nCmdlet Tee-Object Microsoft.PowerShell.Utility\r\n\r\nCreated: 8\/12\/2015\r\nAuthor : Jeff Hicks @JeffHicks\r\n\r\n ****************************************************************\r\n * DO NOT USE IN A PRODUCTION ENVIRONMENT UNTIL YOU HAVE TESTED *\r\n * THOROUGHLY IN A LAB ENVIRONMENT. USE AT YOUR OWN RISK. IF *\r\n * YOU DO NOT UNDERSTAND WHAT THIS SCRIPT DOES OR HOW IT WORKS, *\r\n * DO NOT USE IT OUTSIDE OF A SECURE, TEST SETTING. *\r\n ****************************************************************\r\n#>\r\n\r\n\r\nFunction Tee-MyObject {\r\n<#\r\n\r\n.SYNOPSIS\r\n\r\nSaves command output in a file, variable or Windows Clipboard and also sends it down the pipeline.\r\n\r\n\r\n.DESCRIPTION\r\n\r\nThe cmdlet redirects output, that is, it 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 is the last command in the pipeline, the command output is displayed at the prompt.\r\n\r\nThis command is a modified version of Tee-Object.\r\n.PARAMETER Clipboard\r\nCopy the output to the Windows clipboard\r\n\r\n.PARAMETER Append\r\nAppends the output to the specified file. Without this parameter, the new content replaces any existing content in the file without warning.\r\n\r\nThis parameter is introduced in Windows PowerShell 3.0.\r\n\r\n.PARAMETER FilePath\r\nSaves the object in the specified file. Wildcard characters are permitted, but must resolve to a single file.\r\n\r\n.PARAMETER InputObject\r\nSpecifies the object to be saved and displayed. Enter a variable that contains the objects or type a command or expression that gets the objects. You can also pipe an object to .\r\n\r\nWhen you use the InputObject parameter with , instead of piping command results to , the InputObject value\u2014even if the value is a collection that is the result of a command, such as \u2013InputObject (Get-Process)\u2014is treated as a single object. Because InputObject cannot return individual properties from an array or collection of objects, it is recommended that if you use to perform operations on a collection of objects for those objects that have specific values in defined properties, you use in the pipeline, as shown in the examples in this topic.\r\n\r\n.PARAMETER Variable\r\nSaves the object in the specified variable. Enter a variable name without the preceding dollar sign ($).\r\n\r\n.PARAMETER LiteralPath\r\nSaves the object in the specified file. Unlike FilePath, the value of the LiteralPath parameter is used exactly as it is typed. No characters are interpreted as wildcards. If the path includes escape characters, enclose it in single quotation marks. Single quotation marks tell Windows PowerShell not to interpret any characters as escape sequences.\r\n\r\n\r\n.EXAMPLE\r\nPS C:\\> Get-Eventlog -list | Tee-MyObject -clipboard\r\n\r\n\r\n Max(K) Retain OverflowAction Entries Log \r\n ------ ------ -------------- ------- --- \r\n 20,480 0 OverwriteAsNeeded 30,245 Application\r\n 20,480 0 OverwriteAsNeeded 0 HardwareEvents \r\n 512 7 OverwriteOlder 0 Internet Explorer\r\n 20,480 0 OverwriteAsNeeded 0 Key Management Service\r\n 128 0 OverwriteAsNeeded 1,590 OAlerts \r\n 32,768 0 OverwriteAsNeeded 49,749 Security \r\n 20,480 0 OverwriteAsNeeded 33,273 System \r\n 15,360 0 OverwriteAsNeeded 11,442 Windows PowerShell\r\n\r\nDisplay eventlog information and also copy it to the Windows clipboard.\r\n\r\n.EXAMPLE\r\n\r\nPS C:\\> get-process | Tee-MyObject -filepath C:\\Test1\\testfile2.txt\r\n\r\nHandles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName\r\n------- ------ ----- ----- ----- ------ -- -----------\r\n83 4 2300 4520 39 0.30 4032 00THotkey\r\n272 6 1400 3944 34 0.06 3088 alg\r\n81 3 804 3284 21 2.45 148 ApntEx\r\n81 4 2008 5808 38 0.75 3684 Apoint\r\n...\r\nThis 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 processes are also displayed in the console.\r\n\r\n.EXAMPLE\r\n\r\nPS C:\\> get-process notepad | Tee-MyObject -variable proc | select-object processname,handles\r\n\r\nProcessName Handles\r\n----------- -------\r\nnotepad 43\r\nnotepad 37\r\nnotepad 38\r\nnotepad 38\r\nThis 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.\r\n\r\n.EXAMPLE\r\n\r\nPS C:\\>get-childitem \u2013path D: \u2013file \u2013system \u2013recurse | Tee-MyObject \u2013file c:\\test\\AllSystemFiles.txt \u2013append | out-file c:\\test\\NewSystemFiles.txt\r\nThis command saves a list of system files in a two log files, a cumulative file and a current file.\r\nThe command uses the Get-ChildItem cmdlet to do a recursive search for system files on the D: drive. A pipeline operator (|) sends the list to , which appends the list to the AllSystemFiles.txt file and passes the list down the pipeline to the Out-File cmdlet, which saves the list in the NewSystemFiles.txt file.\r\n\r\n.NOTES\r\n\r\nYou 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.\r\n 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.\r\n\r\nLearn more about PowerShell:\r\nEssential PowerShell Learning Resources<\/a><\/blockquote>