Skip to main content

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

 

Comments

Popular posts from this blog

Adding a Comment to a GPO with PowerShell

As I'm writing this article, I'm also writing a customization for a PowerShell course I'm teaching next week in Phoenix.  This customization deals with Group Policy and PowerShell.  For those of you who attend my classes may already know this, but I sit their and try to ask the questions to myself that others may ask as I present the material.  I finished up my customization a few hours ago and then I realized that I did not add in how to put a comment on a GPO.  This is a feature that many Group Policy Administrators may not be aware of. This past summer I attended a presentation at TechEd on Group Policy.  One organization in the crowd had over 5,000 Group Policies.  In an environment like that, the comment section can be priceless.  I always like to write in the comment section why I created the policy so I know its purpose next week after I've completed 50 other tasks and can't remember what I did 5 minutes ago. In the Group Policy module for PowerShell V3, th

Return duplicate values from a collection with PowerShell

If you have a collection of objects and you want to remove any duplicate items, it is fairly simple. # Create a collection with duplicate values $Set1 = 1 , 1 , 2 , 2 , 3 , 4 , 5 , 6 , 7 , 1 , 2   # Remove the duplicate values. $Set1 | Select-Object -Unique 1 2 3 4 5 6 7 What if you want only the duplicate values and nothing else? # Create a collection with duplicate values $Set1 = 1 , 1 , 2 , 2 , 3 , 4 , 5 , 6 , 7 , 1 , 2   #Create a second collection with duplicate values removed. $Set2 = $Set1 | Select-Object -Unique   # Return only the duplicate values. ( Compare-Object -ReferenceObject $Set2 -DifferenceObject $Set1 ) . InputObject | Select-Object – Unique 1 2 This works with objects as well as numbers.  The first command creates a collection with 2 duplicates of both 1 and 2.   The second command creates another collection with the duplicates filtered out.  The Compare-Object cmdlet will first find items that are diffe

How to list all the AD LDS instances on a server

AD LDS allows you to provide directory services to applications that are free of the confines of Active Directory.  To list all the AD LDS instances on a server, follow this procedure: Log into the server in question Open a command prompt. Type dsdbutil and press Enter Type List Instances and press Enter . You will receive a list of the instance name, both the LDAP and SSL port numbers, the location of the database, and its status.