{"id":13281,"date":"2011-07-18T00:01:00","date_gmt":"2011-07-18T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/07\/18\/install-the-pscx-and-80-new-cmdlets-to-ease-powershell-use\/"},"modified":"2011-07-18T00:01:00","modified_gmt":"2011-07-18T00:01:00","slug":"install-the-pscx-and-80-new-cmdlets-to-ease-powershell-use","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/install-the-pscx-and-80-new-cmdlets-to-ease-powershell-use\/","title":{"rendered":"Install the PSCX and 80 New Cmdlets to Ease PowerShell Use"},"content":{"rendered":"

Summary<\/b>: Install the PSCX and get 80 new cmdlets to ease Windows PowerShell use.<\/p>\n

 <\/p>\n

\"Hey,Hey, Scripting Guy! You have been spending quite a bit of time recently talking about functions and modules and the like. What is the big deal, and where would I find such modules?<\/p>\n

—KF<\/p>\n

 <\/p>\n

\"Hey,Hello KF,<\/p>\n

Microsoft Scripting Guy Ed Wilson here. Things are pretty exciting around the Scripting House. It seems like the roofers are nearing completion of their project of repairing the storm damage we had, and our solar heater for the swimming pool is working out great. But the most exciting things are the summer speaking engagements I have coming up. The Scripting Wife and I are getting ready for my presentation to the Columbus Ohio Users Group meeting on Thursday, July 21. On Saturday, we will be in Wheeling West Virginia for SQL Saturday. Before that on July 20, I am speaking at the Virtual PowerShell group. On Sunday I head to Seattle where I will be speaking at the TechReady conference. Sound confusing? You can keep up with it all the same way I do: check out the Community Page<\/a> to see where you can catch the Scripting Guys either in person or at a virtual meeting.<\/p>\n

KF, because I am going to be spending so much time in front of the community in the next few weeks (I did not even mention the trip to Corpus Christy, Texas, or SQL Solstice in Raleigh), I thought it would be great to answer your question by using a community driven project. The PowerShell Community Extensions<\/a> (PSCX) project is a great example of community-driven modules. I have mentioned the PSCX previously<\/a>, and have even had a guest article written by Microsoft PowerShell MVP Keith Hill<\/a> that talked about the project.<\/p>\n

One thing to keep in mind is that by default, the user location for Windows PowerShell modules does not exist. That location can be in one or two places depending on the version of the operating system. On Windows Vista and later, it is in the Documents <\/i>folder, but on Windows Server 2003 and before, it is in the My Documents <\/i>folder. This is illustrated in the following lines of code:<\/p>\n

$VistaPath = “$env:userProfile\\documents\\WindowsPowerShell\\Modules”<\/p>\n

$XPPath =  “$env:Userprofile\\my documents\\WindowsPowerShell\\Modules”<\/p>\n

 <\/p>\n

The user location on a Windows 7 computer appears in the following figure. Keep in mind that the folder is not present because no user modules have been copied to this machine yet.<\/p>\n

\"Image<\/a><\/p>\n

One thing that can be confusing is that by default, the Get-ChildItem<\/b> cmdlet (dir<\/b> is an alias) does not display hidden or system files. This can cause misleading results when Explorer is set to display hidden and system files, and the force<\/i> parameter is not used. The two different views of the folder are shown here:<\/p>\n

PS C:\\> dir $HOME\\documents <\/p>\n

    Directory: C:\\Users\\ed.IAMMRED\\documents<\/p>\n

 <\/p>\n

Mode<\/span>               LastWriteTime<\/span>                Length Name<\/span><\/p>\n

d—-                 7\/5\/2011  12:53 PM        SnagIt Catalog<\/p>\n

d—-                 6\/7\/2011   3:04 PM        Visual Studio 2010<\/p>\n

 <\/p>\n

PS C:\\> dir $HOME\\documents -Force<\/p>\n

 <\/p>\n

    Directory: C:\\Users\\ed.IAMMRED\\documents<\/p>\n

 <\/p>\n

Mode<\/span>               LastWriteTime<\/span>                Length Name<\/span><\/p>\n

d—hs                7\/3\/2011   7:37 PM        My Music<\/p>\n

d—hs                7\/3\/2011   7:37 PM        My Pictures<\/p>\n

d—hs                7\/3\/2011   7:37 PM        My Videos<\/p>\n

d—-                 7\/5\/2011  12:53 PM        SnagIt Catalog<\/p>\n

d—-                 6\/7\/2011   3:04 PM        Visual Studio 2010<\/p>\n

-a-h-                 7\/13\/2011   3:21 PM       1984 Default.rdp<\/p>\n

-a-hs                 7\/3\/2011   7:37 PM        402 desktop.ini<\/p>\n

 <\/p>\n

PS C:\\><\/p>\n

As I mentioned in a previous article, my Copy-Modules<\/b> script is not optimized to work with projects that include multiple types of files (such as .dll <\/i>and <\/i>.exe). I created it specifically to aid in the installation of simple module files. Therefore, my Copy-Modules<\/b> script will not install the PSCX properly. However, a simple Copy-Item<\/b> command will accomplish this (the following command is a single command; I added the backtick character to continue the command on the second line, but normally, you would not need to continue this command on a second line):<\/p>\n

Copy-Item E:\\Downloads\\pscx -Destination `<\/p>\n

$env:userProfile\\documents\\WindowsPowerShell\\Modules -recurse<\/p>\n

When installing the PSCX, keep in mind you need to unblock the .zip file that you download from CodePlex. This Scripting Wife article talks about unblocking files<\/a>. As a quick point of reference, a file downloaded from the Internet Zone is blocked from executing. In Windows 7, right-click the file, choose Properties<\/b> from the shortcut menu, and click the Unblock<\/b> button. The Unblock<\/b> button is shown in the following figure.<\/p>\n

\"Image<\/a><\/p>\n

Speaking of unblocking files, the PSCX has the Unblock-File<\/b> cmdlet. To use it, you provide a path to the file that needs to be unblocked, as shown here:<\/p>\n

Unblock-File G:\\Pscx-2.0.0.1.zip<\/p>\n

When the above command runs, the Unblock<\/b> button no longer appears on the Properties<\/b> tab, as shown in the following figure.<\/p>\n

\"Image<\/a><\/p>\n

Of course, the Unblock-File<\/b> cmdlet is not available until you install the PSCX. How did I find that command? After the module is installed, I use the listavailable <\/i>switch from Get-Module<\/b> to ensure it was installed properly. I then use the Import-Module<\/b> cmdlet to import the module. Next, I use the Get-Command<\/b> cmdlet with the module <\/i>parameter. These three commands are shown here:<\/p>\n

Get-Module –ListAvailable<\/p>\n

Import-Module pscx<\/p>\n

get-command -Module pscx<\/p>\n

 After I have a feel for what a module offers, I might choose to only display the cmdlets:<\/p>\n

get-command -Module pscx -CommandType cmdlet<\/p>\n

 <\/p>\n

Why do I like PSCX so much? For one thing, it offers 87 cmdlets (I used the following command to find out that bit of trivia):<\/p>\n

get-command -Module pscx -CommandType cmdlet | Measure-Object<\/p>\n

 <\/p>\n

For another thing, the cmdlets are cool, and the project itself is a great model of community participation and cooperation to fill a real need.<\/p>\n

Anyway, KF, here are a couple of things I have found to be useful. One of the things I like to do is to generate a hash. The Get-Hash<\/b> cmdlet is useful for doing such a thing. It will generate an error if you attempt to generate a hash of a directory, but you can get around that pretty easily by using a filter. The following command gets a directory listing, and filters all files (and folders) that do not match the *.doc<\/b> filter. I then pipe those files to the Get-Hash<\/b> cmdlet where a hash generates:<\/p>\n

dir E:\\data\\ScriptingGuys -Filter *.doc | Get-Hash <\/p>\n

The command and associated output are shown in the following figure.<\/p>\n

 \"Image<\/a><\/p>\n

But wait, there’s more! I get tired of mousing around and copying stuff to the Clipboard, so I can paste it into Notepad. What if I pipe the results of the Get-Hash<\/b> cmdlet to the Set-Clipboard<\/b> cmdlet? While I am at it, why don’t I go ahead and open Notepad so I can paste directly with Ctrl+V? Oh, yeah, that’s the ticket. Here is the command:<\/p>\n

dir E:\\data\\ScriptingGuys -Filter *.doc | Get-Hash | Out-Clipboard;notepad<\/p>\n

The following figure shows Notepad with the hash information pasted in it.<\/p>\n

\"Image<\/a> <\/p>\n

KF, that is all there is to using the PowerShell Community Extensions.  Community Week will continue tomorrow when I will talk about more fun with community modules.<\/p>\n

 <\/p>\n

I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n

Ed Wilson, Microsoft Scripting Guy<\/b><\/p>\n

 <\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Install the PSCX and get 80 new cmdlets to ease Windows PowerShell use.   Hey, Scripting Guy! You have been spending quite a bit of time recently talking about functions and modules and the like. What is the big deal, and where would I find such modules? —KF   Hello KF, Microsoft Scripting Guy […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[52,3,4,45],"class_list":["post-13281","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-modules","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Install the PSCX and get 80 new cmdlets to ease Windows PowerShell use.   Hey, Scripting Guy! You have been spending quite a bit of time recently talking about functions and modules and the like. What is the big deal, and where would I find such modules? —KF   Hello KF, Microsoft Scripting Guy […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13281","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\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=13281"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13281\/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=13281"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=13281"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=13281"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}