Skip to main content

Using Invoke-CIMMethod

In my PowerShell class last week, we took a lab a bit further.  This lab involved using the old WMI commands.  Well, that is no fun.  I was providing my answers to the lab using the new CIM cmdlets. I did this once before, but I forgot to update my answers.  You see, there is a difference in how you provide information to Invoke-CIMMethod and Invoke-WMIMethod

The objective was to change the Start Mode of the WinRM service.  To do this in WMI:

       Get-WmiObject –Class Win32_Service –Filter "Name='WinRM'" |
           Invoke-WmiMethod –Name ChangeStartMode –Argument 'Automatic'

You would think that you could do the same with the CIM cmdlets, but PowerShell did not like this.
     Get-CimInstance -ClassName Win32_Service –Filter "Name='WinRM'" |
        Invoke-CimMethod -MethodName ChangeStartMode -Arguments 'Automatic'
Invoke-CimMethod : Cannot bind parameter 'Arguments'. Cannot convert the "Automatic" value of type
"System.String" to type "System.Collections.IDictionary".
At line:2 char:65
+ ...   Invoke-CimMethod -MethodName ChangeStartMode -Arguments 'Automatic'
+                                                               ~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Invoke-CimMethod], ParameterBindingException
    + FullyQualifiedErrorId : CannotConvertArgumentNoMessage,Microsoft.Management.Infrastructure.CimCmdlets.I
   nvokeCimMethodCommand

Using Invoke-CIMMethod, the –Arguments parameter requires a System.Collections.IDictionary object.  Say what???? So, I took a look at the MSDN documentation for System.Collections.IDictionary.  In the Remarks section, I learned that this object is simply a key/value pair. 

My next stop was Win32_Service on MSDN. In particular, the ChangeStartMode method of the Win32_Service class. Here I found out the key is StartMode and the value is Automatic.



Now all that is left is to correctly format my command line.
     Get-CimInstance -ClassName Win32_Service –Filter "Name='WinRM'" |
      Invoke-CimMethod -MethodName ChangeStartMode -Arguments @{startmode='Automatic'}


The –Arguments parameter is now a key/value pair.

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.