The following sections describe task sequence action variables (action variables) and task sequence built-in variables (built-in variables). The following lists display Configuration Manager 2007 task sequence variables and describe how you can use them to control and customize a task sequence. Task sequence variables supply configuration settings for computer, operating system, and user state configuration tasks that are performed on a Configuration Manager 2007 computer. Task sequence variables provide a mechanism to configure and customize individual task sequence steps within a task sequence. For more information about task sequence variables, see About Task Sequence Variables.
When a computer runs a task sequence, the task sequence environment is initialized by using general configuration settings. As individual task sequence steps are run within the task sequence, settings specific to the current task sequence action are added to the task sequence environment. After each task sequence step is completed, any settings specific to the task sequence step are removed from the task sequence environment.
Using action variables, you can change the associated default values of a task sequence to customize how the task sequence step will be run on a target computer.
 Note |
|---|
| Task sequence variables with names that begin with an underscore (_) character are read-only. You can access the values associated with read-only task sequence variables; however, you cannot change the associated values. |
Task Sequence Action Variables
Task sequence action variables (action variables) specify configuration properties for a particular task sequence step. By default, the task sequence step settings are initialized and available only when the associated task sequence step is run. In other words, the task sequence variable setting is added to the task sequence environment before the task sequence step is run, and the value is removed after the task sequence step has run.
For example, by using the task sequence editor to specify a start-in directory for a command-line action, specify the Start In property value in the Run Command Line task sequence step. The default value specified is stored in the task sequence environment as the WorkingDirectory variable, which is specific to the Run Command Line task sequence action. The WorkingDirectory environment variable is initialized before the Run Command Line task sequence action is run. During the Run Command Line step, the specified directory value can be accessed through the environment variable named WorkingDirectory. After the task sequence step is completed, the variable is removed from the task sequence environment. If the sequence contains another Run Command Line task sequence step, the new WorkingDirectory variable is initialized and set to the starting value for that task sequence.
Whereas the default value for a task sequence action setting is present while the task sequence step is run, any new value that you set can be used by multiple steps in the sequence. If you use one of the task sequence variable creation methods to override a built-in variable value, the new value remains in the environment and overrides the default value for other steps in the task sequence. In the previous example, if a Set Task Sequence Variable step is added as the first step of the task sequence and sets the WorkingDirectory environment variable to the value C:\, both Run Command Line steps in the task sequence will use the new starting directory value.
Configuration Manager 2007 task sequence variables are grouped by their associated task sequence action:
- Run Command
Line Task Sequence Action Variables
- Restart
Computer Task Sequence Action Variables
- Install
Software Updates Task Sequence Action Variables
- Apply
Operating System Task Sequence Action Variables
- Apply Data
Image Task Sequence Action Variables
- Setup
Windows and ConfigMgr Task Sequence Action Variables
- Capture
Operating System Image Task Sequence Action Variables
- Capture
Network Settings Task Sequence Action Variables
- Apply
Network Settings Task Sequence Action Variables
- Prepare
Windows for Capture Task Sequence Action Variables
- Capture User
State Task Sequence Action Variables
- Restore User
State Task Sequence Action Variables
- Request
State Store Task Sequence Action Variables
- Format and
Partition Disk Task Sequence Action Variables
- Convert Disk
to Dynamic Task Sequence Action Variables
- Connect to
Network Folder Task Sequence Action Variables
- Join Domain
or Workgroup Task Sequence Action Variables
- Capture
Windows Settings Task Sequence Action Variables
- Apply
Windows Settings Task Sequence Action Variables
- Auto Apply
Drivers Task Sequence Action Variables
- Apply Driver
Package Task Sequence Action Variables
- Enable
BitLocker Task Sequence Action Variables
Task Sequence Built-in Variables
Task sequence built-in variables (built-in variables) are produced by the underlying task sequence engine, and their associated values are generally read-only. Built-in variables provide information about the environment where the associated task sequence is running. The values associated with a built-in variable are available in the task sequence environment throughout the whole task sequence. Typically, built-in variables are initialized before any task sequence steps are run in the task sequence. For example, the built-in variable _SMSTSLogPath specifies the path that Configuration Manager 2007 components use to write log files while the task sequence runs; any task sequence step can access this environment variable.
The following list describes the Configuration Manager 2007 built-in variables available for use within a Configuration Manager 2007 task sequence:
| Built-in Variable Name | Description |
|---|---|
|
_SMSTSAdvertID |
Stores the current running task sequence advertisement ID. It uses the same format as a Configuration Manager 2007 software distribution advertisement ID. If the task sequence is running from stand-alone media, this variable is undefined. Example: ABC20001 |
|
_SMSTSBootImageID |
Stores the Configuration Manager 2007 boot image package ID if a boot image package is associated with the current running task sequence. The variable will not be set if no Configuration Manager 2007 boot image package is associated. Example: ABC00001 |
|
_SMSTSClientGUID |
Stores the value of Configuration Manager 2007 client GUID. This variable is not set if the task sequence is running from stand-alone media. Example: 0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c |
|
_SMSTSCurrentActionName |
Specifies the name of the currently running task sequence step. This variable will be set before the task sequence manager runs each individual step. Example: run command line |
|
_SMSTSDownloadOnDemand |
Set to true if the current task sequence is running in download-on-demand mode, which means the task sequence manager downloads content locally only when it must access the content. |
|
_SMSTSInWinPE |
This variable is set to true when the current task sequence step is running in the Windows PE environment, and it is set to false if not. You can test this task sequence variable to determine the current operating system environment. |
|
_SMSTSLastActionRetCode |
Stores the return code returned by the last action that was run. Example: 0 |
|
_SMSTSLastActionSucceeded |
The variable is set to true if the last action succeeded and to false if the last action failed. If the last action was skipped because the step was disabled or the associated condition evaluated to false, this variable is not reset, which means it still holds the value for the previous action. |
|
_SMSTSLaunchMode |
Specifies the task sequence launch method. The task sequence can have the following values:
|
|
_SMSTSLogPath |
Stores the full path of the log directory. This can be used to determine where actions should be logged. This value is not set when no hard drive is available. |
|
_SMSTSMachineName |
Stores and specifies the computer name. Stores the name of the computer that the task sequence will use to log all status messages. To change the computer name in the new operating system, use the OSDComputerName variable. Example: ABC |
|
_SMSTSMediaType |
Specifies the type of media that will be used to initiate the installation. Examples of types of media are Boot Media, Full Media, PXE, and Prestaged Media. |
|
_SMSTSMP |
Stores the name or IP address of a Configuration Manager 2007 management point. |
|
_SMSTSMPPort |
Stores the management point port number of a Configuration Manager 2007 management point. Example: 80 |
|
_SMSTSOrgName |
Stores the branding title name, which will be displayed in a task sequence progress user interface dialog box. Example: XYZ Organization |
|
_SMSTSPackageID |
Stores the current running task sequence ID. This ID uses the same format as a Configuration Manager 2007 software package ID. Example: HJT00001 |
|
_SMSTSPackageName |
Stores the current running task sequence name specified by the Configuration Manager 2007 administrator when the task sequence is created. Example: Deploy xpsp2 task sequence |
|
_SMSTSRunFromDP |
Set to true if the current task sequence is running in run-from-distribution-point mode, which means the task sequence manager obtains required packages from distribution point shares. |
|
_SMSTSSiteCode |
Stores the site code of the Configuration Manager 2007 site. Example: ABC |
|
_SMSTSType |
Specifies the type of the current running task sequence. It can have the following values: 1 - indicates a generic task sequence. 2 - indicates an operating system deployment task sequence. |
|
_SMSTSTimezone |
The _SMSTSTimezone variable stores the time zone information in the following format (without spaces): Bias, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName Example For the Eastern Time U.S. and Canada, the value would be 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Eastern Standard Time,Eastern Daylight Time |
|
_SMSTSUseCRL |
Specifies whether the task sequence uses the certificate revocation list when it uses a Secure Socket Layer (SSL) certificate to communicate with the management point. |
|
_SMSTSUserStarted |
Specifies whether a task sequence is started by a user. This variable will only be set if the task sequence is started from the Configuration Manager 2007 client. For example, if _SMSTSLaunchMode is set to SMS. The variable can have the following values:
|
|
_SMSTSUseSSL |
Specifies whether the task sequence uses SSL to communicate with the Configuration Manager 2007 management point. If your site is running in native mode, the value is set to true. |
|
SMSTSErrorDialogTimeout |
When an error occurs in a task sequence, a dialog box is displayed that is dismissed automatically after a default time-out value. Use this variable to specify a time-out value in seconds other than the default of 15 minutes. |
|
SMSTSRebootDelay |
Specifies how many seconds to wait before the computer restarts. The task sequence manager will display a notification dialog before reboot if this variable is not set to 0. Examples: 0 30 |
|
SMSTSRebootMessage |
Specifies the message to display in the shutdown dialog box when a reboot is requested. If this variable is not set, a default message will appear. Example: This computer is being rebooted by the task sequence manager. |
|
SMSTSRebootRequested |
Indicates that a reboot is requested after the current task sequence step is completed. If a reboot is required, just set this variable to true, and the task sequence manager will restart the computer after this task sequence step. The task sequence step must set this task sequence variable if it requires a reboot to complete the task sequence step. After the computer is rebooted, the task sequence will continue to run from the next task sequence step. |
|
SMSTSLocalDataDrive |
Specifies where temporary files are stored on the destination computer while the task sequence is running. |
|
SMSTSRetryRequested |
Requests a retry after the current task sequence step is completed. If this task sequence variable is set, the SMSTSRebootRequested must also be set to true. After the computer is restarted, the task sequence manager will rerun the same task sequence step. |