Skip to main content

Read The Help Files

One of the things that I urge, if not plead, in my PowerShell classes is to read the help files.  I’ve been working with PowerShell since it was called Monad.  I honestly cannot work with PowerShell unless I use the help system.  One of the reasons why I want IT Pros to read the help files is so they do not “assume” something.  Take this code that I looked at on PowerShell.Com’s forums.

  get-content -path c:\temp\servers.txt |

 foreach {Get-WmiObject win32_service} |

 select pscomputername, displayname, startname

 

The problem that the IT Pro was having is that the PSComputerName property was always his local client, not the remote computer.  The help file for Get-WMIObject says this about the ComputerName parameter:

-ComputerName [<String[]>]

    Specifies the target computer for the management operation. Enter a fully

    qualified domain name, a NetBIOS name, or an IP address. When the remote

    computer is in a different domain than the local computer, the fully

    qualified domain name is required.

   

    The default is the local computer. To specify the local computer, such as

    in a list of computer names, use "localhost", the local computer name, or

    a dot (.).

   

    This parameter does not rely on Windows PowerShell remoting, which uses

    WS-Management. You can use the ComputerName parameter of Get-WmiObject

    even if your computer is not configured to run WS-Management remote

    commands.

   

    Required?                    false

    Position?                    named

    Default value                none

    Accept pipeline input?       false

    Accept wildcard characters?  false

 

The assumption here is that ComputerName would be populated by the name of the computer in the Pipeline.  Two things are wrong here.  The first is that ComputerName parameter is Name, not positional.  It also cannot accept anything from the pipeline.  That means that if you do not type –ComputerName, it will not be used.  Get-WMIObject will execute against the local client.  The other problem is that inside of ForEach-Object, you need to make a reference to the current object in the PowerShell Pipeline.  You do this with $_ or $PSItem  

The site user CMartin16 provided the correct answer to this problem:

 get-content -path c:\temp\servers.txt |

 foreach {Get-WmiObject win32_service -ComputerName $_} |

 select pscomputername, displayname, startname

 

As an update to this, take a look at Get-CIMInstance and using a CIMSession.  You could also use Invoke-Command and take advantage of PowerShell remoting to contact the remote clients.

Get-Content -Path c:\temp\servers.txt |

 ForEach-Object {Get-CimInstance -ClassName Win32_Service -ComputerName $_} |

 Select-Object -Property pscomputername, displayname, startname

 

The ComputerName parameter of Get-CIMInstance creates an ad-hoc Session to each client. Here is another example.

Get-CimInstance -ClassName Win32_Service -ComputerName (Get-Content -Path c:\temp\servers.txt)|

Select-Object -Property pscomputername, displayname, startname

 

An example using PowerShell remoting.

Invoke-Command -ComputerName (Get-Content -Path c:\temp\servers.txt) -ScriptBlock {

    Get-CimInstance -ClassName Win32_Service

}| Select-Object -Property pscomputername, displayname, startname

 

 

 

 

 

 

 

 

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.