{"id":17721,"date":"2010-07-18T00:01:00","date_gmt":"2010-07-18T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2010\/07\/18\/hey-scripting-guy-weekend-scripter-how-can-i-create-display-and-then-delete-a-temporary-text-file\/"},"modified":"2010-07-18T00:01:00","modified_gmt":"2010-07-18T00:01:00","slug":"hey-scripting-guy-weekend-scripter-how-can-i-create-display-and-then-delete-a-temporary-text-file","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-weekend-scripter-how-can-i-create-display-and-then-delete-a-temporary-text-file\/","title":{"rendered":"Hey, Scripting Guy! Weekend Scripter: How Can I Create, Display, and Then Delete a Temporary Text File?"},"content":{"rendered":"

 \nMicrosoft Scripting Guy Ed Wilson here, it’s a good thing I enjoy getting up early on weekends. To me, because I get up early during the week, it makes sense to get up early on the weekend and get busy doing things that I want to do. One of the things I like to do early on weekend mornings is hang out on Facebook<\/a> and Twitter<\/a> for a little while as I wait for my English Breakfast tea<\/a> to steep, and as I wait for the Irish steel cut oats<\/a> to cook.\nOne of the things I wanted to look at this morning arose because of a presentation I made to the Philadelphia Area Exchange Users Group this week. I showed them a script I had written several years ago that creates a temporary text file, writes process information to the temporary text file, displays the information in Notepad, and then deletes the temporary text file when you close Notepad. It is a pretty cool script, and I posted it<\/a> to Scripting Guys Script Repository that night after the user group meeting. I thought the script would be more useful if I modified it to accept piped input. I got a little carried away, and turned it into an advanced function. The Out-TempFile.ps1 script contains the Out-TempFile<\/strong> advanced function. I added help tags so the function interacts with the Get-Help<\/strong> function. For more information about adding help to a Windows PowerShell<\/a> script, refer to the articles from Help week<\/a>.\nOut-TempFile.ps1<\/strong>\n<\/strong><\/p>\n

Function<\/span> <\/span>Out-TempFile<\/span>
<\/span>{<\/span>
<\/span><<\/span>#<\/span>
<\/span>.Synopsis<\/span>
<\/span>Displays<\/span> <\/span>pipelined<\/span> <\/span>text<\/span> <\/span>in<\/span> <\/span>a<\/span> <\/span>temporary<\/span> <\/span>file.<\/span> <\/span>The<\/span> <\/span>temp<\/span> <\/span>file<\/span>
<\/span>is<\/span> <\/span>displayed<\/span> <\/span>in<\/span> <\/span>Notepad.<\/span> <\/span>When<\/span> <\/span>Notepad<\/span> <\/span>is<\/span> <\/span>closed,<\/span> <\/span>the<\/span> <\/span>temp<\/span>
<\/span>file<\/span> <\/span>is<\/span> <\/span>deleted.<\/span> <\/span>If<\/span> <\/span>you<\/span> <\/span>wish<\/span> <\/span>to<\/span> <\/span>save<\/span> <\/span>the<\/span> <\/span>information<\/span> <\/span>that<\/span> 
<\/span>is<\/span> <\/span>displayed<\/span> <\/span>in<\/span> <\/span>Notepad,<\/span> <\/span>use<\/span> <\/span>the<\/span> <\/span>saveas<\/span> <\/span>feature<\/span> <\/span>from<\/span> <\/span>Notepad.<\/span>
<\/span>.Example<\/span>
“string” <\/span>|<\/span> <\/span>Out-TempFile<\/span>
<\/span>Displays<\/span> <\/span>the<\/span> <\/span>word<\/span> <\/span>string<\/span> <\/span>in<\/span> <\/span>a<\/span> <\/span>temporary<\/span> <\/span>file<\/span> <\/span>via<\/span> <\/span>Notepad.<\/span>
<\/span>When<\/span> <\/span>Notepad<\/span> <\/span>is<\/span> <\/span>closed,<\/span> <\/span>the<\/span> <\/span>temporary<\/span> <\/span>file<\/span> <\/span>that<\/span> <\/span>contained<\/span>
<\/span>the<\/span> <\/span>word<\/span> “string” <\/span>is<\/span> <\/span>deleted.<\/span>
<\/span>.Example<\/span>
<\/span>Get-Process<\/span> <\/span>|<\/span> <\/span>Out-TempFile<\/span>
<\/span>Displays<\/span> <\/span>process<\/span> <\/span>info<\/span> <\/span>in<\/span> <\/span>a<\/span> <\/span>temporary<\/span> <\/span>file<\/span> <\/span>via<\/span> <\/span>Notepad.<\/span>
<\/span>When<\/span> <\/span>Notepad<\/span> <\/span>is<\/span> <\/span>closed,<\/span> <\/span>the<\/span> <\/span>temporary<\/span> <\/span>file<\/span> <\/span>that<\/span> <\/span>contained<\/span>
<\/span>the<\/span> <\/span>process<\/span> <\/span>information<\/span> <\/span>is<\/span> <\/span>deleted.<\/span>
<\/span>.Example<\/span>
<\/span>Out-TempFile<\/span> <\/span>-in<\/span> <\/span>(<\/span>get-service<\/span>)<\/span>
<\/span>Displays<\/span> <\/span>service<\/span> <\/span>info<\/span> <\/span>in<\/span> <\/span>a<\/span> <\/span>temporary<\/span> <\/span>file<\/span> <\/span>via<\/span> <\/span>Notepad.<\/span>
<\/span>When<\/span> <\/span>Notepad<\/span> <\/span>is<\/span> <\/span>closed,<\/span> <\/span>the<\/span> <\/span>temporary<\/span> <\/span>file<\/span> <\/span>that<\/span> <\/span>contained<\/span>
<\/span>the<\/span> <\/span>process<\/span> <\/span>information<\/span> <\/span>is<\/span> <\/span>deleted.<\/span>
<\/span>.Parameter<\/span> <\/span>in<\/span>
<\/span>Data<\/span> <\/span>to<\/span> <\/span>display<\/span> <\/span>in<\/span> <\/span>a<\/span> <\/span>temporary<\/span> <\/span>file<\/span>
<\/span>.Inputs<\/span>
<\/span>[psobject]<\/span>
<\/span>.Outputs<\/span>
<\/span>[psobject]<\/span>
<\/span>.Notes<\/span>
<\/span>NAME:<\/span> <\/span>Out-TempFile<\/span>
<\/span>AUTHOR:<\/span> <\/span>Ed<\/span> <\/span>Wilson<\/span>
<\/span>AUTHOR<\/span> <\/span>BOOK:<\/span> <\/span>Windows<\/span> <\/span>PowerShell<\/span> <\/span>2<\/span>.<\/span>0<\/span> <\/span>Best<\/span> <\/span>Practices,<\/span> <\/span>Microsoft<\/span> <\/span>Press<\/span> <\/span>2010<\/span>
<\/span>LASTEDIT:<\/span> <\/span>7<\/span>\/<\/span>15<\/span>\/<\/span>2010<\/span>
<\/span>WES-07-18-2010<\/span>
<\/span>KEYWORDS:<\/span> <\/span>WeekEnd<\/span> <\/span>Scripter,<\/span> <\/span>Function,<\/span> <\/span>Getting<\/span> <\/span>Started<\/span>
<\/span>.Link<\/span>
<\/span>Http:\/\/www.ScriptingGuys.com<\/span>
<\/span>Http:\/\/www.bit.ly\/HSGBlog<\/span>
<\/span>#<\/span>><\/span>
<\/span>#<\/span>Requires<\/span> <\/span>-Version<\/span> <\/span>2<\/span>.<\/span>0<\/span>
<\/span>[CmdletBinding()]<\/span>
<\/span>param(<\/span>
<\/span>[Parameter(Mandatory<\/span> <\/span>=<\/span> <\/span>$True<\/span>,valueFromPipeline<\/span>=<\/span>$true<\/span>,Position<\/span>=<\/span>0<\/span>)]<\/span>
<\/span>[psobject]<\/span>
<\/span>$in<\/span>
<\/span>)<\/span> <\/span>#<\/span>end<\/span> <\/span>param<\/span>
<\/span>BEGIN<\/span>
<\/span>{<\/span> <\/span>$tempFile<\/span> <\/span>=<\/span> <\/span>[io.path]::GetTempFileName()<\/span> <\/span>}<\/span>
<\/span>PROCESS<\/span>
<\/span>{<\/span> <\/span>out-file<\/span> <\/span>-filePath<\/span> <\/span>$tempFile<\/span> <\/span>-InputObject<\/span> <\/span>$in<\/span> <\/span>-Append<\/span> <\/span>`<\/span>
<\/span>-Width<\/span> <\/span>300<\/span> <\/span>-Encoding<\/span> <\/span>unicode<\/span> <\/span>}<\/span>
<\/span>END<\/span>
<\/span>{<\/span> <\/span>Notepad<\/span> <\/span>$tempFile<\/span> <\/span>|<\/span> <\/span>Out-Null<\/span>
<\/span>Remove-Item<\/span> <\/span>$tempFile<\/span> <\/span>}<\/span>
<\/span>}<\/span> <\/span>#<\/span> <\/span>end<\/span> <\/span>function<\/span> <\/span>out-tempfile<\/span> <\/div>\n

After creating the help tags, I use the CmdletBinding<\/strong> attribute. This causes the function to bind parameters in the same way that a Windows PowerShell cmdlet binds the parameters. I then create the input parameter. To enable piped input to the function, it is necessary to specify the valueFromPipeLine<\/strong> parameter. The other parameters make the –in<\/strong> parameter mandatory and set it in the first position. The [psobject]<\/strong> type constraint makes the input an object, and not merely a string. The parameter<\/strong> section and CmdletBinding<\/strong> attribute are shown here:\n <\/p>\n

[CmdletBinding()]<\/span> <\/p>\n

<\/span>param(<\/span> <\/p>\n

<\/span>[Parameter(Mandatory<\/span> <\/span>=<\/span> <\/span>$True<\/span>,valueFromPipeline<\/span>=<\/span>$true<\/span>,Position<\/span>=<\/span>0<\/span>)]<\/span> <\/p>\n

<\/span>[psobject]<\/span> <\/p>\n

<\/span>$in<\/span> <\/p>\n

<\/span>)<\/span> <\/span>#<\/span>end<\/span> <\/span>param<\/span> <\/div>\n

The first thing I want to do when the function is called is create the temporary file name. To do this, I use the GetTempFileName<\/strong> static method from the .NET Framework io.path <\/strong>class. I really do not need to know the temporary file name because I store it in the $tempFile<\/strong> variable. This variable will be used when creating and deleting the file. The Begin<\/strong> section of the advanced function defines actions that are performed once. This is shown here:\n <\/p>\n

BEGIN<\/span> <\/p>\n

<\/span>{<\/span> <\/span>$tempFile<\/span> <\/span>=<\/span> <\/span>[io.path]::GetTempFileName()<\/span> <\/span>}<\/span> <\/div>\n

The Process<\/strong> section is run for each<\/a> item that comes through the pipeline<\/a>. The Out-File<\/strong> cmdlet is used to create the temporary text file and to append data to the file. I set the width to 300 characters and the encoding to Unicode. The Process block is shown here:\n <\/p>\n

PROCESS<\/span> <\/p>\n

<\/span>{<\/span> <\/span>out-file<\/span> <\/span>-filePath<\/span> <\/span>$tempFile<\/span> <\/span>-InputObject<\/span> <\/span>$in<\/span> <\/span>-Append<\/span> <\/span>`<\/span> <\/p>\n

<\/span>-Width<\/span> <\/span>300<\/span> <\/span>-Encoding<\/span> <\/span>unicode<\/span> <\/span>}<\/span> <\/div>\n

There are two things that remain to be accomplished. The first is to display the temporary file in Notepad; this is very convenient because the user’s temporary folder is cumbersome to navigate to. In addition, many programs have a nasty habit of leaving their temp files in the temp folder, and therefore spotting my specific temporary file gets to be difficult. It is much faster to have Notepad display it for me. After I am finished reading the file, I like to remove the temporary file. To do this, I pipe the Notepad command to the Out-Null cmdlet. This pauses execution of the script. When Notepad is closed, execution resumes and the Remove-Item<\/strong> cmdlet is used to delete the temporary file. The end section of the Out-TempFile<\/strong> function is shown here:\n <\/p>\n

END<\/span> <\/p>\n

<\/span>{<\/span> <\/span>Notepad<\/span> <\/span>$tempFile<\/span> <\/span>|<\/span> <\/span>Out-Null<\/span> <\/p>\n

<\/span>Remove-Item<\/span> <\/span>$tempFile<\/span> <\/span>}<\/span> <\/div>\n

When the function is called, after you have run the script to load the function (in either the ISE or by dot-sourcing the script into the Windows PowerShell console), the function pauses execution while the temporary text file is displayed, as shown in the following image.\n\"Image\nJoin us tomorrow when we will begin looking at the Active Directory<\/a> cmdlets that ship with Windows Server 2008 R2.\nWe would love for you to follow us on Twitter<\/a> or Facebook<\/a>. If you have any questions, send email to us at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum.<\/a> See you tomorrow. Until then, peace.\n \n<\/strong><\/p>\n

Ed Wilson and Craig Liebendorfer, Scripting Guys<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"

  Microsoft Scripting Guy Ed Wilson here, it’s a good thing I enjoy getting up early on weekends. To me, because I get up early during the week, it makes sense to get up early on the weekend and get busy doing things that I want to do. One of the things I like to […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[3,61,45],"class_list":["post-17721","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-weekend-scripter","tag-windows-powershell"],"acf":[],"blog_post_summary":"

  Microsoft Scripting Guy Ed Wilson here, it’s a good thing I enjoy getting up early on weekends. To me, because I get up early during the week, it makes sense to get up early on the weekend and get busy doing things that I want to do. One of the things I like to […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/17721","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=17721"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/17721\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=17721"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=17721"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=17721"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}