# Set Property CIM Operation

The `setProperty` CIM operation sets a single property value on a CIM Instance.

NameSpace String that defines the target namespace. See NameSpace Operations for more information

InstanceName Defines the Name of the instance whose property value is to be set. See Enumerate Instance Names for instance names for a class

PropertyName Name of the property whose value is to be updated.

New value New value for the property.

## Return Request

If unsuccessful, one of the following status codes MUST be returned by this method, where the first applicable error in the list (starting with the first element of the list, and working down) is the error returned. Any additional method-specific interpretation of the error in is given in parentheses.

- CIM_ERR_ACCESS_DENIED
- CIM_ERR_INVALID_NAMESPACE
- CIM_ERR_INVALID_PARAMETER (including missing,duplicate, unrecognized or otherwise incorrect parameters)
- CIM_ERR_INVALID_CLASS (the CIM Class does not exist in the specified namespace)
- CIM_ERR_NOT_FOUND (the CIM Class does exist, but the requested CIM Instance does not exist in the specified namespace)
- CIM_ERR_NO_SUCH_PROPERTY (the CIM Instance does exist, but the requested CIMProperty does not)
- CIM_ERR_FAILED (some other unspecified error occurred)

## Additional Information

The `setProperty` operation sets a single property value in a CIM Instance in the target Namespace.

NameSpace The NameSpace parameter is a string that defines the target namespace.

InstanceName The InstanceName input parameter specifies the name of the Instance (model path) for which the CIMProperty value is to be updated.

PropertyName The PropertyName input parameter specifies the name of the CIMProperty whose value is to be updated.

Newvalue The NewValue input parameter specifies the new value for the CIMProperty (which may be NULL).

## Pegasus C++ API as defined in Operations.h

        virtual void setProperty(
            const String& nameSpace,
    		const CIMReference& instanceName,
    		const String& propertyName,
    		const CIMValue& newValue = CIMValue()) = 0;

Demonstration Prepared by the OpenGroup Manageability Work Group Pegasus Development Team

See (http://www.opengroup.org/management) for more information on Pegasus

Last Modified Friday, June 29, 2001 06:46:49 PM Copyright @ The Open Group 2001