Share via


SMS_MachineVariable Server WMI Class

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The SMS_MachineVariable Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, and it defines the settings of a task sequence variable that is unique to a specific computer. This variable can customize the behavior of a task sequence for a specific computer, and it overrides any definition that is set by SMS_CollectionVariable Server WMI Class. Machine variables are automatically replicated down through the site hierarchy. For example, if a variable is declared on the primary child site server, it will be available on the primary grandchild site server, but not on the primary site server.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.

Class SMS_MachineVariable
{
      Boolean IsMasked;
      String Name;
      String Value;
};

Methods

The SMS_MachineVariable class does not define any methods.

Properties

  • IsMasked
    Data type: Boolean

    Access type: Read/Write

    Qualifiers: None

    This value should be set to true if the contains a sensitive value, such as a password, in which case the SMS Provider treats this property as write-only and disallows reads. The default value is false.

    If true, the Value property is obfuscated in the database and when it is transmitted to the client. For any setting of this property, task sequence actions always receive the unobfuscated value.

  • Name
    Data type: String

    Access type: Read/Write

    Qualifiers: [key]

    The name of the machine variable. The default value is "".

  • Value
    Data type: String

    Access type: Read/Write

    Qualifiers: None

    The machine variable value. The default value is null. This property is obfuscated if the IsMasked property value is true.

Remarks

Class qualifiers for this class include:

  • Embedded

For more information about both the class qualifiers and the property qualifiers that are included in the Properties section, see Configuration Manager Class and Property Qualifiers.

Your application uses this class to create objects that are embedded by the SMS_MachineSettings Server WMI Class and accessed by using the MachineVariables property. For an example of the use of this class, see How to Create a Computer Variable in Configuration Manager.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

See Also

Concepts

Operating System Deployment Server WMI Classes
SMS_MachineSettings Server WMI Class
SMS_CollectionVariable Server WMI Class
Configuration Manager Operating System Deployment
About Operating System Deployment Task Sequences
How to Create a Computer Variable in Configuration Manager