Automating repetitive tasks is
what scripting is all about. Therefore, each scripting language needs at
least one method for cycling, or looping through a block of instructions. PowerShell provides a rich variety of
looping techniques. However, because loops can go spectacularly wrong, I recommend you test a simple
PowerShell loop before graduating to more complex constructions in your production scripts.
The 'While' loop is the easiest to master, and also the most flexible. Each type of PowerShell loop has specific syntax rules; in the case of the 'While' loop there are only two elements
(condition) and {Block Statement}. As so often with PowerShell, the type of brackets is highly significant; (Parenthesis for the condition) and {curly braces for the command block}.
The way that the loop works is that PowerShell evaluates the condition at the start of each cycle, and if it's true, then it executes the command block.
Here is a simple
PowerShell 'while' loop to calculate,
and then display, the 7 times table.
$i
=7 while ($i -le 85) { $i; $i +=7}
Learning Points
Note 1: $i is a variable set to 7. Remember,
the mission was to create the seven times table. Note 2: Observe the two types of bracket (while) {Block Calculation} Note
3: -le means less than or equals. (Other comparators are: -eq and
-gt) Note 4: +=7 increments the variable $i by seven on each loop.
Alternatively, we could use a semicolon to join the two statements
to form one line. $i =7; while ($i -le 85) { $i; $i
+=7 }.
In the 'Do ... While' loop, PowerShell checks the (condition) at the end of each loop. One feature of the 'Do While' loop is that the
{Command Block} is always executed at least once, this is because the 'While' comes after the 'Do'.
$i = 7; do { $i; $i +=7 } while ($i -le 85)
Note 1: Without the semicolon it would need two lines thus:
$i = 7 do { $i; $i +=7 } while ($i -le 85)
Do Until There is a variation of this style of
loop, 'Do .. Until'. The layout of the components is the same as 'Do While', the only difference is that the logic is changed from, do while condition is true, to, do until condition is true.
The PowerShell 'ForEach' loop is more complex, and has more arguments than the 'for' and 'Do While'.
The key feature is that loop interrogates an array, known as a collection. In addition to the position, and the type of bracket, observe the tiny, but crucial keyword, 'in'.
Here is the syntax:
ForEach ($item in $array_collection) {command_block}
Guy Recommends: SolarWinds Engineer's Toolset v10
The Engineer's Toolset v10 provides a
comprehensive console of utilities for troubleshooting computer problems. Guy says
it helps me monitor what's occurring on the network, and the tools
teaches me more about how the system literally operates.
There are so many good gadgets, it's like having free rein of a
sweetshop. Thankfully the utilities are displayed logically: monitoring, discovery, diagnostic, and Cisco tools.
Download your copy of the Engineer's Toolset v 10
PowerShell Example 1 - Math
foreach ($number in 1,2,3,4,5,6,7,8,9,10,11,12 ) { $number * 7}
Note 1: By creating five variations, my aim is to give you
both perspective and experience of the PowerShell foreach loop.
Note 2: (1..12) is a convenient method
of representing a sequence.
PowerShell Example 2 - To display files
Here is an example of a
PowerShell 'foreach' loop which displays the filename and its size. In order to get this example to work, create a cmdlet by saving the following into
a file, and give it a .ps1 extension. Call the cmdlet from the PS prompt. If the file is called ListDoc.ps1, and assuming that the file is in the current directory, then at the PS prompt type:
.\listdoc
Alternatively, from the PS prompt, type the full path D:\scripts\listdoc.
In Cmdlet 2 (below), we can employ a simple 'if' statement to filter .txt files. Naturally, feel free to alter -eq ".txt" to a more suitable extension.
Cmdlet 2
# PowerShell foreach loop to display files LastAccessTime "File Name " + "`t Size" +"`t Last Accessed" foreach ($file in get-Childitem) {if ($file.extension -eq ".txt") { $file.name + "`t " +$file.length + "`t " + $file.LastAccessTime } }
Learning Points
Note 0: If all else fails, copy the above code, and paste to PowerShell prompt, and then press 'Enter'.
Note 1: `t means Tab.
Guy Recommends: SolarWinds LANSurveyor
LANSurveyor will produce a neat diagram of your network topology. But that's
just the start;
LANSurveyor can
create an inventory of the hardware and software
of your machines and network devices. Other neat features include dynamic
update for when you add new devices to your network. I also love the ability to export
the diagrams
to Microsoft Visio.
Finally, Guy bets that if you take a free trial of LANSurveyor then you will
find a device on your network that you had forgotten about, or someone else
installed without you realizing!
This example conforms to the
PowerShell ForEach (condition) {Code Block}; however, there is a
preamble of 16 lines where the script connect to
Active Directory. Moreover, the {Code Block} is spread over several lines.
N.B. Find $Dom on line 7 and change the value to that of your domain, including the extension.
# ForEach_AD.ps1 # Illustrates using PowerShell ForEach loop to interrogate AD # IMPORTANT change $Dom 'value' # Author: Guy Thomas # Version 2.5 November 2006 tested on PowerShell RC2
One use of the PowerShell 'For loop' is to iterate an array of values and then work with a subset of these values. Should you wish to cycle through all the values
in your array, consider using a foreach construction.
Here is the syntax: for (<init>; <condition>; <repeat>) {<command_block>}
I have not found it possible to pipe input into loops. Obtaining output was
nearly as difficult, however, I have discovered this trick to assign the output to a variable, which we can then manipulate.
$NumArray = (1..12) $(foreach ($number in $numArray ) { $number * 7}) | set-variable 7x $7x # Option research properties by removing # on the next line # $7x |get-Member
I (Guy) envy /\/\o\/\/'s ability to write tight code. That % sign
means 'foreach'. If you (readers) see anything on the internet by /\/\o\/\/,
then you can be sure that it's top draw code.
PowerShell supports a variety of different loops, for example, 'While' and 'Foreach'.
The secret of understanding the PowerShell loop is to study the type of
bracket. For example when defining the constructions elements, (use parenthesis) for the condition and {use braces} for
the command block. Take the time to master loops, and thus automate your repetitive 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.
Guy
Recommends: Orion's NPM - Network Performance Monitor
Orion's performance monitor is designed for detecting network outages.
A network-centric
view make it easy to see what's working, and what needs your attention.
This utility guides you through troubleshooting by indicating whether the
root cause is faulty equipment or resource overload.