PowerShell


PowerShell - Three Key Commands

Introduction to Key PowerShell Commands

Here are three simple, yet key commands, which are designed to get you started with PowerShell.  As you study, my example scripts keep in mind the golden rule, verb-noun, for example, get-PSProvider.

Three Key PowerShell Commands or Cmdlets

  1. Get-Command
  2. Get-Help
  3. Get-Member

1. Get-Command

Let us begin by testing get-Command.  What this instruction does is list all of PowerShell's noun-verb pairs; incidentally, these are also referred to as built-in cmdlets.  Assuming that you have opened a PowerShell session, then you should see a prompt like: PS >   Now type just one hyphenated phrase:
get-Command

To filter the list, employ the famous star * wildcard; here are three examples:
get-Command out*
get-Command add*
get-Command get-*

Let us experiment with a variation of this wildcard theme which displays only cmdlets beginning with the verb 'set':
get-Command set* -commandType cmdlet

It is possible to tweak the display of your output columns with ft (Format-Table).  My hidden agenda here is to give you practice with PowerShell's Pipe symbol (|), try:
get-command |ft name, definition -auto

At the moment we are just 'playing', testing, or feeling our way, thus do feel free to experiment with your own variations of my suggestions.  Once you have seen the long list of all possible commands, chose one cmdlet for further research, for example:

Get-PSProvider  (Or plain: PSProvider)

This is what happened when I typed just: get-Psprovider  <carriage return>

Name Capabilities Drives
---- ------------ ------
Alias ShouldProcess {Alias}
Environment ShouldProcess {Env}
FileSystem Filter, ShouldProcess {C, D, E, H...}
Function ShouldProcess {Function}
Registry ShouldProcess {HKLM, HKCU}
Variable ShouldProcess {Variable}
Certificate ShouldProcess {cert}

Challenge:  try
PSProvider | get-Member

Another Command PSSnapin

What PSSnapin does is reveal the sources for the built-in cmdlets:

Get-PSSnapin
Or
Get-PSSnapin |ft name, description -autosize

Note how every PowerShell noun is singular, PSSnapin, Command, PSProvider. Also note how a Pipe (|) followed by ft means format the output as a table, as opposed to format the results as a list (fl).  Any words which follow 'ft' are names of the fields, each separated by a comma.  At the end of the above command is the switch -autosize,  this extra parameter tells PowerShell to close-up the width of the columns.  When ever you use format-Table, or ft, try appending -autosize, or the shorter version: -auto.

In the example below, I have used ft to omit the Description field and just displayed the name: 
Get-PSSnapin |ft name:

Name
----
Microsoft.PowerShell.Core
Microsoft.PowerShell.Host
Microsoft.PowerShell.Management
Microsoft.PowerShell.Security
Microsoft.PowerShell.Utility

2. Get-Help

Avoid arrogance, put aside pride, and call for PowerShell's built-in help.  We all have to learn somewhere and only you know what you type in the privacy of your PowerShell command line.

Perhaps what puts us off trying built-in help is a bad experience with the stilted help of an old DOS system.  Dare I suggest that experience with internet search techniques makes us more willing to try a modern application's own help?

PowerShell's help has some interesting switches, such as: -full and -example.  Incidentally, -exampleS also works, a rare case of a plural PowerShell noun.

Get-help get-wmiobject

Note: Get-help does not require the pipe symbol.  In fact, the pipe (|) only gets in the way of get-help; PowerShell does its best to interpret:
Get-help | get-wmiobject cim_chip   But it still results in an error, therefore stick with plain simple:
Get-help get-wmiobject

Guy's List of Useful Information Revealed by get-Help

Beginners love PowerShell's get-Help, whereas intermediates ignore it. Experts on the other hand return to get-Member.  Indeed, PowerShell experts are expert because they know how and when to use a tool such as get-Help, for example:

-filter (wmi Win32_Share)
-computerName  (help wmi)
-query

PowerShell's Hidden 'About' files

In the PowerShell folder referenced by: $PSHome **, you will find a whole family of About help files. In these files, which all begin with About_, you will discover information on topics such as Foreach, If and ElseIf. My point is that you cannot get assistance by typing: get-help foreach, yet you can find a wealth of information if you read the file at: $PSHome\about_foreach.help.txt.

Here is a cmdlet that reveals the names of these About files:

# List all the About help files
$i=0
$Homes = get-ChildItem "$PSHome\about*.*" -recurse
foreach ($About in $Homes) {$About.name; $i++}
"There are $i about files"

Result: A list of 55 files. (The precise number varies with each version of PowerShell). 

** On my system $PSHome translated to: C:\WINDOWS\system32\WindowsPowerShell\v1.0

  ˚

3. Get-Member

Learn from my mistakes, and take a minute to imprint the format of this get-Member command into your brain.  The key point is that the object you want information about comes at the beginning, and not at the end of the command.  My second error was (is) forgetting the pipe symbol.

Here is the correct format:
Get-process | get-Member

Wrong
get-Member | get-Process  (sequence incorrect)
get-Process get-Member (forgot the pipe symbol)

Worth a try:
Get-process | Get-Member -Membertype property
Get-process | Get-Member -Membertype method

Call me lazy, or call me showing that commands are not case sensitive.  My point is that get-Process, Get-Process and get-Process are all interpreted identically.  In PowerShell, capitalization of command statements has no effect on successful execution.   See more on the get-Member cmdlet

Tab Completion

Talking of being lazy, PowerShell also supports a tab auto-complete feature.  Once you have typed enough of a command to make it unique, you can press tab and PowerShell completes the rest of the command.

get-Process get-mem(tab) automatically expands to: get-Process get-Member.  As you can probably guess, this tab completion works for all commands not just this one.  Incidentally, when you employ PowerShell's parameters you can take advantage of similar automatic completion, for example -auto instead of -autosize and -f instead of -filter.  Once again, there are many more such auto-completions.

Summary of PowerShell's Commands

Talk to an experienced PowerShell user, or talk to a teaching guru, they will each tell you that that the secret of success is simple, keep returning to the basics until you gain mastery. Those basics are: get-command, get-Member and get-help.

See also these PowerShell tutorials

PowerShell Home  • Introduction  • Dreams  • 3 Key Commands  • Cmdlet scripts  • Real life tasks

Please write in if you see errors of any kind.  Please report any factual mistakes, grammatical errors or broken links, I will be happy to not only to correct the fault, but also to give you credit.

Download my ebook:Getting Started with PowerShell
Getting Started with PowerShell - only $9.25

You get 36 topics organized into these 3 sections:
   1) Getting Started
   2) Real-life tasks
   3) Examples of Syntax.

In addition to the ebook, you get a PDF version of this  Introduction to PowerShell ebook  It runs to 120 pages of A4.

 *


Google

Webcomputerperformance.co.uk

Guy Recommends: SolarWinds Exchange Monitor

Exchange Monitor from SolarWindsHere is a free tool to monitor your Exchange Server

 

Home Copyright © 1999-2008 Computer Performance LTD All rights reserved

Please report a broken link, or an error.