SMS_TaskSequence_ApplyOperatingSystemAction Server WMI Class
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.
Syntax
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;
Boolean RunFromNet;
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 OS 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 OS 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.
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.
RunFromNet
Data type: Boolean
Access type: Read/Write
Qualifiers: [RunFromNet, CommandLineArg(10)]
true
if the operating system WIM image will be applied directly from a network share instead of being downloaded first. This requires that the image package be made available on a share on the distribution point. The default value is false
.
This information applies to System Center 2012 Configuration Manager SP1 or later, and System Center 2012 R2 Configuration Manager or later.
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,5"},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
andDestinationPartition
and set the other destination properties tonull
.To install to a logical volume, such as c:\, set
DestinationLogicalDrive
and set the other properties tonull
.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
andImageIndex
properties are used for an image-based installation.The
InstallPackageID
andInstallEditionIndex
properties are used for a scripted installation.The
ConfigFilePackage
andConfigFileName
properties are used for installation from a configuration file.The
InstallEditionIndex
property is set by theSMS_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.