SMS_TaskSequence_ApplyOperatingSystemAction 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_TaskSequence_ApplyOperatingSystemAction Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that represents a task sequence action that installs a specified operating system image on a target computer.

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

Class SMS_TaskSequence_ApplyOperatingSystemAction : SMS_TaskSequence_Action
{
      SMS_TaskSequence_Condition Condition;
      String ConfigFileName;
      String ConfigFilePackage;
      Boolean ContinueOnError;
      String Description;
      UInt32 DestinationDisk;
      String DestinationLogicalDrive;
      UInt32 DestinationPartition;
      String DestinationVariable;
      Boolean Enabled;
      UInt32 ImageIndex;
      String ImagePackageID;
      UInt32 InstallEditionIndex;
      String InstallPackageID;
      String Name;
      String SupportedEnvironment;
      UInt32 Timeout;
};

Methods

The SMS_TaskSequence_ApplyOperatingSystemAction class does not define any methods.

Properties

• Condition
  Data type: SMS_TaskSequence_Condition

  Access type: Read/Write

  Qualifiers: None

  See SMS_TaskSequence_Action Server WMI Class.

• ConfigFileName
  Data type: String

  Access type: Read/Write

  Qualifiers: [RequiredIfNotNull("ConfigFilePackage"), VariableName("OSDConfigFileName")]

  The name of the answer file specified in the ConfigFilePackage property. For more information, see the Remarks section later in this topic.

  The task sequence variable associated with this property is OSDConfigFileName. For more information, see the MSDN documentation for Operating System Deployment Task Sequence Variables.

• ConfigFilePackage
  Data type: String

  Access type: Read/Write

  Qualifiers: [CommandLineArg(4), TaskSequencePackage]

  ID of the optional package containing the Windows setup answer file. For more information, see the Remarks section later in this topic.

• ContinueOnError
  Data type: Boolean

  Access type: Read/Write

  Qualifiers: None

  See SMS_TaskSequence_Action Server WMI Class.

• Description
  Data type: String

  Access type: Read/Write

  Qualifiers: [AllowedLen("0-255")]

  See SMS_TaskSequence_Action Server WMI Class.

• DestinationDisk
  Data type: UInt32

  Access type: Read/Write

  Qualifiers: [CommandLineArg(6), ValueRange("0-99")]

  Index of the disk to which to apply the image. The index can have a value of 0 through 99. For more information, see the Remarks section later in this topic.

• DestinationLogicalDrive
  Data type: String

  Access type: Read/Write

  Qualifiers: [CommandLineArg(8)]

  Logical drive letter of the volume to which the image is applied. For more information, see the Remarks section later in this topic.

• DestinationPartition
  Data type: UInt32

  Access type: Read/Write

  Qualifiers: [CommandLineArg(7), RequiredIfNotNull("DestinationDisk"), ValueRange("1-99")]

  Index of the partition on the target disk specified by DestinationDisk to which the image is applied. The index can have a value of 1 through 99. For more information, see the Remarks section later in this topic.

• DestinationVariable
  Data type: String

  Access type: Read/Write

  Qualifiers: [CommandLineArg(9)]

  Task sequence variable containing the logical drive letter of the volume to which the image is applied. For more information, see the Remarks section later in this topic.

• Enabled
  Data type: Boolean

  Access type: Read/Write

  Qualifiers: None

  See SMS_TaskSequence_Action Server WMI Class.

• ImageIndex
  Data type: UInt32

  Access type: Read/Write

  Qualifiers: [RequiredIfNotNull("ImagePackageID"), ValueRange("1-2147483647"), VariableName("OSDImageIndex")]

  Index of the image in the WIM file applied to the target computer. The value of this property can be between 1 and 2147483647. This property is required if ImagePackageID is set. For more information, see the Remarks section later in this topic.

  The task sequence variable associated with this property is OSDImageIndex. For more information, see the MSDN documentation for Operating System Deployment Task Sequence Variables.

• ImagePackageID
  Data type: String

  Access type: Read/Write

  Qualifiers: [CommandLineArg(1), TaskSequencePackage("image"),RequiredIfNull("InstallPackageID")]

  Package ID of the image applied to the target computer. This property is required if InstallPackageID is not set. For more information, see the Remarks section later in this topic.

• InstallEditionIndex
  Data type: UInt32

  Access type: Read/Write

  Qualifiers: [RequiredIfNotNull("InstallPackageID"), VariableName("OSDInstallEditionIndex")]

  The edition index for a scripted installation, reflected in the WIM file applied to the target computer. The default value is 0. This property is required if InstallPackageID is set. For more information, see the Remarks section later in this topic.

  The task sequence variable associated with this property is OSDInstallEditionIndex, which indicates if the installation is for a pre-Windows Vista operating system or a Windows Vista operating system. For more information, see the MSDN documentation for Operating System Deployment Task Sequence Variables.

• InstallPackageID
  Data type: String

  Access type: Read/Write

  Qualifiers: [CommandLineArg(3), TaskSequencePackage("image"), RequiredIfNull("ImagePackageID")]

  Package ID of the scripted operating system install package to install on the target computer. For more information, see the Remarks section later in this topic.

• Name
  Data type: String

  Access type: Read/Write

  Qualifiers: [AllowedLen("1-100")]

  See SMS_TaskSequence_Action Server WMI Class.

• SupportedEnvironment
  Data type: String

  Access type: Read/Write

  Qualifiers: [Not_Null:ToInstance]

  See SMS_TaskSequence_Action Server WMI Class.

  The default value of this property for this task sequence action is WinPE.

• Timeout
  Data type: UInt32

  Access type: Read/Write

  Qualifiers: None

  See SMS_TaskSequence_Action Server WMI Class.

Remarks

Class qualifiers for this class include:

[CommandLine("OSDApplyOS.exe<?1: /image:%1,%%OSDImageIndex%%><?3: /install:%3,%%OSDInstallEditionIndex%%><?4: \"/config:%4,%%OSDConfigFileName%%\"><?6: /target:%6,%7><?8: /target:%8><?9: /target:%%%9%%>"),

ActionCategory{"Images,1,4"},ActionUI{"AdminUI.TaskSequenceEditor.dll", "Microsoft.ConfigurationManagement.AdminConsole.TaskSequenceEditor", "ApplyOperatingSystemControl","TaskSequenceOptionControl"},SequenceCategory("OSD")]

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

The following properties can be set for the target of this task sequence action:

• DestinationDisk

• DestinationPartition

• DestinationLogicalDrive

• DestinationVariable

To install to a specific disk or partition, set DestinationDisk and DestinationPartition and set the other destination properties to null.

To install to a logical volume, such as c:\, set DestinationLogicalDrive and set the other properties to null.

DestinationVariable can be set to a task sequence variable that contains the destination in the form of "1,1" to target disk 1, partition 1, or contains "c:" to target a logical volume.

Set all the destination properties to null, to use the "next available" formatted volume as the target.

The following properties are specific to a particular type of installation:

• The ImagePackageID and ImageIndex properties are used for an image-based installation.

• The InstallPackageID and InstallEditionIndex properties are used for a scripted installation.

• The ConfigFilePackage and ConfigFileName properties are used for installation from a configuration file.

The InstallEditionIndex property is set by the SMS_TaskSequence_ApplyOperatingSystemAction class. It is retrieved by SMS_TaskSequence_SetupWindowsAndSMSAction Server WMI Class.

Note

The value supplied for the ImageIndex property can be problematic if your application has to range-check the property against a maximum value that is greater than 0x7fffffff (2147483647). In this case, your application cannot use the range qualifier on the property.

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_TaskSequence_SetupWindowsAndSMSAction Server WMI Class
About Operating System Deployment Task Sequences
Configuration Manager Operating System Deployment
How to Create an Operating System Deployment Task Sequence
How to Add an Operating System Deployment Task Sequence Action