I've been prepping my demo scripts for Techmentor using the ubiquitous Start-Demo, and realized I could take things further. I mean, why do I have to do all the talking? Windows 7 has a terrific text to speech engine so why not take advantage of it. With a little work I could create a virtual demo that doesn't require a real person, other than to kick it off. Thus was born Start-VirtualDemo.<\/p>\n
My function relies on the SAPI.SPVoice COM object and works best on Windows 7. The voice isn't perfect but much better than previous versions and at least in my tests more than adequate. The function needs a text file \"script\". In this file, write the text you want to be read putting a # at the beginning of the line. Then type any PowerShell expressions you would like to demonstrate. For now, the command must be all in one line. Here's a sample text file.<\/p>\n
#Hello, I am Serenity, and I will be your virtual guide today.\r\n#Let me demonstrate some basic PowerShell commands.\r\n#First, let's find all the running services on this computer.\r\nGet-Service | Where {$_.status -eq \"Running\"}\r\n\r\n#What about processes? \r\nGet-Process -name \"PowerShell\"\r\n#Here are the running PowerShell sessions\r\n\r\n#PowerShell also lets you navigate other data stores like the registry.\r\nCD hklm:\\Software\r\ndir\r\nget-itemproperty \"microsoft\\windows nt\\currentversion\"\r\n#Do you think this would be useful?\r\n\r\n#WMI is a lot of fun and easy to use in PowerShell. \r\nGet-Wmiobject Win32_logicaldisk -filter \"drivetype=3\"\r\n#This command will return fixed logical disk information.\r\n\r\n#If you need help on how to run a command, just ask.\r\nGet-Help Get-WMIObject\r\n\r\n#Isn't that easy? \r\n#Remember, those who forget to script are doomed to repeat their work.\"\r\n#Discover more with a copy of Windows PowerShell 2.0 Tee ef em by Don Jones and Jeffery Hicks\r\n#Thank you for your attention and have a great day!<\/pre>\nThe function will strip out any blank lines so put in as many as you want to help visually organize your script. You might have to experiment and tweak some words or phrases using phonetic-like alternatives to get the correct pronunciation. The script itself is pretty straight forward.<\/p>\n
Param(\r\n [Parameter(Position=0)]\r\n [string]$File=\"demo.txt\",\r\n [int]$rate=-1\r\n)\r\n\r\n#verify the text file \"script\"\r\nif (-Not (Test-Path -path $File))\r\n{\r\nWrite-Error \"Failed to find $file. Please verify and try again.\"\r\n}\r\nelse\r\n{\r\nTry {\r\n#create the Voice object\r\n$voice=New-Object -ComObject \"SAPI.SPVoice\"\r\n#I find a slower rate works better but you may need to experiment\r\n$voice.rate=$rate\r\n}\r\n\r\nCatch {\r\n#Oops.\r\nWrite-Warning \"Unable to create the Voice object.\"\r\n}\r\n\r\nif ($voice) {\r\n#cleas the screen\r\nClear-Host\r\n\r\n#store the current location so we can return to it\r\nPush-Location\r\n\r\n#get all data from the text file, filtering out blank lines\r\n$data=Get-Content $file | where {$_}\r\n\r\nWrite-Host \"Demo Started.\" -ForegroundColor Cyan\r\n\r\n#go through each line. Lines that start with # will be spoken.\r\n#All other lines will be displayed in a pseudo prompt and then executed\r\nforeach ($line in $data) {\r\n\r\nIf ($line.StartsWith(\"#\"))\r\n{\r\n$voice.Speak($line.Substring(1)) | Out-Null\r\n}\r\nelse\r\n{\r\n#display the command using the current location in a prompt\r\n#add a blank line before and after the command\r\nWrite-host (\"`nPS {0}> {1} `n\" -f (Get-Location).path,$line)\r\n#pause a few seconds to give the viewer time to read the command\r\nsleep 3\r\n#execute the command\r\nInvoke-Expression $line | Out-Default\r\n}\r\n} #Foreach\r\n\r\n#return to the original location\r\nPop-Location\r\n} #if $voice\r\n} #else file found\r\nWrite-Host \"Demo Finished.\" -ForegroundColor Cyan<\/pre>\nTo run the script all you need to do is specify the text file. Or use the default value from the parameter. The script will store your current location and return to it at the end so if you change locations in your demo nothing will have changed when your demo ends. The script will display the demo command in a pseudo prompt, using your current location.<\/p>\n
#display the command using the current location in a prompt\r\n #add a blank line before and after the command\r\n Write-host (\"`nPS {0}> {1} `n\" -f (Get-Location).path,$line)<\/pre>\nI have to say I thought this turned out quite nicely. Here's a video demo.<\/p>\n