{"id":1228,"date":"2011-08-05T15:06:10","date_gmt":"2011-08-05T13:06:10","guid":{"rendered":"http:\/\/www.itidea.nl\/?p=1228"},"modified":"2015-09-08T20:39:33","modified_gmt":"2015-09-08T18:39:33","slug":"powershell-choose-between-colored-host-text-or-write-to-an-output-file-not-anymore","status":"publish","type":"post","link":"https:\/\/www.itidea.nl\/index.php\/powershell-choose-between-colored-host-text-or-write-to-an-output-file-not-anymore\/","title":{"rendered":"PowerShell – Choose between colored host text or write to an output file? Not anymore!"},"content":{"rendered":"

In PowerShell multiple Write statements are available. The two statements I want to address are Write-Host and Write-Output.\u00a0<\/p>\n

What do these two do?
\nWrite-Host<\/em>: Writes customized output to a host
\nWrite-Output<\/em>: Sends the specified objects to the next command in the pipeline. If the command is the last command in the pipeline, the objects are displayed in the console\u00a0<\/p>\n

An example of Write-Host<\/p>\n

\r\nWrite-Host "Write-Host statement..."\r\n<\/pre>\n
The result displayed in the host\u00a0<\/p>\n
\u00a0\"\"<\/a><\/p>\n
An example of Write-Output<\/p>\n
\r\nWrite-Output "Write-Output statement..."\r\n<\/pre>\n
The result displayed in the host<\/p>\n
\"\"<\/a>\u00a0<\/p>\n
At this point there is no difference in the result of these two statements.\u00a0<\/p>\n
Write-Host with ForegroundColor\u00a0<\/h3>\n
A nice parameter of Write-Host is -ForegroundColor. Using this parameter with a color, the text displayed in the host has the color specified. I find this very useful to quickly see if a script has\u00a0succeeded or failed. I always display the success message in green, the failed message in red.\u00a0\u00a0\u00a0<\/p>\n
To show this the existence of a SPList will be checked. If it doesn\u00b4t exist, it will be created using the following statement:\u00a0\u00a0\u00a0<\/p>\n
\r\n$sampleListName = "PS List"\r\n$siteUrl=http:\/\/sp2010dev\r\n$site = Get-SPSite $siteUrl\r\n$web = $site.RootWeb<\/pre>\r\n\r\nfunction CreateList($listName){\r\n  $web.Lists.Add($listName, "Description for list", [Microsoft.SharePoint.SPListTemplateType]::GenericList)\r\n}\r\n\r\nfunction CheckIfListExists(){\r\n$currentList = $web.Lists.TryGetList($sampleListName)\r\n  if($currentList -ne $null){\r\n    Write-Host "List exists" -ForegroundColor Green\r\n  }\r\n  else{\r\n    Write-Host "List doesn't exist, creating now..." -ForegroundColor Red\r\n    CreateList $sampleListName\r\n    Write-Host "Check if list exist..."\r\n    CheckIfListExists\r\n  }\r\n}\r\n\r\nWrite-Host "Calling CheckIfListExists ..."\r\nCheckIfListExists\r\n<\/pre>\n
If the list exists a message with green colored text will appear: ‘List exists’, else a message with red colored text will appear: ‘List doesn’t exist, creating now…’, followed by the actual\u00a0creation of the list. After this the existence of the list is check again. As you can see if the list creation fails the code will be stuck in an infinite loop, so don\u00b4t use this as production code…\u00a0\u00a0\u00a0<\/p>\n
Outcome when the list doesn\u00b4t exist and is created:<\/p>\n
\"\"<\/a><\/p>\n
Outcome when the list already exists:<picture PSWrite02><\/p>\n
\"\"<\/a><\/p>\n
Write-Output with output to file\u00a0\u00a0\u00a0<\/h3>\n
A nice option of Write-Output is the possibility to write the output to a file on the filesystem.\u00a0\u00a0\u00a0<\/p>\n
\r\n$file = "C:\\_Tools\\OutputFile.txt"\r\nWrite-Output "Write-Output statement..."\r\nWrite-Output "Write-Output statement..." | Out-File $file\r\n<\/pre>\n
The first Write-Output statement writes the output to the host, the second to the file (but not to the host).\u00a0\u00a0\u00a0<\/p>\n
Best of both worlds?\u00a0\u00a0\u00a0<\/h3>\n
Ofcourse Write-Host as well as Write-Output has a lot more options to use, but I want to point out something here.
\nWrite-Host can write colored messages to the host, but it can’t write output to a file.
\nWrite-Output can’t write colored messages to the host, but it can write output to a file.\u00a0\u00a0\u00a0<\/p>\n
What if I want to:\u00a0\u00a0\u00a0<\/p>\n
write colored messages to the host if I decide to output to the host AND
\nwrite messages to a file just by using ‘| Out-File $file’<\/p>\n
With the current possibilities of both operations I have to choose between:
\n1. colored messages (and nothing written to the output file) or put the output to a file and host, but no colored messages displayed in the host\u00a0
\n2. write double statements; Write-Host with -ForeGroundColor to write the colored output to the host and Write-Output to write the output to a file when using ‘| Out-File $file’.\u00a0\u00a0\u00a0<\/p>\n
Let me clarify the second option with an example.<\/p>\n
\r\nWrite-Output "Write-Output statement..." | Out-File $file\r\nWrite-Host "Write-Host statement..." -ForegroundColor Blue\r\n<\/pre>\n
Write-Output writes the message to the file specified in $file and is not written to the host.
\nWrite-Host writes the message to the host in the color blue.
\nJust as expected and just want I wanted. But I have to write the messages twice.<\/p>\n
Another option:\u00a0\u00a0\u00a0<\/p>\n
\r\nWrite-Output "Write-Output statement..."\r\nWrite-Host "Write-Host statement..." -ForegroundColor Blue\r\n<\/pre>\n
The code above is saved in a file and called by:\u00a0\u00a0\u00a0<\/p>\n
\r\n\r\nPS C:\\_Tools> .\\PSScriptFile.ps1\r\n\r\n<\/pre>\n
Result: messages appear twice in the host.<\/p>\n
\"\"<\/a><\/p>\n
Output it to a file:\u00a0\u00a0\u00a0<\/p>\n
\r\n\r\nPS C:\\_Tools> .\\PSScriptFile.ps1 | Out-File $file\r\n\r\n<\/pre>\n
Result: No message in the host, but a message in the file!
\nStill, the messages have to be written twice in the file: Write-Host and Write-Output…
\nDo I really have to write all the messages twice to show them colored in the host and write them to an output file?
\nActually, there is no possibility to make Write-Host write to an output file.
\nBut the host itself can be accessed to change its text color (and more) and use Write-Output to write to the host (in color!) and to an output file.<\/p>\n
The host itself can be accessed by $Host.\u00a0\u00a0\u00a0<\/p>\n
\r\n\r\n$Host.Name\r\n\r\n<\/pre>\n
When using PowerGUI Script Editor the results of the above statement is: PowerGUIScriptEditorHost
\nExecuting the same statement in the console the result is: ConsoleHost<\/p>\n
That’s awesome, $Host knows who he is! \ud83d\ude42<\/p>\n
Let’s try to get the text color of the host:<\/p>\n
\r\n\r\n$currentColor = $Host.UI.RawUI.ForegroundColor\r\n\r\n<\/pre>\n
PowerGUI Script Editor:<\/p>\n
\"\"<\/a><\/p>\n
Console:<\/p>\n
\"\"<\/a><\/p>\n
So what about changing the text color of the host?\u00a0\u00a0\u00a0<\/p>\n
\r\n\r\nfunction WriteCustomOutput($message, [System.ConsoleColor]$foregroundcolor)\r\n{\r\n  currentColor = $Host.UI.RawUI.ForegroundColor\r\n  $Host.UI.RawUI.ForegroundColor = $foregroundcolor\r\n  if ($message)\r\n  {\r\n    Write-Output $message\r\n  }\r\n  $Host.UI.RawUI.ForegroundColor = $currentColor\r\n}\r\n\r\nWriteCustomOutput -message "WriteColoredOutput statement..." -foregroundcolor Green\r\n\r\n<\/pre>\n
And the result in the host:<\/p>\n
\"\"<\/a>\u00a0\u00a0\u00a0<\/p>\n
Let’s save the code to a file and call the file from the console:<\/p>\n
\"\"<\/a>\u00a0<\/p>\n
And will the output be written to an output file when using the statement:<\/p>\n
\r\n\r\n.\\PSWriteCustomOutput.ps1 | Out-File OutputFile.txt\r\n\r\n<\/pre>\n
Yes it is written to the file:<\/p>\n
\"\"<\/a>\u00a0\u00a0\u00a0<\/p>\n
Summary<\/h3>\n
Write-Host and Write-Output are very simple and useful statements. Sometimes the best of both is wished for.
\nWith some creativity you can have both. Use WriteCustomOutput!<\/p>\n","protected":false},"excerpt":{"rendered":"
In PowerShell multiple Write statements are available. The two statements I want to address are Write-Host and Write-Output.\u00a0 What do these two do? Write-Host: Writes customized output to a host Write-Output: Sends the specified objects to the next command in … Read More »<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[22,8],"tags":[43],"class_list":["post-1228","post","type-post","status-publish","format-standard","hentry","category-powershell","category-sharepoint-2010","tag-powershell"],"_links":{"self":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1228","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/comments?post=1228"}],"version-history":[{"count":26,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1228\/revisions"}],"predecessor-version":[{"id":1264,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1228\/revisions\/1264"}],"wp:attachment":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/media?parent=1228"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/categories?post=1228"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/tags?post=1228"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}