Advanced Windows PowerShell Scripting Video Training

Advanced Windows PowerShell Scripting Video Training
Advanced Windows PowerShell Scripting Video Training

Thursday, February 12, 2015

Let PowerShell Read for You

As a Chief Petty Officer in the US Navy, I often find myself with a really long article or email to read.  This can be a bit of a pain when I have a lot of work to do.  Don’t get me wrong, I go through everyone.  I just do it a bit of a different way.  Back in August of 2013, I published my Out-Voice cmdlet.  It simply uses the Windows Text-to-Speech converter to read what ever strings you send it.  Below is my Read-Article cmdlet.

To use it, just copy your long email or article into a text file and let it go. I’m including this in the source code that I am sending my PowerShell students home with since it gives two examples of basic error handling. If you need a copy of Out-Voice, you can get it here.  I have it loading as one of my PowerShell modules.

 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

 

Function Read-Article

{

<#

.SYNOPSIS

Reads a text file.

 

.DESCRIPTION

Reads a text file.  The cmdlet Out-Voice must be loaded in memory.  You can get

a copy of Out-Voice at:

http://mctexpert.blogspot.com/2013/08/have-powershell-verbally-provide.html

 

.PARAMETER $File

The name of the txt file to read.

 

.PARAMETER $Voice

Allows for the default choice to be changed using the

default voices installed on Windows 8. Acceptable values are:

US_Male

UK_Female

US_Female

 

.EXAMPLE

Read-Article News.txt

 

Reads the text file News.txt

 

.NOTES

===============================================================================

== Cmdlet: Read-Article                                                      ==

== Author: Jason A. Yoder                                                    ==

== Company: MCTExpert of Arizona                                             ==

== Date: February 11, 2015                                                   ==

== Copyright: All rights reserved.                                           ==

== Version: 1.0.0.0                                                          ==

== Legal: The user assumes all responsibility and liability for the usage of ==

== this PowerShell code.  MCTExpert of Arizona, Its officers, shareholders,  ==

== owners, and their relatives are not liable for any damages.  As with all  ==

== code, review it and understand it prior to usage.  It is recommended that ==

== this code be fully tested and validated in a test environment prior to    ==

== usage in a production environment.                                        ==

==                                                                           ==

== Does this code make changes: NO                                           ==

== Requirements: Out-Voice must be in memory.  To get a copy of Out-Voice:   ==

== http://mctexpert.blogspot.com/2013/08/have-powershell-verbally-provide.html

===============================================================================

#>

#>

[CmdletBinding()]

Param

(  

    [parameter(Mandatory=$true)]

    [String]

    $File,

 

    [ValidateSet("US_Male", "UK_Female", "UK_Female")]

    [String]

    $Voice = "US_Female"

)

 

# Verify that the cmdlet Out-Voice is present in memory.

Try {Get-Command -Name Out-Voice -ErrorAction Stop}

Catch {Write-Host "The Cmdlet Out-Voice is not in memory,"}

 

# Load the file

Try {$A = Get-Content -Path $File -ErrorAction Stop}

Catch {Write-Host "File not found"}

 

$A | Out-Voice -VoiceType $Voice

 

} # END: Function Read-Article

 

No comments: