Edit

Share via


How to Modify a Configuration Manager Object by Using WMI

You modify a Configuration Manager object, in Configuration Manager, by using the object's SWbemObject object to change its properties.

To modify a Configuration Manager object

  1. Set up a connection to the SMS Provider. For more information, see How to Connect to an SMS Provider in Configuration Manager by Using WMI.

  2. Using the SWbemServices object you obtain from step one, call the Get method and specify the class and key information for the object you want. This returns a SWbemObject representing object.

  3. Using the SWbemObject, update the object properties.

  4. Call Put_ to update the object in the SMS Provider.

Example

The following VBScript code example gets a package (SMS_Package) object, changes the package description, and then commits the changes back to the SMS Provider. In this example, the package is retrieved through a call to the SWbemServices object Get. You can also retrieve the package by using a query. For more information, see How to Perform a Synchronous Configuration Manager Query by Using WMI.

For information about calling the sample code, see Calling Configuration Manager Code Snippets.

Sub ModifyPackageDescription (connection, packageID, description)

    On Error Resume Next
    Dim package

    ' Get the package.
    Set package = connection.Get("SMS_Package.PackageID='" & packageID & "'")
    If Err.Number<>0 Then
        Wscript.Echo "Couldn't get package " + packageID
        Exit Sub
    End If

    Wscript.Echo "Package Name: " + package.Name
    Wscript.Echo "Current Description: " + package.Description

    ' Update and commit the package.
    package.Description = description

    package.Put_
    If Err.Number<>0 Then
        WScript.Echo "Couldn't commit the package"
        Exit Sub
    End If

    Wscript.Echo "New Description: " + package.Description
End Sub

This example method has the following parameters:

Parameter Type Description
connection SWbemServices A valid connection to the SMS Provider.
packageID String The package identifier. This is available from the SMS_Package class PackageID identifier.
Description String A new description for the object.

See Also

Windows Management Instrumentation Objects overview How to Call a Configuration Manager Object Class Method by Using WMI How to Connect to an SMS Provider in Configuration Manager by Using WMI How to Create a Configuration Manager Object by Using WMI How to Delete a Configuration Manager Object by Using WMI How to Perform an Asynchronous Configuration Manager Query by Using WMI How to Perform a Synchronous Configuration Manager Query by Using WMI How to Read a Configuration Manager Object by Using WMI How to Read Lazy Properties by Using WMI