Ps Version
Ps Version
Toolkit 2012
Toolkit Reference
Contents
Introduction to Toolkit Reference ................................................................................................1
Feedback .............................................................................................................................1
Task Sequence Steps.................................................................................................................2
Common Properties and Options for Task Sequence Step Types ......................................2
Common Options .........................................................................................................3
Specific Properties and Settings for Task Sequence Step Types ........................................5
Apply Network Settings ................................................................................................5
Authorize DHCP ...........................................................................................................6
Capture Network Settings.............................................................................................7
Configure ADDS ...........................................................................................................7
Configure DHCP ...........................................................................................................9
Configure DNS ...........................................................................................................11
Enable BitLocker ........................................................................................................13
Format and Partition Disk ...........................................................................................13
Gather ........................................................................................................................14
Inject Drivers ..............................................................................................................15
Install Application .......................................................................................................15
Install Operating System ............................................................................................16
Install Roles and Features ..........................................................................................17
Install Language Packs Offline ...................................................................................17
Install Language Packs Online ...................................................................................18
Install Updates Offline ................................................................................................18
Recover from Domain Join Failure .............................................................................19
Restart computer ........................................................................................................19
Run Command Line ...................................................................................................20
Run PowerShell Script................................................................................................20
Set Task Sequence Variable ......................................................................................21
Validate ......................................................................................................................22
Out-of-Box Task Sequence Steps .....................................................................................22
Inject Drivers ..............................................................................................................23
Apply Network Settings ..............................................................................................23
Apply Patches ............................................................................................................24
Apply Windows PE (Vista) ..........................................................................................25
Apply Windows PE (XP) .............................................................................................26
Backup .......................................................................................................................27
Capture Groups ..........................................................................................................27
Capture User State .....................................................................................................28
Check BIOS................................................................................................................29
Configure ....................................................................................................................30
Copy Scripts ...............................................................................................................31
Copy Sysprep Files ....................................................................................................31
Create BitLocker Partition...........................................................................................32
Create WIM ................................................................................................................33
Disable BDE Protectors ..............................................................................................34
BDEDriveSize .............................................................................................................68
BDEInstall...................................................................................................................68
BDEInstallSuppress ...................................................................................................69
BDEKeyLocation ........................................................................................................70
BDEPin .......................................................................................................................71
BDERecoveryKey .......................................................................................................71
BDEWaitForEncryption...............................................................................................72
BitsPerPel...................................................................................................................73
BuildID ........................................................................................................................73
CapableArchitecture ...................................................................................................74
CaptureGroups ...........................................................................................................75
ChildName..................................................................................................................75
ComputerBackupLocation ..........................................................................................76
ComputerName ..........................................................................................................77
ConfigFileName..........................................................................................................77
ConfigFilePackage .....................................................................................................78
ConfirmGC .................................................................................................................78
CountryCode ..............................................................................................................79
CriticalReplicationOnly ...............................................................................................79
CustomDriverSelectionProfile.....................................................................................80
CustomPackageSelectionProfile ................................................................................80
CustomWizardSelectionProfile ...................................................................................81
Database ....................................................................................................................81
DatabasePath.............................................................................................................82
DBID ...........................................................................................................................83
DBPwd .......................................................................................................................84
Debug .........................................................................................................................85
DefaultGateway ..........................................................................................................85
DeployDrive ................................................................................................................86
DeploymentMethod ....................................................................................................87
DeploymentType ........................................................................................................88
DeployRoot.................................................................................................................88
DestinationDisk ..........................................................................................................89
DestinationLogicalDrive ..............................................................................................90
DestinationPartition ....................................................................................................91
DHCPScopes .............................................................................................................91
DHCPScopesxDescription..........................................................................................92
DHCPScopesxEndIP ..................................................................................................92
DHCPScopesxExcludeEndIP .....................................................................................93
DHCPScopesxExcludeStartIP ....................................................................................93
DHCPScopesxIP ........................................................................................................94
DHCPScopesxName ..................................................................................................94
DHCPScopesxOptionDNSDomainName....................................................................95
DHCPScopesxOptionDNSServer ...............................................................................96
DHCPScopesxOptionLease .......................................................................................96
DHCPScopesxOptionNBTNodeType .........................................................................97
DHCPScopesxOptionPXEClient .................................................................................97
DHCPScopesxOptionRouter ......................................................................................98
DHCPScopesxOptionWINSServer .............................................................................98
DHCPScopesxStartIP.................................................................................................99
DHCPScopesxSubnetMask........................................................................................99
DHCPServerOptionDNSDomainName .....................................................................100
DHCPServerOptionDNSServer ................................................................................100
DHCPServerOptionNBTNodeType ..........................................................................101
DHCPServerOptionPXEClient ..................................................................................102
DHCPServerOptionRouter .......................................................................................102
DHCPServerOptionWINSServer ..............................................................................103
Dialing ......................................................................................................................103
DisableTaskMgr .......................................................................................................104
DNSServerOptionBINDSecondaries ........................................................................104
DNSServerOptionDisableRecursion .........................................................................105
DNSServerOptionEnableNetmaskOrdering..............................................................106
DNSServerOptionEnableRoundRobin ......................................................................106
DNSServerOptionEnableSecureCache ....................................................................107
DNSServerOptionFailOnLoad ..................................................................................108
DNSServerOptionNameCheckFlag ..........................................................................108
DNSZones ................................................................................................................109
DNSZonesxDirectoryPartition...................................................................................110
DNSZonesxFileName ...............................................................................................110
DNSZonesxMasterIP ................................................................................................111
DNSZonesxName ....................................................................................................111
DNSZonesxScavenge ..............................................................................................112
DNSZonesxType ......................................................................................................113
DNSZonesxUpdate ..................................................................................................113
DoCapture ................................................................................................................114
DomainAdmin ...........................................................................................................115
DomainAdminDomain ..............................................................................................116
DomainAdminPassword ...........................................................................................116
DomainLevel ............................................................................................................117
DomainNetBiosName ...............................................................................................117
DomainOUs ..............................................................................................................118
DoNotCreateExtraPartition .......................................................................................119
DriverGroup ..............................................................................................................119
DriverInjectionMode .................................................................................................120
DriverPaths...............................................................................................................121
DriverSelectionProfile ...............................................................................................122
EventShare...............................................................................................................122
FinishAction ..............................................................................................................123
ForceApplyFallback ..................................................................................................123
ForestLevel...............................................................................................................124
FullName ..................................................................................................................125
GPOPackPath ..........................................................................................................126
Groups......................................................................................................................127
HALName .................................................................................................................128
HideShell ..................................................................................................................128
OSHome_Page ........................................................................................................129
HostName ................................................................................................................129
ImagePackageID ......................................................................................................130
InputLocale ...............................................................................................................130
InstallPackageID ......................................................................................................131
Instance ....................................................................................................................131
IPAddress .................................................................................................................132
IsDesktop .................................................................................................................133
IsHypervisorRunning ................................................................................................133
IsLaptop....................................................................................................................134
IsServer ....................................................................................................................134
IsServerCoreOS .......................................................................................................135
IsServerOS ...............................................................................................................135
IsUEFI ......................................................................................................................136
IsVM .........................................................................................................................137
JoinDomain ..............................................................................................................137
JoinWorkgroup .........................................................................................................138
KeyboardLocale .......................................................................................................138
KeyboardLocalePE ...................................................................................................139
LanguagePacks ........................................................................................................140
LoadStateArgs..........................................................................................................141
Location ....................................................................................................................142
LongDistanceAccess ................................................................................................143
MACAddress ............................................................................................................144
MachineObjectOU ....................................................................................................145
Make.........................................................................................................................146
MandatoryApplications .............................................................................................146
Memory ....................................................................................................................147
Model........................................................................................................................148
NetLib .......................................................................................................................148
NewDomain ..............................................................................................................149
NewDomainDNSName .............................................................................................150
Order ........................................................................................................................150
OrgName ..................................................................................................................151
OSArchitecture .........................................................................................................152
OSCurrentBuild ........................................................................................................153
OSCurrentVersion ....................................................................................................153
OSDAdapterxDescription .........................................................................................154
OSDAdapterxDNSDomain .......................................................................................154
OSDAdapterxDNSServerList....................................................................................155
OSDAdapterxDNSSuffix ...........................................................................................155
OSDAdapterxEnableDHCP ......................................................................................156
OSDAdapterxEnableDNSRegistration .....................................................................156
OSDAdapterxEnableFullDNSRegistration ................................................................157
OSDAdapterxEnableLMHosts ..................................................................................158
OSDAdapterxEnableIPProtocolFiltering ...................................................................158
OSDAdapterxEnableTCPFiltering ............................................................................159
OSDAdapterxEnableTCPIPFiltering .........................................................................159
OSDAdapterxEnableWINS .......................................................................................160
OSDAdapterxGatewayCostMetric ............................................................................161
OSDAdapterxGateways ...........................................................................................161
OSDAdapterxIPAddressList .....................................................................................162
OSDAdapterxIPProtocolFilterList .............................................................................162
OSDAdapterxMacAddress .......................................................................................163
OSDAdapterxName ..................................................................................................163
OSDAdapterxSubnetMask .......................................................................................164
OSDAdapterxTCPFilterPortList ................................................................................165
OSDAdapterxTCPIPNetBiosOptions ........................................................................165
OSDAdapterxUDPFilterPortList ................................................................................166
OSDAdapterxWINSServerList ..................................................................................166
OSDAdapterCount ...................................................................................................167
OSDAnswerFilePath ................................................................................................168
OSDBitLockerCreateRecoveryPassword .................................................................168
OSDBitLockerMode ..................................................................................................169
OSDBitLockerRecoveryPassword ............................................................................170
OSDBitLockerStartupKey .........................................................................................171
OSDBitLockerStartupKeyDrive .................................................................................171
OSDBitLockerTargetDrive ........................................................................................172
OSDBitLockerWaitForEncryption .............................................................................173
OSDComputerName ................................................................................................173
OSDDiskAlign...........................................................................................................174
OSDDiskIndex ..........................................................................................................175
OSDDiskOffset .........................................................................................................175
OSDDiskPartBiosCompatibilityMode ........................................................................176
OSDImageCreator ....................................................................................................176
OSDImageIndex .......................................................................................................177
OSDImagePackageID ..............................................................................................177
OSDInstallEditionIndex.............................................................................................178
OSDInstallType ........................................................................................................178
OSDisk .....................................................................................................................179
OSDPartitions...........................................................................................................179
OSDPartitionsxBootable ...........................................................................................180
OSDPartitionsxFileSystem .......................................................................................180
OSDPartitionsxQuickFormat ....................................................................................181
OSDPartitionsxSize ..................................................................................................182
OSDPartitionsxSizeUnits ..........................................................................................182
OSDPartitionsxType .................................................................................................183
OSDPartitionsxVolumeLetterVariable ......................................................................183
OSDPartitionsxVolumeName ...................................................................................184
OSDStateStorePath .................................................................................................184
OSDTargetSystemDrive ...........................................................................................185
OSDTargetSystemRoot ............................................................................................186
OSFeatures ..............................................................................................................186
OSInstall ...................................................................................................................187
OSRoles ...................................................................................................................188
OSRoleServices .......................................................................................................197
OSSKU .....................................................................................................................197
OSVersion ................................................................................................................198
OSVersionNumber ...................................................................................................198
OverrideProductKey .................................................................................................199
PackageGroup .........................................................................................................200
Packages..................................................................................................................200
PackageSelectionProfile...........................................................................................201
Parameters ...............................................................................................................201
ParameterCondition .................................................................................................202
ParentDomainDNSName .........................................................................................203
Password..................................................................................................................204
Phase .......................................................................................................................204
Port ...........................................................................................................................205
PowerUsers ..............................................................................................................206
PrepareWinRE .........................................................................................................206
Priority ......................................................................................................................207
ProcessorSpeed .......................................................................................................208
Product .....................................................................................................................208
ProductKey ...............................................................................................................209
Properties .................................................................................................................210
ReplicaDomainDNSName ........................................................................................210
ReplicaOrNewDomain ..............................................................................................211
ReplicationSourceDC ...............................................................................................212
ResourceDrive..........................................................................................................212
ResourceRoot ..........................................................................................................213
Role ..........................................................................................................................213
SafeModeAdminPassword .......................................................................................215
ScanStateArgs .........................................................................................................215
SerialNumber ...........................................................................................................216
SiteName..................................................................................................................217
SkipAdminAccounts .................................................................................................217
SkipAdminPassword ................................................................................................218
SkipApplications .......................................................................................................219
SkipBDDWelcome ....................................................................................................220
SkipBitLocker ...........................................................................................................221
SkipBuild ..................................................................................................................222
SkipCapture..............................................................................................................223
SkipComputerBackup ...............................................................................................224
SkipComputerName .................................................................................................225
SkipDomainMembership ..........................................................................................226
SkipFinalSummary ...................................................................................................226
SkipGroupSubFolders ..............................................................................................227
SkipLocaleSelection .................................................................................................228
SkipPackageDisplay .................................................................................................229
SkipProductKey ........................................................................................................230
SkipSummary ...........................................................................................................231
SkipTaskSequence ..................................................................................................232
SkipTimeZone ..........................................................................................................233
SkipUserData ...........................................................................................................234
SkipWizard ...............................................................................................................234
SLShare ...................................................................................................................235
SLShareDynamicLogging .........................................................................................236
SMSTSAssignUserMode ..........................................................................................237
SMSTSRunCommandLineUserName ......................................................................237
SMSTSRunCommandLineUserPassword ................................................................238
SMSTSUdaUsers .....................................................................................................238
SQLServer................................................................................................................239
SQLShare.................................................................................................................240
StorageDriverGroup .................................................................................................241
StorageDriverSysprepGroup ....................................................................................241
StoredProcedure ......................................................................................................242
SupportsHyperVRole ................................................................................................243
SysPrepDriverSelectionProfile .................................................................................246
SystemLocale ...........................................................................................................247
SysVolPath ...............................................................................................................247
Table ........................................................................................................................248
TaskSequenceID ......................................................................................................249
TaskSequenceName ................................................................................................249
TaskSequenceVersion .............................................................................................250
TimeZone .................................................................................................................250
TimeZoneName........................................................................................................251
TPMOwnerPassword ...............................................................................................252
UDDir........................................................................................................................253
UDProfiles ................................................................................................................254
UDShare...................................................................................................................255
UILanguage ..............................................................................................................255
UserDataLocation .....................................................................................................256
UserDomain .............................................................................................................257
UserID ......................................................................................................................258
UserLocale ...............................................................................................................258
UserPassword ..........................................................................................................259
USMT3 .....................................................................................................................260
USMTConfigFile .......................................................................................................261
USMTMigFiles ..........................................................................................................262
UUID.........................................................................................................................263
ValidateDomainCredentialsUNC ..............................................................................263
VHDCreateDiffVHD ..................................................................................................264
VHDCreateFileName ................................................................................................265
VHDCreateSizeMax .................................................................................................266
VHDCreateSource ....................................................................................................267
VHDCreateType .......................................................................................................268
VHDDisks .................................................................................................................270
VHDInputVariable .....................................................................................................271
VHDOutputVariable ..................................................................................................272
VHDTargetDisk ........................................................................................................273
VMHost.....................................................................................................................274
VMName ..................................................................................................................274
VMPlatform...............................................................................................................275
VRefresh ..................................................................................................................276
VSSMaxSize ............................................................................................................277
WDSServer ..............................................................................................................278
WipeDisk ..................................................................................................................278
WizardSelectionProfile .............................................................................................279
WSUSServer ............................................................................................................280
WUMU_ExcludeKB ..................................................................................................280
WUMU_ExcludeID ...................................................................................................281
XResolution ..............................................................................................................282
YResolution ..............................................................................................................282
Providing Properties for Skipped Windows Deployment Wizard Pages ..........................283
UDI Task Sequence Variables.........................................................................................285
OSDAddAdmin .........................................................................................................286
OSDApplicationList ..................................................................................................286
OSDArchitecture ......................................................................................................286
OSDBitlockerStatus ..................................................................................................287
OSDDiskPart ............................................................................................................287
OSDDomainName ....................................................................................................287
OSDDomainOUName ..............................................................................................288
OSDImageIndex .......................................................................................................288
OSDJoinAccount ......................................................................................................288
OSDJoinPassword ...................................................................................................289
OSDLocalAdminPassword .......................................................................................289
OSDNetworkJoinType ..............................................................................................289
OSDSetupWizCancelled ..........................................................................................290
OSDTargetDrive .......................................................................................................290
OSDWinPEWinDir ....................................................................................................291
OSDWorkgroupName...............................................................................................291
OSDResults.exe.config File Element Values ...................................................................291
backgroundOpacity ..................................................................................................291
backgroundWallpaper ..............................................................................................292
completedText ..........................................................................................................292
headerImagePath .....................................................................................................292
timeoutMinutes .........................................................................................................293
welcomeText ............................................................................................................293
Scripts.....................................................................................................................................294
BDD_Autorun.wsf ............................................................................................................294
BDD_Welcome_ENU.xml ................................................................................................295
Credentials_ENU.xml ......................................................................................................296
Credentials_scripts.vbs ...................................................................................................297
DeployWiz_Definition_ENU.xml ......................................................................................297
DeployWiz_Initialization.vbs ............................................................................................300
DeployWiz_Validation.vbs ...............................................................................................302
LiteTouch.vbs ..................................................................................................................303
LiteTouch.wsf ..................................................................................................................304
LTIApply.wsf ....................................................................................................................308
LTICleanup.wsf................................................................................................................309
LTICopyScripts.wsf..........................................................................................................311
LTIGetFolder.wsf .............................................................................................................311
LTIOEM.wsf .....................................................................................................................312
LTISuspend.wsf ...............................................................................................................314
LTISysprep.wsf ................................................................................................................315
NICSettings_Definition_ENU.xml ....................................................................................316
Summary_Definition_ENU.xml ........................................................................................317
Summary_scripts.vbs ......................................................................................................318
Wizard.hta .......................................................................................................................318
WizUtility.vbs ...................................................................................................................320
ZTIApplications.wsf .........................................................................................................321
ZTIAppXmlGen.wsf .........................................................................................................322
ZTIAuthorizeDHCP.wsf ...................................................................................................323
ZTIBackup.wsf .................................................................................................................325
ZTIBCDUtility.vbs ............................................................................................................326
ZTIBde.wsf ......................................................................................................................327
ZTIBIOSCheck.wsf ..........................................................................................................329
ZTICoalesce.wsf ..............................................................................................................330
ZTIConfigFile.vbs ............................................................................................................332
ZTIConfigure.wsf .............................................................................................................332
ZTIConfigureADDS.wsf ...................................................................................................334
ZTIConfigureDHCP.wsf ...................................................................................................335
ZTIConfigureDNS.wsf ......................................................................................................337
ZTIConnect.wsf ...............................................................................................................338
ZTICopyLogs.wsf.............................................................................................................339
ZTIDataAccess.vbs .........................................................................................................340
ZTIDisableBDEProtectors.wsf .........................................................................................341
ZTIDiskpart.wsf................................................................................................................342
ZTIDiskUtility.vbs .............................................................................................................344
ZTIDomainJoin.wsf ..........................................................................................................345
ZTIDrivers.wsf .................................................................................................................346
ZTIGather.wsf ..................................................................................................................348
ZTIGroups.wsf .................................................................................................................350
ZTILangPacksOnline.wsf .................................................................................................351
ZTIMoveStateStore.wsf ...................................................................................................352
ZTINextPhase.wsf ...........................................................................................................353
ZTINICConfig.wsf ............................................................................................................354
ZTINICUtility.vbs..............................................................................................................356
ZTIOSRole.wsf ................................................................................................................356
ZTIPatches.wsf ................................................................................................................358
ZTIPowerShell.wsf ...........................................................................................................359
ZTIPrereq.vbs ..................................................................................................................360
ZTISCCM.wsf ..................................................................................................................361
ZTISetVariable.wsf ..........................................................................................................363
ZTITatoo.wsf....................................................................................................................363
ZTIUserState.wsf .............................................................................................................365
ZTIUtility.vbs ....................................................................................................................367
ZTIValidate.wsf ................................................................................................................370
ZTIVHDCreate.wsf ..........................................................................................................372
ZTIWindowsUpdate.wsf ...................................................................................................373
ZTIWipeDisk.wsf..............................................................................................................378
Support Files ..........................................................................................................................380
ApplicationGroups.xml .....................................................................................................380
Applications.xml...............................................................................................................380
BootStrap.ini ....................................................................................................................380
CustomSettings.ini...........................................................................................................381
Deploy.xml .......................................................................................................................381
DriverGroups.xml.............................................................................................................381
Drivers.xml.......................................................................................................................381
LinkedDeploymentShares.xml .........................................................................................381
ListOfLanguages.xml .......................................................................................................381
MediaGroups.xml ............................................................................................................382
Medias.xml ......................................................................................................................382
OperatingSystemGroups.xml...........................................................................................382
OperatingSystems.xml ....................................................................................................382
PackageGroups.xml ........................................................................................................382
Packages.xml ..................................................................................................................383
SelectionProfileGroups.xml .............................................................................................383
SelectionProfiles.xml .......................................................................................................383
ServerManager.xml .........................................................................................................383
Settings.xml .....................................................................................................................383
TaskSequenceGroups.xml ..............................................................................................383
TaskSequences.xml ........................................................................................................384
TS.xml .............................................................................................................................384
Wimscript.ini ....................................................................................................................384
ZTIBIOSCheck.xml ..........................................................................................................384
ZTIConfigure.xml .............................................................................................................385
ZTIGather.xml..................................................................................................................385
ZTITatoo.mof ...................................................................................................................385
Utilities ....................................................................................................................................387
BCDBoot.exe ...................................................................................................................387
BDDRun.exe....................................................................................................................388
Bootsect.exe ....................................................................................................................388
Compact.exe ...................................................................................................................389
Diskpart.exe.....................................................................................................................390
Expand.exe......................................................................................................................390
ImageX.exe .....................................................................................................................391
Intlcfg.exe ........................................................................................................................391
Microsoft.BDD.PnpEnum.exe ..........................................................................................392
Mofcomp.exe ...................................................................................................................392
Netsh.exe ........................................................................................................................392
Reg.exe ...........................................................................................................................393
Regsvr32.exe ..................................................................................................................393
Wdsmcast.exe .................................................................................................................393
Wpeutil.exe ......................................................................................................................394
Tables and Views in the MDT DB ...........................................................................................395
Tables in the MDT DB .....................................................................................................395
Views in the MDT DB ......................................................................................................397
UDI Reference ........................................................................................................................400
UDI Concepts ..................................................................................................................400
Display Name ...........................................................................................................400
Flow ..........................................................................................................................400
Page Library .............................................................................................................400
Page Name ..............................................................................................................401
Prestaged Media Deployments ................................................................................401
Stage Group .............................................................................................................401
Stage ........................................................................................................................401
Task .........................................................................................................................402
UDI Task Sequence .................................................................................................402
UDI Wizard ...............................................................................................................403
UDI Wizard Application Configuration File................................................................404
UDI Wizard Configuration File ..................................................................................404
UDI Wizard Designer ................................................................................................404
Validator ...................................................................................................................405
Wizard Page .............................................................................................................405
Wizard Page Editor ..................................................................................................405
OSDResults Reference ...................................................................................................406
User-Centric App Installer Reference ..............................................................................408
UDI Stage Reference ......................................................................................................412
REFRESH Stage ......................................................................................................417
REPLACE and REPLACE.WinPE Stages ................................................................419
UDI Task Reference ........................................................................................................419
UDI Task Overview ..................................................................................................420
UDI Task Configuration Settings ..............................................................................420
Built-in UDI Tasks .....................................................................................................421
UDI Validator Reference ..................................................................................................425
UDI Validator Overview ............................................................................................425
Built-in UDI Validators ..............................................................................................425
UDI Wizard Page Reference ...........................................................................................426
UDI Wizard Page Overview ......................................................................................426
Built-in UDI Wizard Pages ........................................................................................428
Feedback
Microsoft Connect is a place for you to submit bugs and suggestions for
Microsoft products—including Microsoft Solution Accelerators—that Microsoft will
consider for future releases. When you join the site, you will be able to:
Find Microsoft products that are currently accepting feedback from the
community
Participate in feedback programs that Microsoft product teams manage
Download and test beta products
Submit bugs and suggestions for future releases of Microsoft products
Vote, comment on, and validate other people's feedback
To leave feedback on Microsoft Connect, perform the following steps:
1. Go to http://connect.microsoft.com.
2. Sign in using any valid Windows Live® ID.
3. At the top of the page, click Directory.
4. In the list, scroll down to Solution Accelerators Microsoft Deployment
Connection Program, and then click Join.
Approval is automatic.
5. In the navigation pane, click Feedback.
Please provide feedback on the usefulness of this guide by filling out the survey
at http://go.microsoft.com/fwlink/?LinkID=132579.
Common Properties
Table 1 shows the settings that are available on the Properties tab of each task
sequence step. For more information about the Properties tab for a particular
task sequence step, see the topic that corresponds to the step later in this
reference.
Note The task sequence step types listed here are those that are available in the Deployment
Workbench. Additional task sequence step types might be available when configuring task
sequences using Microsoft System Center 2012 Configuration Manager or System Center
Configuration Manager 2007 R3.
Common Options
Table 2 shows the settings that are available on the Options tab of a task
sequence step. For more information about the Options tab, see Task Sequence
Options Tab.
Table 2. Settings Available on the Options Tab
Properties
Name Value
Type Apply Network Settings
Settings
Name Value
Name The name to be assigned to the network connection.
Obtain an IP When selected, Dynamic Host Configuration Protocol
address (DHCP) is used to obtain the required Internet Protocol
automatically (IP) configuration settings for the network connection.
This is the default selection.
Use the following IP When selected, you can provide one or more IP address
address and subnet mask combinations in addition to gateways
that will be assigned to the network connection.
Obtain a Domain When selected, DHCP is used to obtain the required IP
Name System (DNS) configuration settings for the network connection. This is
server automatically the default selection.
Name Value
Use the following When selected, you can provide one or more DNS
DNS servers server IP addresses that will be assigned to the network
connection.
DNS Suffix The DNS suffix that will be applied to all network
connections that use TCP/IP.
Register this Specifies that the computer will attempt dynamic
connection’s registration of the IP addresses (through DNS) of this
address in DNS connection with the full computer name of this
computer.
Use this Specifies whether DNS dynamic update is used to
connection’s DNS register the IP addresses and the connection-specific
suffix in DNS domain name of this connection.
registration
WINS server You can provide one or more Windows Internet Naming
addresses Service (WINS) server IP addresses that will be
assigned to the network connection.
Enable LMHOSTS Specifies whether a local area network (LAN) Manager
lookup Hosts (LMHOSTS) file for network basic input/output
system (NetBIOS) name resolution is used.
Default Specifies whether this network connection obtains the
setting to enable or disable NetBIOS over TCP/IP
(NetBT) from a DHCP server. This is the default
selection.
Enable NetBIOS Specifies that this network connection uses NetBT and
over TCP/IP WINS.
Disable NetBIOS Specifies that this network connection does not use
over TCP/IP NetBT and WINS.
Authorize DHCP
This task sequence step authorizes the target computer as a DHCP server. For
more information about which script accomplishes this task and which properties
you use, see ZTIAuthorizeDHCP.wsf.
The unique properties and settings for the Authorize DHCP task sequence step
type are:
Properties
Name Description
Type Set this read-only type to Authorize DHCP Server.
Settings
Solution Accelerators microsoft.com/technet/SolutionAccelerators
Toolkit Reference: Task Sequence Steps 7
Name Description
Account A user account that is a member of the Enterprise
Admins group, to be used when authorizing DHCP for
the target computer.
Properties
Name Description
Type Set this read-only type to Capture Network Settings.
Settings
Name Description
None None
Configure ADDS
This task sequence step configures the target computer as an Active Directory®
Domain Services (AD DS) domain controller. For more information about the
settings listed in the following tables and which this task sequence step can
configure, see the Microsoft Help and Support article, Unattended promotion and
demotion of Windows 2000 and Windows Server 2003 domain controllers.
The unique properties and settings for the Configure ADDS task sequence step
type are:
Properties
Name Description
Type Set this read-only type to Configure ADDS.
Settings
Name Description
Create Specifies the configuration set that will be used to
configure the target computer. The configuration sets
are:
Name Description
New domain controller replica. Creates an
additional domain controller in an existing AD DS
domain
New read-only domain controller (RODC) replica.
Creates an RODC (Windows Server 2008 only)
New domain in existing forest. Creates a domain
in an existing AD DS forest
New domain tree in existing forest. Creates a new
tree in an existing AD DS forest
New forest. Creates a new AD DS forest
Domain DNS name The DNS name of the new or existing domain.
Domain NetBIOS The NetBIOS name of the new child domain, child
name domain tree, or forest that pre–AD DS clients use to
access the domain. This name must be unique on the
network.
DNS name The DNS name of the child domain or domain tree.
Replication source The name of the domain controller from which to source
domain controller AD DS on new replica or backup domain controller
upgrade installations. If no value is supplied, the closest
domain controller from the domain being replicated will
be selected by default.
Account The account to be used to perform the configuration.
Recovery (safe The password for the offline Administrator account that
mode) password is used in AD DS Repair mode.
Install DNS if not When selected, DNS will be installed if it has not already
already present been installed.
Make this domain Specifies whether the replica will also be a GC server.
controller a global When selected, the target computer will be configured
catalog (GC) server as a GC server if the replication source domain
controller is a GC server.
Wait for critical When selected, this setting specifies that only critical
replication only replication is sourced during the replication phase of
Dcpromo. Noncritical replication resumes when the
computer restarts as a domain controller.
Forest functional Specifies the functional level for a new forest. Available
level options are:
Windows Server 2003
Windows Server 2008
Windows Server 2008 R2
Name Description
Domain functional Specifies the functional level for a new domain.
level Available options are:
Windows Server 2003
Windows Server 2008
Windows Server 2008 R2
Database Fully qualified, non–Universal Naming Convention
(UNC) directory on a hard disk of the local computer
that will host the AD DS database (NTDS.dit). If the
directory exists, it must be empty. If it does not exist, it
will be created. Free disk space on the logical drive
selected must be 200 megabytes (MB) and possibly
larger when rounding errors are encountered and to
accommodate all objects in the domain. For best
performance, the directory should be located on a
dedicated hard disk.
Log files Fully qualified, non-UNC directory on a hard disk on the
local computer to host the AD DS log files. If the
directory exists, it must be empty. If it does not exist, it
will be created.
SYSVOL Fully qualified, non-UNC directory on a hard disk of the
local computer that will host the AD DS System Volume
(SYSVOL) files. If the directory exists, it must be empty.
If it does not exist, it will be created. The directory must
be located on a partition that is formatted with the NTFS
version 5.0 file system. For best performance, the
directory should be located on a different physical hard
disk than the operating system.
Site name The value of an existing AD DS site on which to locate
the new domain controller. If not specified, an
appropriate site will be selected. This option only applies
to the new tree in a new forest scenario. For all other
scenarios, a site will be selected using the current site
and subnet configuration of the forest.
Configure DHCP
This task sequence step configures the DHCP server service on the target
computer. For more information about which script accomplishes this task and
which properties you use, see ZTIConfigureDHCP.wsf.
The unique properties and settings for the Configure DHCP task sequence step
type are:
Properties
Name Description
Type Set this read-only type to Configure DHCP Server.
Settings
Name Description
Name Configure DHCP
Scope Details These options apply to any client computers that obtain
a lease within that particular scope. Configured scope
option values always apply to all computers obtaining a
lease in a given scope unless they are overridden by
options assigned to class or client reservation.
Within the Scope Details setting, the following sub-
settings are configurable:
Scope Name. A user-definable name
Start IP address. The starting IP address for the
scope
End IP address. The ending IP address for the
scope
Subnet mask. The subnet mask of the client subnet
Lease duration for DHCP clients. The duration that
the DHCP lease is valid for the client
Description. A description of the scope
Exclude IP address range, Start IP address. The
starting IP address for the range of IP addresses
that are to be excluded from the scope
Exclude IP address range, End IP address. The
ending IP address for the range of IP addresses that
are to be excluded from the scope
003 Router. A list of IP addresses for routers on the
client subnet
006 DNS Servers. A list of IP addresses for DNS
name servers available to the client
015 DNS Domain Name. The domain name that the
DHCP client should use when resolving unqualified
domain names with DNS
044 WINS/NBNS Servers. Lists the IP addresses
for NetBIOS name servers (NBNSes) on the network
046 WINS/NBT Node Type. Configures the client
node type for NetBT clients
060 PXE Client. The address used for Pre-Boot
Name Description
Execution Environment (PXE) client bootstrap code
Server Options These options apply globally for all scopes and classes
defined at each DHCP server and for any clients that a
DHCP server services. Configured server option values
always apply unless they are overridden by options
assigned to other scope, class, or client reservation.
Within the Server Options setting, the following sub-
settings are configurable:
003 Router. A list of IP addresses for routers on the
client subnet
006 DNS Servers. A list of IP addresses for DNS
name servers available to the client
015 DNS Domain Name. The domain name that the
DHCP client should use when resolving unqualified
domain names with the DNS
044 WINS/NBNS Servers. Lists the IP addresses
for NBNSes on the network
046 WINS/NBT Node Type. Configures the client
node type for NetBT clients
060 PXE Client. The address used for PXE client
bootstrap code
Configure DNS
This task sequence step configures DNS on the target computer. For more
information about which script accomplishes this task and which properties you
use, see ZTIConfigureDNS.wsf.
The unique properties and settings for the Configure DNS task sequence step
type are:
Properties
Name Description
Type Set this read-only type to Configure DNS Server.
Settings
Name Description
Name Configure DNS
Zones Within the Scope Details setting, the following sub-
settings are configurable:
Name Description
DNS zone name. A user-definable name
Type. The type of DNS zone to be created
Replication. Specifies the replication scheme used
to share information among DNS servers
Zone file name. The zone’s DNS database file
Dynamic updates. Enables DNS client computers
to register and dynamically update their resource
records with a DNS server whenever changes occur
Scavenge stale resource records. Removes stale
resource records
Server Properties Within the Server Properties setting, the following sub-
settings are configurable:
Disable recursion. Specifies that the DNS server
will not perform recursion on any query
BIND secondaries. Specifies whether to use fast
transfer format to transfer a zone to DNS servers
running legacy Berkeley Internet Name Domain
(BIND) implementations
Fail on load if bad data. Specifies the DNS server
should parse files strictly
Enable round robin. Specifies the DNS server
should use the round robin mechanism to rotate and
reorder a list of resource records if multiple resource
records exist of the same type exist for a query
answer
Enable netmask ordering. Specifies whether the
DNS server should reorder resource records within
the same resource record set in its response to a
query based on the IP address of the source of the
query
Secure cache against pollution. Specifies whether
the DNS server will attempt to clean up responses to
avoid cache pollution
Name checking. Configures the name-checking
method to be used
Note The Configure DNS task sequence step uses the Dnscmd tool, which is included in
Windows Support Tools, to configure DNS. Be sure that Windows Support Tools is installed before
running the Configure DNS task sequence step.
Note For more information about these server properties, see Dnscmd.
Enable BitLocker
This task sequence step configures BitLocker® Drive Encryption on the target
computer. For more information about this step type, see Enable BitLocker.
The unique properties and settings for the Enable BitLocker task sequence step
type are:
Properties
Name Description
Type Set this read-only type to Enable BitLocker.
Settings
Name Description
Current operating When selected, the operating system drive will be
system drive configured. This is the default selection.
Specific drive When selected, the specified drive will be configured.
TPM only When selected, the Trusted Platform Module (TPM) is
required. This is the default selection.
Startup key on USB When selected, a startup key is required on the
only specified USB drive.
TPM and startup key When selected, the TPM is required in addition to a
on USB startup key on the specified USB drive.
In Active Directory When selected, the recovery key is stored in AD DS.
This is the default selection.
Do not create a When selected, the recovery key is not created. Using
recovery key this option is not recommended.
Wait for BitLocker to When selected, this step will not finish until after
complete BitLocker has finished processing all drives.
Properties
Name Description
Type Set this read-only type to Format and Partition Disk.
Settings
Name Description
Disk number The physical number of the disk to be configured.
Disk type The type of drive to be created. Values are Standard—
Master Boot Record (MBR) and GUID (globally unique
identifier) Partition Table. The default selection is MBR.
Volume Within the Volume setting, the following sub-settings
are configurable:
Partition Name. A user-definable name.
Partition Type. Values are Primary or Extended.
Use a percentage of remaining space.
Use specific drive size. Values are in increments of
1 MB or 1 gigabyte (GB).
Make this a boot partition.
File System. Values are NTFS or FAT32.
Quick Format. When selected, a quick format is
performed.
Variable. The drive letter that was assigned to this
newly configured partition.
Note When using the CustomSettings.ini file to specify the hard disk and partition configurations,
only the first hard disk and first two partitions will be configured. Edit ZTIGather.xml to configure
additional hard disks or partitions.
Gather
This task sequence step gathers data and processing rules for the target
computer. The unique properties and settings for the Gather task sequence step
type are:
Properties
Name Description
Type Set this read-only type to Gather.
Settings
Name Description
Gather only local When selected, this step processes only the properties
data contained in the ZTIGather.xml file.
Gather local data When selected, this step processes the properties
and process rules contained in the ZTIGather.xml file and the properties
contained in the file that the Rules file specifies. This is
Name Description
the default selection.
Rules file The name of the Rules file to process. If left blank, the
task sequence step attempts to locate and process the
CustomSettings.ini file.
Inject Drivers
This task sequence step injects drivers that have been configured for deployment
to the target computer. The unique properties and settings for the Inject Drivers
task sequence step type are:
Properties
Name Description
Type Set this read-only type to Inject Drivers.
Settings
Name Description
Install only Injects only the drivers that the target computer requires
matching drivers and that match what is available in Out-of-Box Drivers
Install all drivers Installs all drivers
Selection profile Installs all drivers in the selected profile
Install Application
This task sequence step installs applications on the target computer. For more
information about this step type, see Install Software.
The unique properties and settings for the Install Application task sequence
step type are:
Properties
Name Description
Type Set this read-only type to Install Application.
Settings
Name Description
Install multiple Install mandatory applications that the
applications MandatoryApplications property has specified and
optional applications that the Applications property has
specified. These properties are configured by rules or
Name Description
are specified during the Windows Deployment Wizard
interview process. This is the default selection.
Install a single The specific application to install. You select the
application application from a drop-down list that consists of
applications that have been configured in the
Applications node of the Deployment Workbench.
Success codes A space-delimited list of application installation exit
codes that should be used when determining the
successful installation of applications.
Properties
Name Description
Type Set this read-only type to Install Operating System.
Settings
Name Description
Operating system to The name of the operating system to be installed on the
install target computer. You select the operating system from a
drop-down list compiled from operating systems that
have been configured in the Operating Systems node of
Name Description
the Deployment Workbench.
Disk The disk on which to install the operating system.
Partition The partition on which to install the operating system.
Properties
Name Description
Type Set this read-only type to Install Roles and Features.
Settings
Name Description
The list of roles and You can specify one or more roles and features for
features that should installation on the target computer. These roles are:
be installed AD DS domain controller
DHCP server
DNS server
Properties
Name Description
Type Set this read-only type to Install Updates Offline.
Settings
Name Description
Name Description
Package Name The name of the language pack package that should be
applied to the target computer
Note This task sequence step is valid only when deploying Windows Vista or Windows
Server 2008 using MDT with Configuration Manager 2012 or Configuration Manager 2007 R3.
Properties
Name Description
Type Set this read-only type to Install Language Packs
Online.
Settings
Name Description
Package Name The name of the language pack package that should be
applied to the target computer
Note This task sequence step is valid only when using MDT with Configuration Manager 2012 or
Configuration Manager 2007 R3.
Properties
Name Description
Type Set this read-only type to Install Updates Offline.
Settings
Name Description
Selection Profile The name of the selection profile that should be applied
to the target computer
Note When using MDT with Configuration Manager 2012 or
Configuration Manager 2007 R3, specify the name of the update
package that should be applied.
Note This task sequence step is valid only when deploying Windows Vista or Windows
Server 2008.
Properties
Name Description
Type Set this read-only type to Recover from Domain Join
Failure.
Settings
Name Description
Auto recover The task sequence step attempts to join the target
computer to a domain.
Manual recover If the target computer fails to join a domain, the task
sequence step causes the Task Sequencer to pause,
allowing you to attempt to join the target computer to a
domain.
No recover If the target computer is not able to join a domain, the
task sequence fails, stopping all task sequence
execution.
Restart computer
This task sequence step restarts the target computer. The unique properties and
settings for the Restart computer task sequence step type are:
Properties
Name Description
Type Set this read-only type to Restart computer.
Settings
Name Description
None None
Properties
Name Description
Type Set this read-only type to Run Command Line.
Settings
Name Description
Command Line The commands to be run when this task sequence step
is processed
Start in The starting folder for the application (The path must be
a valid path on the target computer.)
Run this step as the Allows specification of user credentials that will be used
following account to run the specified command
Account The user credentials that will be used to run the
specified command
Load the user’s When selected, loads the user profile for the specified
profile account
Properties
Name Description
Type Set this read-only type to Run PowerShell Script.
Settings
Name Description
PowerShell script The Windows PowerShell script to be run when this task
sequence step is processed
Parameters The parameters to be passed to the Windows
PowerShell script. These parameters should be
specified the same as if you were adding them to the
Windows PowerShell script from a command line.
The parameters provided should be only those
parameters the script consumes, not for the Windows
PowerShell command line.
The following example would be a valid value for this
setting:
-MyParameter1 MyValue1 -MyParameter2
MyValue2
The following example would be an invalid value for this
setting (bold items are incorrect):
-nologo -executionpolicy unrestricted -
File MyScript.ps1 -MyParameter1 MyValue1
-MyParameter2 MyValue2
The previous example is invalid, because the value
includes Windows PowerShell command-line
parameters (-nologo and –executionpolicy
unrestricted).
Properties
Name Description
Type Set this read-only type to Set Task Sequence Variable.
Settings
Name Description
Task Sequence The name of the variable to modify
Variable
Name Description
Value The value to assign to the specified variable
Validate
This task sequence step verifies that the target computer meets the specified
deployment prerequisite conditions. The unique properties and settings for the
Validate task sequence step type are:
Properties
Name Description
Type Set this read-only type to Validate.
Settings
Name Description
Ensure minimum When selected, this step verifies that the amount of
memory memory, in megabytes, installed on the target computer
meets or exceeds the amount specified. This is a default
selection.
Ensure minimum When selected, this step verifies that the speed of the
processor speed processor, in megahertz (MHz), installed in the target
computer meets or exceeds the amount specified. This
is a default selection.
Ensure specified When selected, this step verifies that the amount of free
image size will fit disk space, in megabytes, on the target computer meets
or exceeds the amount specified.
Ensure current When selected, this step verifies that the operating
operating system to system installed on the target computer meets the
be refreshed requirement specified. This is a default selection.
Inject Drivers
This task sequence step adds mass storage drivers to the System Preparation
Tool (Sysprep) file on the target computer. Following is a brief listing of the
settings that show how this step was originally configured in one of the MDT task
sequence templates. For more information about which script accomplishes this
task and which properties you use, see ZTIDrivers.wsf.
The default configuration of the Inject Drivers task sequence step is:
Properties
Name Value
Type Inject Drivers
Name Inject Drivers
Description Not specified
Settings
Name Value
Install only Only installs drivers for hardware found on the target
matching drivers computer
Install all drivers Installs all drivers on the target computer
Selection profile The driver selection profile that selects which drivers
can be referenced when injecting drivers to the target
computer
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Apply Network Settings
Name Apply Network Settings
Description Not specified
Settings
Name Value
No parameters are preconfigured for this step. This
causes this step, by default, to configure the network
adapter to use DHCP.
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Note When using the CustomSettings.ini file to specify the network adapter configurations, only
the first network adapter will be configured. Edit ZTIGather.xml to configure additional network
adapters.
Apply Patches
This task sequence step installs updates to the image on the target computer
after the operating system has been deployed but before the target computer has
been restarted. Following is a brief listing of the settings that show how this step
was originally configured in one of the MDT task sequence templates. For more
information about which script accomplishes this task and which properties you
use, see ZTIPatches.wsf.
The default configuration of the Install Updates Offline task sequence step is:
Properties
Name Value
Type Install Updates Offline
Name Apply Patches
Description Not specified
Settings
Name Value
Selection profile The name of the profile used when selecting the
patches to install on the target computer
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Run Command Line
Name Apply Windows PE (Vista)
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\LTIApply.wsf" /PE
Options
Name Value
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier ImageBuild greater than or equals 6
Properties
Name Value
Type Run Command Line
Name Apply Windows PE (XP)
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\LTIApply.wsf" /PE
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier ImageBuild less than 6
Backup
This task sequence step backs up the target computer before starting the
operating system deployment. Following is a brief listing of the settings that show
how this step was originally configured in one of the MDT task sequence
templates. For more information about which script accomplishes this task and
which properties you use, see ZTIBackup.wsf.
The default configuration of the Backup task sequence step is:
Properties
Name Value
Type Run Command Line
Name Backup
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIBackup.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Capture Groups
This task sequence step captures group membership of local groups that exist on
the target computer. Following is a brief listing of the settings that show how this
step was originally configured in one of the MDT task sequence templates. For
more information about which script accomplishes this task and which properties
you use, see ZTIGroups.wsf.
The default configuration of the Capture Groups task sequence step is:
Properties
Name Value
Type Run Command Line
Name Capture Groups
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIGroups.wsf"
/capture
Start in Not specified.
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Run Command Line
Name Capture User State
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIUserState.wsf"
/capture
Start in Not specified
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Check BIOS
This task sequence step checks the basic input/output system (BIOS) of the
target computer to ensure that it is compatible with the operating system you are
deploying. Following is a brief listing of the settings that show how this step was
originally configured in one of the MDT task sequence templates. For more
information about which script accomplishes this task and which properties are
used, see ZTIBIOSCheck.wsf.
The default configuration of the Check BIOS task sequence step is:
Properties
Name Value
Type Run Command Line
Name Check BIOS
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIBIOSCheck.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Configure
This task sequence step configures the Unattend.xml, Sysprep.inf, or
Unattend.txt files with the required property values that are applicable to the
operating system you are deploying to the target computer. Following is a brief
listing of the settings that show how this step was originally configured in one of
the MDT task sequence templates. For more information about which script
accomplishes this task and which properties you use, see ZTIConfigure.wsf.
The default configuration of the Configure task sequence step is:
Properties
Name Value
Type Run Command Line
Name Configure
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIConfigure.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Copy Scripts
This task sequence step copies the deployment scripts used during the
deployment processes to a local hard disk on the target computer. Following is a
brief listing of the settings that show how this step was originally configured in
one of the MDT task sequence templates. For more information about which
script accomplishes this task and which properties you use, see
LTICopyScripts.wsf.
The default configuration of the Copy Scripts task sequence step is:
Properties
Name Value
Type Run Command Line
Name Copy Scripts
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\LTICopyScripts.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Run Command Line
Name Copy Sysprep Files
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\LTISysprep.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Set Task Sequence Variable
Name Create BitLocker Partition
Description None
Settings
Name Value
Task Sequence BDE Install
Variable
Name Value
Value True
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Create WIM
This task sequence step creates a backup of the target computer. The unique
properties and settings for the Create WIM task sequence step type are:
Properties
Name Value
Type Run Command Line
Name Create WIM
Description None
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIBackup.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Run Command Line
Name Disable BDE Protectors
Description None
Settings
Name Value
Command line cscript.exe
"%SCRIPTROOT%\ZTIDisableBDEProtectors.wsf"
Start in Not specified
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Enable BitLocker
This task sequence step enables BitLocker on the target computer. Following is a
brief listing of the settings that show how this step was originally configured in
one of the MDT task sequence templates. For more information about which
script accomplishes this task and what properties are used, see ZTIBde.wsf.
The default configuration of the Enable BitLocker task sequence step is:
Properties
Name Value
Name Value
Type Enable BitLocker
Name Enable BitLocker
Description None
Settings
Name Value
Current operating Selected
system drive
TPM only Selected
Startup key on USB Not selected
only
TPM and startup key Not selected
on USB
Specific drive Not selected
In Active Directory Selected
Do not create a Not selected
recovery key
Wait for BitLocker to Not selected
complete
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier BdeInstallSuppress does not equal YES
Properties
Name Value
Type Set Task Sequence Variable
Name Enable OEM Disk Configuration
Description None
Settings
Name Value
Task Sequence DeploymentType
Variable
Value NEWCOMPUTER
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
End Phase
This task sequence step ends the current deployment phase and restarts the
target computer. Following is a brief listing of the settings that show how this step
was originally configured in one of the MDT task sequence templates.
The default configuration of the End Phase task sequence step is:
Properties
Name Value
Type Restart computer
Name End Phase
Description Not specified
Settings
Name Value
None None
Options
Solution Accelerators microsoft.com/technet/SolutionAccelerators
Toolkit Reference: Task Sequence Steps 37
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Execute Sysprep
This task sequence step starts Sysprep on the target computer. Following is a
brief listing of the settings that show how this step was originally configured in
one of the MDT task sequence templates. For more information about what script
accomplishes this task and what properties are used, see LTISysprep.wsf.
The default configuration of the Execute Sysprep task sequence step is:
Properties
Name Value
Type Run Command Line
Name Execute Sysprep
Description None
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\LTISysprep.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Run Command Line
Name Force Diskpart Action
Description Not specified
Settings
Name Value
Command line cmd.exe /c if exist c:\oem.wsf del /q
c:\oem.wsf
Start in Not specified
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0.1
Continue on error Selected
Conditional qualifier None
Properties
Name Value
Type Format and Partition Disk
Name Format and Partition Disk
Description Not specified
Settings
Name Value
Disk number 0
Disk type Standard (MBR)
Volume Within the Volume setting, the following sub-settings are
configured:
Partition Name. OSDisk
Partition Type. Primary
Use a percentage of remaining space. Selected
Size(%). 100
Use specific drive size. Not selected
Make this a boot partition. Selected
File System. NTFS
Quick Format. Selected
Variable. Not specified
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Note When using the CustomSettings.ini file to specify the hard disk and partition configurations,
only the first hard disk and first two partitions will be configured. Edit ZTIGather.xml to configure
additional hard disks or partitions.
settings that show how this step was originally configured in one of the MDT task
sequence templates.
For more information about what script accomplishes this task and what
properties are used, see ZTIGather.wsf.
The default configuration of the Gather local only task sequence step is:
Properties
Name Value
Type Gather
Name Gather local only
Description Not specified
Settings
Name Value
Gather only local Selected
data
Gather local data Not selected
and process rules
Rules file Not specified
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier None
Properties
Name Value
Type Run Command Line
Name Generate Application Migration File
Description Not specified
Settings
Name Value
Command Line cscript.exe "%SCRIPTROOT%\ZTIAppXmlGen.wsf"
/capture
Start in Not specified
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier None
Inject Drivers
This task sequence step injects drivers that have been configured for deployment
to the target computer. Following is a brief listing of the settings that show how
this step was originally configured in one of the MDT task sequence templates.
For more information about what script accomplishes this task and what
properties are used, see ZTIDrivers.wsf.
The default configuration of the Inject Drivers task sequence step is:
Properties
Name Value
Type Inject Drivers
Name Inject Drivers
Description Not specified
Settings
Name Value
Install only Injects only the drivers which are required by the target
matching drivers computer and match with what is available in Out-of-Box
Drivers
Install all drivers Injects all drivers
Selection profile Injects drivers which are associated with the selected
profile
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Install Applications
This task sequence step installs applications on the target computer. Following is
a brief listing of the settings that show how this step was originally configured in
one of the MDT task sequence templates.
For more information about what script accomplishes this task and what
properties are used, see ZTIApplications.wsf.
The default configuration of the Install Applications task sequence step is:
Properties
Name Value
Type Install Applications
Name Install Applications
Description Not specified
Settings
Name Value
Install multiple Selected
applications
Install a single Not selected
application
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Install Operating System
Name Install Operating System
Description Not specified
Settings
Name Value
Operating system to This value corresponds to the operating system that
install was selected when the task sequence was created.
Disk The disk where the operating system is to be installed.
Partition The partition where the operating system is to be
installed.
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Next Phase
This task sequence step updates the Phase property to the next phase in the
deployment process. Following is a brief listing of the settings that show how this
step was originally configured in one of the MDT task sequence templates.
For more information about what script accomplishes this task and what
properties are used, see ZTINextPhase.wsf.
The default configuration of the Next Phase task sequence step is:
Properties
Name Value
Type Run Command Line
Name Next Phase
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTINextPhase.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Post-Apply Cleanup
This task sequence step cleans up unnecessary files after the installation of an
image on the target computer. Following is a brief listing of the settings that show
how this step was originally configured in one of the MDT task sequence
templates.
For more information about what script accomplishes this task and what
properties are used, see LTIApply.wsf.
The default configuration of the Post-Apply Cleanup task sequence step is:
Properties
Name Value
Type Run Command Line
Name Post-Apply Cleanup
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\LTIApply.wsf" /post
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Description
Type This read-only type is set to Recover from Domain
Join Failure.
Settings
Name Description
Auto recover The task sequence step will attempt to join the target
Name Description
computer to a domain.
Manual recover If the target computer fails to join a domain, the task
sequence step will cause the task sequencer to pause,
allowing the user attempts to join the target computer to
a domain.
No recover If the target computer is not able to join a domain, the
task sequence fails—stopping all task sequence
execution.
Restart computer
This task sequence step restarts the target computer. Following is a brief listing
of the settings that show how this step was originally configured in one of the
MDT task sequence templates.
The default configuration of the Restart computer task sequence step is:
Properties
Name Value
Type Restart computer
Name Restart computer
Description Not specified
Settings
Name Value
None None
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Restore Groups
This task sequence step restores the previously captured group membership of
local groups on the target computer. Following is a brief listing of the settings that
show how this step was originally configured in one of the MDT task sequence
templates.
For more information about what script accomplishes this task and what
properties are used, see ZTIGroups.wsf.
The default configuration of the Restore Groups task sequence step is:
Properties
Name Value
Type Run Command Line
Name Restore Groups
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIGroups.wsf"
/restore
Start in Not specified
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier If all conditions are true:
DoCapture does not equal YES
DoCapture does not equal PREPARE
The default configuration of the Restore User State task sequence step is:
Properties
Name Value
Type Run Command Line
Name Restore User State
Description Not specified
Settings
Name Value
Command Line cscript.exe "%SCRIPTROOT%\ZTIUserState.wsf"
/restore
Start in Not specified
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier If all conditions are true:
If DoCapture does not equal YES
If DoCapture does not equal PREPARE
Properties
Name Value
Type Set Task Sequence Variable
Name Set Image Build
Name Value
Description Not specified
Settings
Name Value
Task Sequence ImageBuild
Variable
Value %OSCurrentVersion%
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Set Task Sequence Variable
Name Set Image Flags
Description Not specified
Settings
Name Value
Task Sequence ImageFlags
Variable
Value %OSSKU%
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Tatoo
This task sequence step tattoos the target computer with identification and
version information. Following is a brief listing of the settings that show how this
step was originally configured in one of the MDT task sequence templates.
For more information about what script accomplishes this task and what
properties are used, see ZTITatoo.wsf.
The default configuration of the Tatoo task sequence step is:
Properties
Name Value
Type Run Command Line
Name Tatoo
Description Not specified
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTITatoo.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Validate
This task sequence step validates that the target computer meets the specified
deployment prerequisite conditions. Following is a brief listing of the settings that
show how this step was originally configured in one of the MDT task sequence
templates.
For more information about what script accomplishes this task and what
properties are used, see ZTIValidate.wsf.
The default configuration of the Validate task sequence step is:
Properties
Name Value
Type Validate
Name Validate
Description Not specified
Settings
Name Value
Ensure minimum Selected. The value selector is set to 512.
memory (MB)
Ensure minimum Selected. The value selector is set to 800.
processor speed
(MHz)
Ensure specified Not selected.
image size will fit
(MB)
Ensure current Selected. The value selector is set to Server or Client,
operating system to depending on the template used to create the task
be refreshed sequence.
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
Name Value
Type Run Command Line
Name Windows Update (Pre-Application Installation)
Description Not specified
Settings
Name Value
Command line cscript.exe
"%SCRIPTROOT%\ZTIWindowsUpdate.wsf"
Start in Not specified
Run this step as the Not specified
following account
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Wipe Disk
This task sequence step wipes all information from the disk using the Format
command.
For more information about what script accomplishes this task and what
properties are used, see ZTIWipeDisk.wsf.
The default configuration of the Wipe Disk task sequence step is:
Properties
Name Value
Type Run Command Line
Name Wipe Disk
Description This will only run if WipeDisk=TRUE in
CustomSettings.ini
Settings
Name Value
Command line cscript.exe "%SCRIPTROOT%\ZTIWipeDisk.wsf"
Options
Name Value
Disable this step Not selected
Success codes 0 3010
Continue on error Not selected
Conditional qualifier Not specified
Properties
The scripts used in Lite Touch Installation (LTI) and ZTI reference properties to
determine the process steps and configuration settings used during the
deployment process. The scripts create some of these properties automatically.
Other properties must be configured in the CustomSettings.ini file. Some of these
properties are:
Value and Description. Indicates the valid values to be specified for the
property and a brief description of what each value means. (Values in italics
indicate that a value is substituted—for example the value user1, user2
indicates that user1 and user2 would be replaced with the actual name of
user accounts.)
Example. Provides an example of a property use as it might appear in the .ini
files.
For more information about these and other task sequence properties that might
be referenced while performing a ZTI deployment, see Operating System
Deployment Task Sequence Variables.
The deployment scripts generally require values to be specified in upper case so
that they are properly read. Therefore, when specifying property values, use
uppercase letters.
Property Definition
The following sections describe the properties that are available for LTI and ZTI
deployments in MDT.
Tip The properties are sorted in alphabetical order.
_SMSTSOrgName
Customizes the Task Sequencer engine's display banner.
Value Description
name The name that will be used in the Task Sequencer
engine’s display banner
Example
[Settings]
Priority=Default
[Default]
_SMSTSOrgName=Woodgrove Bank
ADDSLogPath
Fully qualified, non-UNC directory on a hard disk on the local computer to host
the AD DS log files. If the directory exists it must be empty. If it does not exist, it
will be created.
Value Description
log_path Fully qualified, non-UNC directory on a hard disk on
the local computer to host the AD DS log files
Example
[Settings]
Priority=Default
[Default]
ADDSLogPath=%DestinationLogicalDrive%\Windows\NTDS
ADDSPassword
Account credentials that can be used when promoting the server to a domain
controller.
Value Description
password Account credentials that can be used for the
promotion operation
Example
[Settings]
Priority=Default
[Default]
ADDSUserName=Administrator
ADDSUserDomain=WoodGroveBank
ADDSPassword=<complex_password>
ADDSUserDomain
This is the domain the account specified by ADDSUserName should be taken
from. If the operation is to create a new forest or to become a member server
from a backup domain controller upgrade there is no default. If the operation is to
create a new tree, the default is the DNS name of the forest the computer is
currently joined to. If the operation is to create a new child domain or a replica
then the default is the DNS name of the domain the computer is joined to. If the
operation is to demote the computer and the computer is a domain controller in a
child domain, the default is the DNS name of the parent domains. If the operation
is to demote the computer, and the computer is a domain controller of a tree root
domain, the default is the DNS name of the forest.
Value Description
domain Domain the UserName account should be taken from
Example
[Settings]
Priority=Default
Example
[Default]
ADDSUserName=Administrator
ADDSUserDomain=WoodGroveBank
ADDSPassword=<complex_password>
ADDSUserName
Account credentials that will be used when promoting the server to a domain
controller.
Value Description
user_name Account credentials that will be used for the promotion
operation
Example
[Settings]
Priority=Default
[Default]
ADDSUserName=Administrator
ADDSUserDomain=WoodGroveBank
ADDSPassword=complex_password
Administrators
A list of user accounts and domain groups that will be added to the local
Administrator group on the target computer. The Administrators property is a
list of text values that can be any non-blank value. The Administrators property
has a numeric suffix (for example, Administrators001 or Administrators002).
Value Description
name The name of a user or group that is to be added to the
local Administrator group
Example
[Settings]
Priority=Default
[Default]
Administrators001=WOODGROVEBANK\NYC Help Desk Staff
Administrators002=WOODGROVEBANK\North America East Help
Desk Staff
PowerUsers001=WOODGROVEBANK\User01
PowerUsers002=WOODGROVEBANK\User02
AdminPassword
Defines the password that will be assigned to the local Administrator user
account on the target computer. If not specified, the pre-deployment password of
the Administrator user account will be used.
Value Description
admin_password The password that is to be assigned to the
Administrator user account on the target computer
Example
[Settings]
Priority=Default
[Default]
Administrators001=WOODGROVEBANK\NYC Help Desk Staff
AdminPassword=<admin_password>
Applications
A list of application GUIDs that should be installed on the target computer. These
applications are specified on the Applications node in Deployment Workbench.
These GUIDs are stored in the Applications.xml file. The Applications property
is a list of text values that can be any non-blank value. The Applications
property has a numeric suffix (for example, Applications001 or
Applications002).
Value Description
application_guid The GUID is specified by Deployment Workbench for
the application to be deployed to the target computer.
The GUID corresponds to the application GUID stored
in the Applications.xml file.
Example
[Settings]
Priority=Default
[Default]
Applications001={1D7DF331-47B7-472C-87B3-442597EC2F7D}
Applications002={9d2b8999-5e4d-4f3d-bb05-edaaf4fe5628}
ApplicationSuccessCodes
A space-delimited list of error codes used by the ZTIApplications script that
determine the successful installation of applications.
Note This property is only applicable to the Install Application task sequence step type and
when Install multiple applications is selected.
Value Description
error_codes The error codes that determine when applications
have been successfully installed. Default values are 0
and 3010.
Example
[Settings]
Example
Priority=Default
[Default]
ApplicationSuccessCodes=0 3010
ApplyGPOPack
This property is used to determine whether the Apply Local GPO Package task
sequence step is performed.
Note The default value for this property always performs the Apply Local GPO Package task
sequence step. You must explicitly provide a value of ―NO‖ to override this behavior..
Value Description
YES The Apply Local GPO Package task sequence step
is performed. This is the default value.
NO The Apply Local GPO Package task sequence step
is not performed.
Example
[Settings]
Priority=Default
[Default]
ApplyGPOPack=NO
Architecture
The processor architecture of the processor that is currently running, which is not
necessarily the processor architecture supported by the target computer. For
example, when running a 32-bit–compatible operating system on a 64-bit
processor, Architecture will indicate that the processor architecture is 32 bit.
Use the CapableArchitecture property to identify the actual processor
architecture that the target computer supports.
Note This property is dynamically set by MDT scripts and is not configured in CustomSettings.ini.
Treat this property as read only. However, you can use this property within CustomSettings.ini, as
shown in the following examples, to aid in defining the configuration of the target computer.
Value Description
x86 Processor architecture is 32 bit.
x64 Processor architecture is 64 bit.
Example
None
AreaCode
The area code to be configured for the operating system on the target computer.
This property allows only numeric characters. This value is inserted into the
appropriate configuration settings in Unattend.txt or Sysprep.inf for Windows XP
and Windows Server 2003 or in Unattend.xml for Windows Vista and later
operating systems.
Value Description
area_code The area code where the target computer is to be
deployed
Example
[Settings]
Priority=Default
[Default]
AreaCode=206
CountryCode=001
Dialing=TONE
LongDistanceAccess=9
AssetTag
The asset tag number associated with the target computer. The format for asset
tag numbers is undefined. Use this property to create a subsection that contains
settings targeted to a specific computer.
Note This property is dynamically set by MDT scripts and is not configured in CustomSettings.ini.
Treat this property as read only. However, you can use this property within CustomSettings.ini, as
shown in the following examples, to aid in defining the configuration of the target computer.
Value Description
asset_tag The format of the asset tag is undefined and is
determined by the asset tag standard of each
organization.
Example 1
[Settings]
Priority=Default
[Default]
OSDComputerName=HP-%AssetTag%
Example 2
[Settings]
Priority=AssetTag, Default
[Default]
OSInstall=YES
[0034034931]
OSDComputerName=HPD530-1
[0034003233]
OSDNEWMACHINENAME=BVMXP
AutoConfigDNS
Specifies whether the Active Directory Installation Wizard configures DNS for the
new domain if it detects that the DNS dynamic update protocol is not available.
Caution This property value must be specified in uppercase so that the deployment scripts can
properly read it.
Value Description
YES Configures DNS for the new domain if the DNS
dynamic update protocol is not available
NO Does not configure DNS for the domain
Example
[Settings]
Priority=Default
[Default]
AutoConfigDNS=YES
AutoMode
Specifies whether to install Windows Server 2003 in a per-seat or a per-server
license mode. AutoUsers must also be specified when AutoMode equals
PerServer. For more information about using the AutoMode property, see
[LicenseFilePrintData] (Unattended Installation).
Note The AutoMode property must be specified to fully automate the deployment when deploying
Windows Server 2003.
Value Description
license_mode The licensing mode that should be used when
configuring the server (Valid values are PerServer
and PerSeat.)
Example
[Settings]
Priority=Default
Example
[Default]
AutoMode=PerServer
AutoUsers=999
AutoUsers
Specifies the number of client licenses purchased for the server. For more
information about using the AutoUsers property, see [LicenseFilePrintData]
(Unattended Installation).
Note The AutoUsers property must be specified to fully automate the deployment when
deploying Windows Server 2003; the AutoMode property equals PerServer.
Value Description
licenses The number of licenses purchased for the server being
configured
Example
[Settings]
Priority=Default
[Default]
AutoMode=PerServer
AutoUsers=999
BackupDir
The folder in which backups of the target computer are stored. This folder exists
beneath the UNC path specified in the BackupShare property. If the folder does
not already exist, it will be created automatically.
Value Description
Folder The name of the folder that exists beneath the shared
folder specified in the BackupShare property
Example
[Settings]
Priority=Default
[Default]
DoCapture=YES
BackupShare=\\NYC-AM-FIL-01\Backup$
BackupDir=%OSDComputerName%
BackupDrive=C:
BackupDrive
The drive to include in the backup of the target computer. This property defaults
to the drive that contains disk 0 partition 1. It can be also set to ALL.
Value Description
backup_drive The drive letter of the drive to back up
ALL Back up all drives on the target computer
Example
[Settings]
Priority=Default
[Default]
DoCapture=YES
BackupShare=\\NYC-AM-FIL-01\Backup$
BackupDir=%OSDComputerName%
BackupDrive=C:
BackupFile
Specifies the WIM file that will be used by the ZTIBackup.wsf script. For more
information about what script uses this property, see ZTIBackup.wsf.
Value Description
backup_file The name of the Windows Imaging Format (WIM) file
to be used during back up.
Example
[Settings]
Priority=Default
[Default]
DoCapture=YES
BackupShare=\\NYC-AM-FIL-01\Backup$
BackupDir=%OSDComputerName%
BackupFile=%OSDComputerName%.wim
BackupShare
The shared folder in which backups of the target computer are stored.
The credentials used to access this shared folder for:
Value Description
UNC_path The UNC path of the shared folder
Value Description
Note The UNC path specified in this property must exist before
deploying the target operating system.
Example
[Settings]
Priority=Default
[Default]
DoCapture=YES
BackupShare=\\NYC-AM-FIL-01\Backup$
BackupDir=%OSDComputerName%
BackupDrive=C:
BDEDriveLetter
The drive letter for the partition that is not encrypted by BitLocker, also known as
the System Volume. SYSVOL is the directory that contains the hardware-specific
files needed to load Windows computers after the BIOS has booted the platform.
Value Description
drive_letter The letter designation for the logical drive for the
System Volume (such as S or T). The default value is
S.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=TPMKey
BDERecoveryKey=AD
BDEKeyLocation=C:
BDEDriveSize
The size of the BitLocker system partition. The value is specified in megabytes.
In the example, the size of the BitLocker partition to create is almost 2 GB
(2,000 MB).
Value Description
drive_size The size of the partition in megabytes; the default
sizes are:
Windows Vista and Windows Server 2008:
2,000 MB
Windows 7 and Windows Server 2008 R2: 300 MB
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=TPMKey
BDERecoveryKey=AD
BDEKeyLocation=C:
BDEInstall
The type of BitLocker installation to be performed. Protect the target computer
using one of the following methods:
A TPM microcontroller
A TPM and an external startup key (using a key that is typically stored on a
USB flash drive [UFD])
A TPM and PIN
An external startup key
Value Description
TPM Protect the computer with TPM only. The TPM is a
microcontroller that stores keys, passwords, and
digital certificates. The microcontroller is typically an
integral part of the computer motherboard.
TPMKey Protect the computer with TPM and a startup key. Use
this option to create a startup key and to save it on a
UFD. The startup key must be present in the port each
time the computer starts.
TPMPin Protect the computer with TPM and a pin. Use this
option in conjunction with the BDEPin property.
Key Protect the computer with an external key (the
recovery key) that can be stored in a folder, in AD DS,
or printed.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=TPMKey
BDERecoveryKey=AD
BDEKeyLocation=C:
BDEInstallSuppress
Indicates whether the deployment process should skip the BitLocker installation.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
YES Do not attempt to install BitLocker.
NO Attempt to install BitLocker.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=YES
BDEKeyLocation
The location for storing the BitLocker recovery key and startup key.
Note If this property is configured using the Windows Deployment Wizard, the property must be
the drive letter of a removable disk. If the SkipBitLocker property is set to TRUE so that the
Specify the BitLocker configuration wizard page is skipped, this property can be set to a UNC
path in CustomSettings.ini or in the MDT database (MDT DB).
Value Description
Location Specifies where the recovery key will be stored; must
be a UNC path or the drive letter of a removable disk.
If not set, the first available removable drive will be
used.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=TPMKey
BDERecoveryKey=AD
BDEKeyLocation=C:
BDEPin
The PIN to be assigned to the target computer when configuring BitLocker and
the BDEInstall or OSDBitLockerMode properties are set to TPMPin.
Value Description
Pin The PIN to be used for BitLocker. The PIN can be
between 4 and 20 digits long.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=TPMPin
BDEPin=123456789
BDERecoveryKey
A Boolean value that indicates whether the process creates a recovery key for
BitLocker. The key is used for recovering data encrypted on a BitLocker volume.
This key is cryptographically equivalent to a startup key. If available, the recovery
key decrypts the volume master key (VMK), which, in turn, decrypts the full
volume encryption key (FVEK).
Note The recovery key is stored in the location specified in the BDEKeyLocation property.
Value Description
AD A recovery key is created.
Not specified A recovery key is not created.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=TPMKey
BDERecoveryKey=AD
BDEKeyLocation=C:
BDEWaitForEncryption
Specifies that the deployment process should not proceed until BitLocker has
completed the encryption process for all specified drives. Specifying TRUE could
dramatically increase the time required to complete the deployment process.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
TRUE Specifies that the deployment process should wait for
drive encryption to complete.
FALSE Specifies that the deployment process should not wait
for drive encryption to complete.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
OSDBitLockerMode=TPMKey
OSDBitLockerStartupKeyDrive=C:
Example
OSDBitLockerCreateRecoveryPassword=AD
BDEWaitForEncryption=TRUE
BitsPerPel
A setting for displaying colors on the target computer. The property can contain
numeric digits and corresponds to the color quality setting. In the example, 32
indicates 32 bits per pixel for color quality. This value is inserted into the
appropriate configuration settings in Unattend.txt or Sysprep.inf for Windows XP
and Windows Server 2003 or in Unattend.xml for Windows Vista and later
operating systems.
Note The default values (in the template files Unattend.txt, Sysprep.inf, and Unattend.xml) are
1,024 pixels horizontal resolution, 768 pixels vertical resolution, 32-bit color depth, and 60 Hertz
(Hz) vertical refresh rate.
Value Description
bits_per_pixel The number of bits per pixel to use for color. The
default value is the default for the operating system
being deployed.
Example
[Settings]
Priority=Default
[Default]
BitsPerPel=32
VRefresh=60
XResolution=1024
YResolution=768
BuildID
Identifies the operating system task sequence to be deployed to the target
computer. You create the task sequence ID on the Task Sequences node in the
Deployment Workbench. The BuildID property allows alphanumeric characters,
hyphens (-), and underscores (_). The BuildID property cannot be blank or
contain spaces.
Value Description
build_id Identifier of the operating system task sequence as
defined in the Deployment Workbench for the target
operating system being deployed
Note Make certain to use the TaskSequenceID specified in the
Deployment Workbench user interface (UI) and not the GUID of
the TaskSequenceID.
Example
[Settings]
Priority=Default
[Default]
BuildID=Vista_BareMetal
CapableArchitecture
The processor architecture of the processor supported by the target computer,
not the current processor architecture that is running. For example, when running
a 32-bit-compatible operating system on a 64-bit processor,
CapableArchitecture will indicate that the processor architecture is 64 bit.
Use the Architecture property to see the processor architecture that is currently
running.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
x86 Processor architecture is 32 bit.
x64 Processor architecture is 64 bit.
Example
Example
None
CaptureGroups
Controls whether the group membership of local groups on the target computer is
captured. This group membership is captured during the State Capture Phase
and is restored during the State Restore Phase.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
NO Captures no group membership information.
ALL Captures the membership of all local groups on the
target computer.
YES Captures the membership of the Administrator and
Power Users built-in groups and the groups listed in
the groups’ properties. This is the default value if
some other value is specified. (YES is the typical
value.)
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
CaptureGroups=YES
Groups1=NYC Application Management
Groups2=NYC Help Desk Users
ChildName
Specifies whether to append the DNS label at the beginning of the name of an
existing directory service domain when installing a child domain.
Value Description
name The name of the child domain
Example
[Settings]
Priority=Default
[Default]
ChildName=childdom.parentdom.WoodGroveBank.com
ComputerBackupLocation
The network shared folder where the computer backup is stored. If the target
folder does not already exist, it is automatically created.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
blank Same as AUTO.
UNC_path The UNC path to the network shared folder where the
backup is stored.
AUTO Creates a backup on a local hard disk if space is
available. Otherwise, the backup is saved to a network
location specified in the BackupShare and
BackupDir properties.
NETWORK Creates a backup on a network location specified in
BackupShare and BackupDir.
NONE No backup will be performed.
Example
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
ComputerBackupLocation=NETWORK
BackupShare=\\NYC-AM-FIL-01\Backup$
BackupDir=%OSDComputerName%
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
UserDataLocation=NONE
ComputerName
This property has been deprecated. Use OSDComputerName instead.
Value Description
None None
Example
None
ConfigFileName
Specifies the name of the configuration file used during OEM deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
file_name Specifies the name of the configuration file used
during OEM deployments
Example
None
ConfigFilePackage
Specifies the package ID for the configuration package used during OEM
deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
package Specifies the package ID for the configuration
package used during OEM deployments
Example
None
ConfirmGC
Specifies whether the replica is also a global catalog.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
YES Makes the replica a global catalog if the backup was a
global catalog.
NO Does not make the replica a global catalog.
Example
[Settings]
Priority=Default
[Default]
ConfirmGC=YES
CountryCode
The country code to be configured for the operating system on the target
computer. This property allows only numeric characters. This value is inserted
into the appropriate configuration settings in Unattend.txt or Sysprep.inf for
Windows XP and Windows Server 2003 or in Unattend.xml for Windows Vista
and later operating systems.
Value Description
country_code The country code where the target computer is to be
deployed
Example
[Settings]
Priority=Default
[Default]
AreaCode=206
CountryCode=001
Dialing=TONE
LongDistanceAccess=9
CriticalReplicationOnly
Specifies whether the promotion operation performs only critical replication and
then continues, skipping the noncritical (and potentially lengthy) portion of
replication.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
YES Skips noncritical replication
NO Does not skip noncritical replication
Example
[Settings]
Priority=Default
[Default]
CriticalReplicationOnly=YES
CustomDriverSelectionProfile
Specifies the custom selection profile used during driver installation.
Value Description
profile Custom selection profile used during driver installation
Example
[Settings]
Priority=Default
[Default]
CustomDriverSelectionProfile=CustomDrivers
CustomPackageSelectionProfile
Specifies the custom selection profile used during package installation.
Value Description
profile Custom selection profile used during package
installation
Example
[Settings]
Priority=Default
[Default]
CustomPackageSelectionProfile=CustomPackages
CustomWizardSelectionProfile
Specifies the custom selection profile used by the wizard for filtering the display
of various items.
Value Description
profile Custom selection profile by the wizard for filtering the
display of various items
Example
[Settings]
Priority=Default
[Default]
CustomWizardSelectionProfile=CustomWizard
Database
The property that specifies the database to be used for querying property values
from columns in the table specified in the Table property. The database resides
on the computer specified in the SQLServer property. The instance of Microsoft
SQL Server® on the computer is specified in the Instance property.
Value Description
database The name of the database to be used for querying
property values
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
[Computers]
SQLServer=NYC-SQL-01
SQLShare=SQL$
Database=MDTDB
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
DatabasePath
Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the
target computer that contains the domain database.
Value Description
path Specifies the fully qualified, non-UNC path to a
directory on a fixed disk of the local computer that
contains the domain database
Example
[Settings]
Example
Priority=Default
[Default]
DatabasePath=%DestinationLogicalDrive%\Windows\NTSD
DBID
Specifies the user account used to connect to the computer running SQL Server
(specified by the SQLServer property) using SQL Server authentication. The
DBPwd property provides the password for the user account in the DBID
property.
Note SQL Server authentication is not as secure as Integrated Windows authentication.
Integrated Windows authentication is the recommended authentication method. Using the DBID
and DBPwd properties stores the credentials in clear text in the CustomSettings.ini file and
therefore is not secure. For more information about using Integrated Windows authentication, see
the SQLShare property.
Note This property is configurable only by manually editing the CustomSettings.ini and
BootStrap.ini files.
Value Description
user_id The name of the user account credentials used to
access the computer running SQL Server using
SQL Server authentication
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
[Computers]
SQLServer=NYC-SQL-01
DBID=SQL_User-01
DBPwd=<complex_password>
NetLib=DBNMPNTW
Database=MDTDB
Example
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
DBPwd
Specifies the password for the user account specified in the DBID property. The
DBID and DBPwd properties provide the credentials for performing SQL Server
authentication to the computer running SQL Server (specified by the SQLServer
property).
Note SQL Server authentication is not as secure as Integrated Windows authentication.
Integrated Windows authentication is the recommended authentication method. Using the DBID
and DBPwd properties stores the credentials in clear text in the CustomSettings.ini file and
therefore is not secure. For more information about using Integrated Windows authentication, see
the SQLShare property.
Note This property is configurable only by manually editing the CustomSettings.ini and
BootStrap.ini files.
Value Description
user_password The password for the user account credentials
specified in the DBID property for using SQL Server
authentication
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
[Computers]
SQLServer=NYC-SQL-01
DBID=SQL_User-01
DBPwd=<complex_password>
NetLib=DBNMPNTW
Database=MDTDB
Example
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
Debug
Controls the verbosity of messages written to the MDT log files. This property
can be configured to help assist in troubleshooting deployments by providing
extended information about the MDT deployment process.
You can set this property by starting the LiteTouch.vbs script with the
/debug:true command-line parameter as follows:
cscript.exe LiteTouch.vbs /debug:true
After the LiteTouch.vbs script is started, the Debug property’s value is set to
TRUE, and all other scripts are automatically read the value of this property and
provide verbose information.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or in the MDT DB. Treat this property as read only.
Value Description
TRUE Debug logging is enabled, which includes the
following:
Verbose messages are logged.
Deprecated messages are logged as errors.
FALSE Debug logging is not enabled. This is the default
value.
Example
None
DefaultGateway
The IP address of the default gateway being used by the target computer. The
format of the IP address returned by the property is standard dotted-decimal
notation; for example, 192.168.1.1. Use this property to create a subsection that
Value Description
default_gateway The IP address of the default gateway in standard
dotted-decimal notation
Example
[Settings]
Priority=DefaultGateway, Default
[Default]
OSInstall=YES
[DefaultGateway]
192.168.0.1=HOUSTON
11.1.1.11=REDMOND
172.28.20.1=REDMOND
[REDMOND]
Packages001=XXX00004:Program4
Packages002=XXX00005:Program5
[HOUSTON]
Packages001=XXX00006:Program6
Packages002=XXX00007:Program7
Packages003=XXX00008:Program8
DeployDrive
The value used by the scripts to access files and run programs in the deployment
share that the Deployment Workbench creates. The property returns the drive
letter mapped to the DeployRoot property. ZTIApplications.wsf uses the
DeployDrive property when running any command-line programs with a .cmd or
.bat extension.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
drive_letter The letter designation for the logical drive where the
target operating system is to be installed (such as C or
D)
Example
None
DeploymentMethod
The method being used for the deployment (UNC, media, Configuration
Manager 2012, or Configuration Manager 2007 R3).
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
UNC The deployment is made to the target computer over
the network.
Media The deployment is made from local media (such as
DVD or hard disk) at the target computer.
SCCM ZTI uses this method for Configuration Manager 2012
or Configuration Manager 2007 R3.
Example
None
DeploymentType
The type of deployment being performed based on the deployment scenario. For
ZTI, this property is set dynamically by MDT scripts and is not configured in
CustomSettings.ini. For LTI, you can bypass the page in the Windows
Deployment Wizard on which the deployment type is selected. In addition, you
can specify the deployment type by passing one of the values listed below to the
LiteTouch.wsf script as a command-line option.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
NEWCOMPUTER The target computer is a new computer that has never
been a member of the network.
REFRESH The target computer is an existing computer on the
network that needs the desktop environment standard
to be redeployed.
REPLACE An existing computer on the network is being replaced
with a new computer. The user state migration data is
transferred from the existing computer to a new
computer.
Example
[Settings]
Priority=Default
[Default]
DeploymentType=NEWCOMPUTER
DeployRoot
Specifies the UNC or local path to the folder that is the root of the folder structure
that MDT uses. This folder structure contains configuration files, scripts, and
other folders and files that MDT uses. The value of this property is set based on
the following MDT deployment technologies:
LTI. This property is the UNC path to the deployment share that the
Deployment Workbench creates. Use this property to select a specific
deployment share. The most common use of this property is in the
BootStrap.ini file to identify a deployment share before the connection to the
Value Description
path The UNC or local path to the .
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
UserDataLocation=NONE
DestinationDisk
Disk number that the image will be deployed to.
Value Description
disk_number The number of the disk to which the image will be
deployed
Example
[Settings]
Priority=Default
Example
[Default]
DestinationDisk=0
DestinationLogicalDrive
The logical drive to which the image will be deployed.
Value Description
logical_drive_number The logical drive to which the image will be deployed
Example 1
[Settings]
Priority=Default
[Default]
DestinationLogicalDrive=0
Example 2
[Settings]
Priority=Default
[Default]
InstallDNS=YES
DomainNetBIOSName=WoodGroveBank
NewDomain=Child
DomainLevel=3
ForestLevel=3
NewDomainDNSName=newdom.WoodGroveBank.com
ParentDomainDNSName=WoodGroveBank.com
AutoConfigDNS=YES
ConfirmGC=YES
CriticalReplicationOnly=NO
ADDSUserName=Administrator
ADDSUserDomain=WoodGroveBank
ADDSPassword=<complex_password>
Example 2
DatabasePath=%DestinationLogicalDrive%\Windows\NTDS
ADDSLogPath=%DestinationLogicalDrive%\Windows\NTDS
SysVolPath=%DestinationLogicalDrive%\Windows\SYSVOL
SafeModeAdminPassword=<complex_password>
DestinationPartition
Disk partition to which the image will be deployed.
Value Description
partition_number The number of the partition to which the image will be
deployed
Example
[Settings]
Priority=Default
[Default]
DestinationPartition=1
DHCPScopes
Specifies the number of DHCP scopes to configure.
Value Description
scopes Specifies the number of DHCP scopes to configure
Example
[Settings]
Priority=Default
Example
[Default]
DHCPScopes=1
DHCPScopesxDescription
The description of the DHCP scope.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
description The description of the DHCP scope
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0Description=DHCPScope0
DHCPScopesxEndIP
Specifies the ending IP address for the DHCP scope.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
end_IP Specifies the ending IP address for the DHCP scope
Example
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0EndIP=192.168.0.30
DHCPScopesxExcludeEndIP
Specifies the ending IP address for the DHCP scope exclusion. IP addresses
that are excluded from the scope are not offered by the DHCP server to clients
obtaining leases from this scope.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
exclude_end_IP Specifies the ending IP address for the DHCP scope
exclusion
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0ExcludeEndIP=192.168.0.15
DHCPScopesxExcludeStartIP
Specifies the starting IP address for the DHCP scope exclusion. IP addresses
that are excluded from the scope are not offered by the DHCP server to clients
obtaining leases from this scope.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
exclude_start_IP Specifies the starting IP address for the DHCP scope
exclusion
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0ExcludeStartIP=192.168.0.10
DHCPScopesxIP
Specifies the IP subnet of the scope.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
IP Specifies the IP subnet of the scope
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0IP=192.168.0.0
DHCPScopesxName
A user-definable name to be assigned to the scope.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
name A user-definable name to be assigned to the scope
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0Name=DHCPScope0
DHCPScopesxOptionDNSDomainName
Specifies the domain name that the DHCP client should use when resolving
unqualified domain names with the DNS. For DHCP clients running Windows XP
and Windows Server 2003, the DNS Domain Name option becomes the
connection-specific DNS name assigned to the DHCP-configured interface. The
connection-specific DNS name is used to construct fully qualified domain names
that are registered using DNS dynamic update.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
DNS_domain_name Specifies the domain name that the DHCP client
should use when resolving unqualified domain names
with the DNS
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0OptionDNSDomainName=WoodGroveBank.com
DHCPScopesxOptionDNSServer
Specifies a list of IP addresses for DNS name servers available to the client.
When more than one server is assigned, the client interprets and uses the
addresses in the specified order.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
DNS_server Specifies a list of IP addresses for DNS name servers
available to the client
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0OptionDNSServer=192.168.0.2
DHCPScopesxOptionLease
The duration that the DHCP lease is valid for the client.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
lease The duration that the DHCP lease is valid for the client
Example
[Settings]
Priority=Default
Example
[Default]
DHCPScopes0OptionLease=7
DHCPScopesxOptionNBTNodeType
Specifies the client node type for NetBT clients.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
1 Configures the node type as b-node
2 Configures the node type as p-node
4 Configures the node type as m-node
8 Configures the node type as h-node
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0OptionNBTNodeType=4
DHCPScopesxOptionPXEClient
Specifies the IP address used for PXE client bootstrap code.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
Value Description
PXE_client Specifies the IP address used for PXE client bootstrap
code
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0OptionPXEClient=192.168.0.252
DHCPScopesxOptionRouter
Specifies a list of IP addresses for routers on the client subnet. When more than
one router is assigned, the client interprets and uses the addresses in the
specified order. This option is normally used to assign a default gateway to
DHCP clients on a subnet.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
router Specifies a list of IP addresses for routers on the client
subnet
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0OptionRouter=192.168.0.253
DHCPScopesxOptionWINSServer
Specifies the IP addresses to be used for NBNSes on the network.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
WINS_server Specifies the IP addresses to be used for NBNSes on
the network
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0OptionWINSServer=192.168.0.2
DHCPScopesxStartIP
The starting IP address for the range of IP addresses that are to be included in
the scope.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
start_IP The starting IP address for the range of IP addresses
that are to be excluded from the scope
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0StartIP=192.168.0.20
DHCPScopesxSubnetMask
Specifies the subnet mask of the client subnet.
Note The x in this properties name is a placeholder for a zero-based array that contains DHCP
configurations.
Value Description
subnet_mask Specifies the subnet mask of the client IP subnet
Example
[Settings]
Priority=Default
[Default]
DHCPScopes0SubnetMask=255.255.255.0
DHCPServerOptionDNSDomainName
Specifies the connection-specific DNS domain suffix of client computers.
Value Description
DNS_domain_name Specifies the connection-specific DNS domain suffix of
client computers
Example
[Settings]
Priority=Default
[Default]
DHCPServerOptionDNSDomainName=Fabrikam.com
DHCPServerOptionDNSServer
Specifies a list of IP addresses to be used as DNS name servers that are
available to the client.
Value Description
DNS_server Specifies a list of IP addresses to be used as DNS
name servers that are available to the client
Example
[Settings]
Priority=Default
[Default]
DHCPServerOptionDNSServer=192.168.0.1,192.168.0.2
DHCPServerOptionNBTNodeType
Specifies the client node type for NetBT clients.
Value Description
1 Configures the node type as b-node
2 Configures the node type as p-node
4 Configures the node type as m-node
8 Configures the node type as h-node
Example
[Settings]
Priority=Default
[Default]
DHCPServerOptionNBTNodeType=4
DHCPServerOptionPXEClient
Specifies the IP address used for PXE client bootstrap code.
Value Description
PXE_client Specifies the IP address used for PXE client bootstrap
code
Example
[Settings]
Priority=Default
[Default]
DHCPServerOptionPXEClient=192.168.0.252
DHCPServerOptionRouter
Specifies a list of IP addresses for routers on the client subnet. When more than
one router is assigned, the client interprets and uses the addresses in the
specified order. This option is normally used to assign a default gateway to
DHCP clients on a subnet.
Value Description
router Specifies a list of IP addresses for routers on the client
subnet
Example
[Settings]
Priority=Default
[Default]
DHCPServerOptionRouter=192.168.0.253
DHCPServerOptionWINSServer
Specifies the IP addresses to be used for NBNSes on the network.
Value Description
WINS_server Specifies the IP addresses to be used for NBNSes on
the network
Example
[Settings]
Priority=Default
[Default]
DHCPServerOptionWINSServer=192.168.0.2
Dialing
The type of dialing supported by the telephony infrastructure where the target
computer is located. This value is inserted into the appropriate configuration
settings in Unattend.txt or Sysprep.inf for Windows XP and Windows
Server 2003 or in Unattend.xml for Windows Vista and later operating systems.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
PULSE The telephony infrastructure supports pulse dialing.
TONE The telephony infrastructure supports touch-tone
dialing.
Example
[Settings]
Priority=Default
Example
[Default]
AreaCode=206
CountryCode=001
Dialing=TONE
LongDistanceAccess=9
DisableTaskMgr
This property controls a user’s ability to start Task Manager by pressing
CTRL+ALT+DEL. After the user starts Task Manager, he or she could interrupt
the LTI task sequence while running in the new operating system on the target
computer. This property is used in conjunction with the HideShell property and is
only valid when the HideShell property is set to YES.
Note This property and the HideShell property must both be set to YES to prevent the user
pressing CTRL+ALT+DEL and interrupting the LTI task sequence.
Value Description
YES Prevent the user from being able to start Task
Manager by pressing CTRL+ALT+DEL and
subsequently interrupting the LTI task sequence.
NO Allow the user to start Task Manager by pressing
CTRL+ALT+DEL and subsequently interrupt the LTI
task sequence. This is the default value.
Example
[Settings]
Priority=Default
[Default]
DisableTaskMgr=YES
HideShell=YES
DNSServerOptionBINDSecondaries
Determines whether to use fast transfer format for transfer of a zone to DNS
servers running legacy BIND implementations.
By default, all Windows-based DNS servers use a fast zone transfer format. This
format uses compression, and it can include multiple records per TCP message
during a connected transfer. This format is also compatible with more recent
BIND-based DNS servers that run version 4.9.4 and later.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
TRUE Allows BIND secondaries
FALSE Does not allow to BIND secondaries
Example
[Settings]
Priority=Default
[Default]
DNSServerOptionBINDSecondaries=TRUE
DNSServerOptionDisableRecursion
Determines whether or not the DNS server uses recursion. By default, the DNS
Server service is enabled to use recursion.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
TRUE Disables recursion on the DNS server
FALSE Enables recursion on the DNS server
Example
[Settings]
Example
Priority=Default
[Default]
DNSServerOptionDisableRecursion=TRUE
DNSServerOptionEnableNetmaskOrdering
Determines whether the DNS server reorders address (A) resource records
within the same resource record that is set in the server's response to a query
based on the IP address of the source of the query.
By default, the DNS Server service uses local subnet priority to reorder A
resource records.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
TRUE Enables netmask ordering
FALSE Disables netmask ordering
Example
[Settings]
Priority=Default
[Default]
DNSServerOptionEnableNetmaskOrdering=TRUE
DNSServerOptionEnableRoundRobin
Determines whether the DNS server uses the round robin mechanism to rotate
and reorder a list of resource records if multiple resource records exist of the
same type that exist for a query answer.
By default, the DNS Server service uses round robin.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
TRUE Enables round robin
FALSE Disables round robin
Example
[Settings]
Priority=Default
[Default]
DNSServerOptionEnableRoundRobin=TRUE
DNSServerOptionEnableSecureCache
Determines whether the DNS server attempts to clean up responses to avoid
cache pollution. This setting is enabled by default. By default, DNS servers use a
secure response option that eliminates adding unrelated resource records that
are included in a referral answer to their cache. In most cases, any names that
are added in referral answers are typically cached, and they help expedite the
resolution of subsequent DNS queries.
With this feature, however, the server can determine that referred names are
potentially polluting or insecure and then discard them. The server determines
whether to cache the name that is offered in a referral on the basis of whether it
is part of the exact, related, DNS domain name tree for which the original queried
name was made.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
TRUE Enables cache security
FALSE Disables cache security
Example
[Settings]
Priority=Default
[Default]
DNSServerOptionEnableSecureCache=TRUE
DNSServerOptionFailOnLoad
Specifies that loading of a zone should fail when bad data is found.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
TRUE Enable fail on load
FALSE Disable fail on load
Example
[Settings]
Priority=Default
[Default]
DNSServerOptionFailOnLoad=TRUE
DNSServerOptionNameCheckFlag
Specifies which character standard is used when checking DNS names.
Value Description
0 Uses ANSI characters that comply with Internet
Engineering Task Force (IETF) Request for
Value Description
Comments (RFCs). This value corresponds to the
Strict RFC(ANSI) selection when configuring DNS in
the Deployment Workbench.
1 Uses ANSI characters that do not necessarily comply
with IETF RFCs. This value corresponds to the Non
RFC (ANSI) selection when configuring DNS in the
Deployment Workbench.
2 Uses multibyte UCS Transformation Format 8 (UTF-8)
characters. This is the default setting. This value
corresponds to the Multibyte (UTF-8) selection when
configuring DNS in the Deployment Workbench.
3 Uses all characters. This value corresponds to the All
names selection when configuring DNS in the
Deployment Workbench.
Example
[Settings]
Priority=Default
[Default]
DNSServerOptionNameCheckFlag=2
DNSZones
Specifies the number of DNS zones to configure.
Value Description
zones Specifies the number of DNS zones to configure
Example
[Settings]
Priority=Default
[Default]
DNSZones=1
DNSZones0Name=MyNewZone
Example
DNSZones0DirectoryPartition=Forest
DNSZones0FileName=MyNewZone.dns
DNSZones0MasterIP=192.168.0.1,192.168.0.2
DNSZones0Type=Secondary
DNSZonesxDirectoryPartition
Specifies the directory partition on which to store the zone when configuring
secondary or stub zones.
Note The x in this properties name is a placeholder for a zero-based array that contains DNS
configurations.
Value Description
Domain Replicates zone data to all DNS server in the AD DS
domain
Forest Replicates zone data to all DNS server in the AD DS
forest
Legacy Replicates zone data to all domain controllers in the
AD DS domain
Example
[Settings]
Priority=Default
[Default]
DNSZones0DirectoryPartition=Forest
DNSZonesxFileName
Specifies the name of the file that will store the zone information.
Note The x in this properties name is a placeholder for a zero-based array that contains DNS
configurations.
Value Description
file_name Specifies the name of the file that will store the zone
information
Example
[Settings]
Priority=Default
[Default]
DNSZones0FileName=MyNewZone.dns
DNSZonesxMasterIP
A comma delimited list of IP addresses of the master servers to be used by the
DNS server when updating the specified secondary zones. This property must be
specified when configuring a secondary or stub DNS zone.
Note The x in this properties name is a placeholder for a zero-based array that contains DNS
configurations.
Value Description
IP1,IP2 A comma-delimited list of IP addresses of the master
servers
Example
[Settings]
Priority=Default
[Default]
DNSZones0MasterIP=192.168.0.1,192.168.0.2
DNSZonesxName
Specifies the name of the zone.
Note The x in this properties name is a placeholder for a zero-based array that contains DNS
configurations.
Value Description
name Specifies the name of the zone
Example
[Settings]
Priority=Default
[Default]
DNSZones0Name=MyNewZone
DNSZonesxScavenge
Configures the Primary DNS server to ―scavenge‖ stale records—that is, to
search the database for records that have aged and delete them.
Note The x in this properties name is a placeholder for a zero-based array that contains DNS
configurations.
Value Description
TRUE Allow stale DNS records to be scavenged.
FALSE Do not allow stale DNS records to be scavenged.
Example
[Settings]
Priority=Default
[Default]
DNSZones0Scavenge=TRUE
DNSZonesxType
Specifies the type of zone to create.
Note The x in this properties name is a placeholder for a zero-based array that contains DNS
configurations.
Value Description
DSPrimary Creates a primary zone and specifying that it should
be stored in AD DS on a DNS server configured as a
domain controller
DSStub Creates a stub zone and specifying that it should be
stored in AD DS on a DNS server configured as a
domain controller
Primary Creates a primary zone
Secondary Creates a secondary zone
Stub Creates a stub zone
Example
[Settings]
Priority=Default
[Default]
DNSZones0Type=Secondary
DNSZonesxUpdate
Configures the Primary DNS server to perform dynamic updates.
Note The x in this properties name is a placeholder for a zero-based array that contains DNS
configurations.
Value Description
Value Description
0 Does not allow dynamic updates
1 Allows dynamic updates
2 Allows secure dynamic updates
Example
[Settings]
Priority=Default
[Default]
DNSZones0Update=1
DoCapture
Indicator of whether an image of the target computer is to be captured. If it is,
Sysprep is run on the target computer to prepare for image creation. After
Sysprep has run, a new WIM image is created and stored in the folder within the
shared folder designated for target computer backups (BackupDir and
BackupShare, respectively).
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
YES Copy the necessary files to run Sysprep on the target
computer (for Windows XP and Windows
Server 2003), run Sysprep on the target computer,
and capture a WIM image.
NO Do not run Sysprep on the target computer, and do
not capture a WIM image.
PREPARE Copy the necessary files to run Sysprep on the target
computer (for Windows XP and Windows
Server 2003), but do not run Sysprep or other image-
capture processes.
SYSPREP Copy the necessary files to run Sysprep on the target
computer (for Windows XP and Windows
Server 2003), run Sysprep on the target computer, but
do not capture a WIM image.
Value Description
Note The primary purpose of this value is to allow the creation of
a VHD that contains an operating system after Sysprep has been
run and no image capture is necessary.
Example
[Settings]
Priority=Default
[Default]
DoCapture=YES
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
DomainAdmin
The user account credentials used to join the target computer to the domain
specified in JoinDomain. Specify as Domain\UserName or
[email protected].
Note For ZTI, the credentials that Configuration Manager 2012 or Configuration
Manager 2007 R3specifies typically are used. If the DomainAdmin property is specified, the
credentials in the DomainAdmin property override the credentials that Configuration
Manager 2012 or Configuration Manager 2007 R3 specifies.
Value Description
domain_admin The name of the user account credentials
Example
[Settings]
Priority=Default
[Default]
DomainAdmin=NYCAdmin
DomainAdminDomain=WOODGROVEBANK
DomainAdminPassword=<complex_password>
DomainAdminDomain
The domain in which the user’s credentials specified in DomainAdmin reside.
Note For ZTI, the credentials that Configuration Manager 2012 or Configuration
Manager 2007 R3specifies typically are used. If the DomainAdmin property is specified, the
credentials in the DomainAdmin property override the credentials that Configuration
Manager 2012 or Configuration Manager 2007 R3 specifies.
Value Description
domain_admin_domain The name of the domain where the user account
credentials reside
Example
[Settings]
Priority=Default
[Default]
DomainAdmin=NYCAdmin
DomainAdminDomain=WOODGROVEBANK
DomainAdminPassword=<complex_password>
DomainAdminPassword
The password used for the domain Administrator account specified in the
DomainAdmin property to join the computer to the domain.
Note For ZTI, the credentials that Configuration Manager 2012 or Configuration Manager 2007 R3
specifies typically are used. If the DomainAdmin property is specified, the credentials in the
DomainAdmin property override the credentials that Configuration Manager 2012 or Configuration
Manager 2007 R3 specifies.
Value Description
domain_admin_password The password for the domain Administrator account
on the target computer
Example
[Settings]
Priority=Default
[Default]
DomainAdmin=NYCAdmin
DomainAdminDomain=WOODGROVEBANK
DomainAdminPassword=<complex_password>
DomainLevel
This entry specifies the domain functional level. This entry is based on the levels
that exist in the forest when a new domain is created in an existing forest.
Value Description
Level Sets the domain functional level to one of the
following:
2, Windows Server 2003
3, Windows Server 2008
4, Windows Server 2008 R2
Example
[Settings]
Priority=Default
[Default]
DomainLevel=3
DomainNetBiosName
Assigns a NetBIOS name to the new domain.
Value Description
Name Assigns a NetBIOS name to the new domain
Example
[Settings]
Priority=Default
[Default]
DomainNetBiosName=NewDom
DomainOUs
A list of AD DS organizational units (OUs) where the target computer account
can be created. The DomainOUs property lists text values that can be any non-
blank value. The DomainOUs property has a numeric suffix (for example,
DomainOUs1 or DomainOUs2). The values specified by DomainOUs will be
displayed in the Deployment Wizard and selectable by the user. The
MachineObjectOU property will then be set to the OU selected.
In addition, the same functionality can be provided by configuring the
DomainOUList.xml file. The format of the DomainOUList.xml file is as follows:
<?xml version="1.0" encoding="utf-8"?>
<DomainOUs>
<DomainOU>
OU=Computers,OU=Tellers,OU=NYC,DC=WOODGROVEBANK,DC=Com
</DomainOU>
<DomainOU>
OU=Computers,OU=Managers,OU=NYC,DC=WOODGROVEBANK,DC=Com
</DomainOU>
</DomainOUs>
Value Description
OU The OU in which the target computer account can be
created
Example
[Settings]
Priority=Default
Example
[Default]
OSInstall=Y
DomainOUs1=OU=Computers, OU=Tellers, OU=NYC,
DC=WOODGROVEBANK, DC=Com
DomainOUs2=OU=Computers, OU=Managers, OU=NYC,
DC=WOODGROVEBANK, DC=Com
DoNotCreateExtraPartition
Specifies that deployments of Windows 7 and Windows Server 2008 R2 will not
create the 300 MB system partition.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
YES The additional system partition will not be created.
NO The additional system partition will be created.
Example
[Settings]
Priority=Default
[Default]
OSInstall=Y
DoNotCreateExtraPartition=YES
DriverGroup
A list of text values that associates out-of-box drivers created in the Deployment
Workbench with each other (typically based on the make and model of a
computer). A driver can be associated with one or more driver groups. The
DriverGroup property allows the drivers within one or more groups to be
deployed to a target computer.
The text values in the list can be any non-blank value. The DriverGroup property
value has a numeric suffix (for example, DriverGroup001 or DriverGroup002).
Value Description
driver_group_name The name of the driver group defined in the
Deployment Workbench
Example
[Settings]
Priority=Make, Default
[Default]
DriverGroup001=Shared Drivers
::
[Mfgr01]
DriverGroup001=Mfgr01 Video Drivers
DriverGroup002=Mfgr01 Network Drivers
[Mfgr02]
DriverGroup001=Mfgr02 Drivers
DriverInjectionMode
This property is used to control the device drivers that are injected by the Inject
Drivers task sequence step.
Value Description
Value Description
Auto Inject only matching drivers from the selection profile
or folder. This is the same behavior as MDT 2008,
which injects all drivers that matched one of the plug
and play (PnP) identifiers (IDs) on the target
computer.
All Inject all drivers in the selection profile or folder.
Example
[Settings]
Priority=Default
[Default]
DriverInjectionMode=ALL
DriverSelectionProfile=Nothing
DriverPaths001=\\NYC-AM-FIL-01\Drivers$
DriverPaths002=\\NYC-AM-FIL-03\VistaDrvs
DriverPaths
A list of UNC paths to shared folders where additional device drivers are located.
These device drivers are installed with the target operating system on the target
computer. The MDT scripts copy the contents of these folders to the C:\Drivers
folder on the target computer. The DriverPaths property is a list of text values
that can be any non-blank value. The DriverPaths property has a numeric suffix
(for example, DriverPaths001 or DriverPaths002).
Value Description
UNC_path UNC path to the shared folder in which the additional
drivers reside
Example
[Settings]
Priority=Default
[Default]
DriverPaths001=\\NYC-AM-FIL-01\Drivers$
DriverPaths002=\\NYC-AM-FIL-03\VistaDrvs
DriverSelectionProfile
Profile name used during driver installation.
Value Description
profile_name None
Example
[Settings]
Priority=Default
[Default]
DriverSelectionProfile=MonitorDrivers
EventShare
The EventShare property points to a shared folder in which the MDT scripts
record events.
By default, the shared folder is created in C:\Events.
Value Description
UNC_path The UNC path to the shared folder in which the MDT
scripts record events. The default share name is
Events.
Example
[Settings]
Priority=Default
[Default]
EventShare=\\NYC-AM-FIL-01\Events
Example
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
FinishAction
Specifies the action to be taken when an LTI task sequence finishes, which is
after the Summary wizard page in the Windows Deployment Wizard.
Tip Use this property in conjunction with the SkipFinalSummary property to skip the Summary
wizard page in the Windows Deployment Wizard and automatically perform the action.
Caution This property value must be specified in uppercase so that the deployment scripts can
read it properly.
Value Description
action Where action is one of the following:
SHUTDOWN. Shuts down the target computer.
REBOOT. Restarts the target computer.
RESTART. Same as REBOOT.
LOGOFF. Log off the current user. If the target
computer is currently running Windows PE, then
the target computer will be restarted.
blank. Exit the Windows Deployment Wizard
without performing any additional actions. This is
the default setting.
Example
[Settings]
Priority=Default
[Default]
FinishAction=REBOOT
ForceApplyFallback
Controls the method used for installed Windows 7, Windows Vista, Windows
Server 2008 R2, and Windows Server 2008 operating systems. These operating
systems can be installed using:
Value Description
NEVER MDT always uses the imagex.exe method if
necessary. Only task sequences that deploy an
operating system that matches the boot image are
displayed in the Deployment Wizard.
Any other value, MDT attempts to install the operating system using the
including blank setup.exe method but falls back to the imagex.exe
method, if necessary. Any task sequence that
supports the imagex.exe method is displayed in the
Deployment Wizard.
Example
[Settings]
Priority=Default
[Default]
OSInstall=YES
ForceApplyFallback=NEVER
ForestLevel
This entry specifies the forest functional level when a new domain is created in a
new forest.
Value Description
level Sets the domain functional level to one of the
following:
2, Windows Server 2003
3, Windows Server 2008
4, Windows Server 2008 R2
Example
[Settings]
Priority=Default
[Default]
ForestLevel=3
FullName
The full name of the user of the target computer provided during the installation
of the operating system. This value is inserted into the appropriate configuration
settings in Unattend.txt or Sysprep.inf for Windows XP and Windows
Server 2003 or in Unattend.xml for Windows Vista and later operating systems.
Note This value is different from the user credentials created after the operating system is
deployed. The FullName property is provided as information to systems administrators about the
user running applications on the target computer.
Value Description
full_name The full name of the user of the target computer
Example
[Settings]
Priority=MACAddress, Default
Properties=CustomProperty, ApplicationInstall
Example
[Default]
CustomProperty=TRUE
OrgName=Woodgrove Bank
[00:0F:20:35:DE:AC]
OSDNEWMACHINENAME=HPD530-1
ApplicationInstall=Custom
FullName=Woodgrove Bank User
[00:03:FF:FE:FF:FF]
OSDNEWMACHINENAME=BVMXP
ApplicationInstall=Minimum
FullName=Woodgrove Bank Manager
GPOPackPath
This property is used to override the default path to the folder in which the GPO
packs reside. The path specified in this property is relative to the
Templates\GPOPacks folder in a distribution share. MDT automatically scans a
specific subfolder of this folder based on the operating system being deployed to
the target computer, such as Templates\GPOPacks\operating_system (where
operating_system is the operating system being deployed). Table 3 list the
supported operating systems and the subfolders that correspond to each
operating system.
Table 3. Windows Operating Systems and Corresponding GPO Pack
Subfolder
Value Description
Value Description
path The path relative to the
distribution_share\Templates\GPOPacks folder (where
distribution_share is the root folder of the distribution
share. The default value is the
distribution_share\Templates\GPOPacks\operating_system
folder (where operating_system is a subfolder based on
the operating system version).
In the example below, setting the GPOPackPath property
to a value of ―Win7-HighSecurity‖ configures MDT to use
the distribution_share\Templates\GPOPacks\Win7-
HighSecurity folder as the folder where the GPO packs are
stored.
Example
[Settings]
Priority=Default
[Default]
GPOPackPath=Win7-HighSecurity
Groups
The list of local groups on the target computer whose membership will be
captured. This group membership is captured during the State Capture Phase
and is restored during the State Restore Phase. (The default groups are
Administrators and Power Users.) The Groups property is a list of text values
that can be any non-blank value. The Groups property has a numeric suffix (for
example, Groups001 or Groups002).
Value Description
group_name The name of the local group on the target computer
for which group membership will be captured
Example
[Settings]
Priority=Default
[Default]
Example
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
CaptureGroups=YES
Groups001=NYC Application Management
Groups002=NYC Help Desk Users
HALName
The descriptive name of the hardware abstraction layer (HAL) currently running
on the target computer.
Note This property is required only for Windows XP and Windows Server 2003 deployment. Also,
This property is dynamically set by the MDT scripts and is not configured in CustomSettings.ini or
the MDT DB. Treat this property as read only.
Value Description
hal_name The name of the HAL running on the target computer
Example
None
HideShell
This property controls the display of Windows Explorer while the LTI task
sequence is running in the new operating system on the target computer.This
property can be used in conjunction with the DisableTaskMgr property.
Note This property can be used with the DisableTaskMgr property to help prevent users from
interrupting the LTI task sequence. For more information, see the DisableTaskMgr property.
Value Description
Value Description
YES Windows Explorer is hidden until the task sequence is
complete.
NO Windows Explorer is visible while the task sequence is
running. This is the default value.
Example
[Settings]
Priority=Default
[Default]
DisableTaskMgr=YES
HideShell=YES
OSHome_Page
The URL to be used as the Windows Internet Explorer® home page after the
target operating system is deployed.
Value Description
URL The URL of the web page to be used as the home
page for Internet Explorer on the target computer
Example
[Settings]
Priority=Default
[Default]
Home_Page=http://portal.woodgrovebank.com
HostName
The IP host name of the target computer (the name assigned to the target
computer).
Note This is the computer name of the target computer, not the NetBIOS computer name of the
target computer. The NetBIOS computer name can be shorter than the computer name. Also, this
property is dynamically set by the MDT scripts and is not configured in CustomSettings.ini or the
MDT DB. Treat this property as read only.
Value Description
host_name The IP host name assigned to the target computer
Example
None
ImagePackageID
The package ID used for the operating system to install during OEM
deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
None The package ID used for the operating system to
install during OEM deployments
Example
None
InputLocale
A list of input locales to be used with the target operating system. More than one
input locale can be specified for the target operating system. Each locale must be
separated by a semicolon (;). If not specified, the Windows Deployment Wizard
uses the input locale configured in the image being deployed.
Exclude this setting in the Windows User State Migration Tool (USMT) when
backing up and restoring user state information. Otherwise, the settings in the
user state information will override the values specified in the InputLocale
property.
Note This property is used only for deploying Windows XP and Windows Server 2003.
Value Description
input_locale1; The locale for the keyboard attached to the target
input_locale2 computer
Example
[Settings]
Priority=Default
[Default]
UserLocale=0409:00000409
InputLocale=0409:00000409;0413:00020409;0413:00000409;0409:00020409
InstallPackageID
The package ID used for the operating system to install during OEM
deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
None The package ID used for the operating system to
install during OEM deployments
Example
None
Instance
The instance of SQL Server used for querying property values from columns in
the table specified in the Table property. The database resides on the computer
specified in the SQLServer property. The instance of SQL Server on the
computer is specified in the Instance property.
Value Description
instance The name of the instance of SQL Server to be used
for querying property values
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
[Computers]
SQLServer=NYC-SQL-01
Database=MDTDB
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
IPAddress
The IP address of the target computer. The format of the IP address returned by
the property is standard dotted-decimal notation; for example, 192.168.1.1. Use
this property to create a subsection that contains settings targeted to a specific
target computer based on the IP address.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
ip_address The IP address of the target computer in standard
dotted-decimal notation
Example
None
IsDesktop
Indicator of whether the computer is a desktop, because the
Win32_SystemEnclosure ChassisType property value is 3, 4, 5, 6, 7, or 15.
Note Only one of the following properties will be true at a time: IsDesktop, IsLaptop, IsServer.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The target computer is a desktop computer.
FALSE The target computer is not a desktop computer.
Example
None
IsHypervisorRunning
Specifies whether the target computer is a virtual machine (VM), which was
indicated because a hypervisor was detected. This property is set using
information from the CPUID interface.
For further information collected about VMs and information returned from the
CPUID interface, see the following properties:
IsVM
SupportsHyperVRole
SupportsNX
SupportsVT
Supports64Bit
VMPlatform
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The target computer is a VM.
FALSE The target computer is physical computer.
Example
None
IsLaptop
Indicator of whether the computer is a portable computer, because the
Win32_SystemEnclosure ChassisType property value is 8, 10, 12, 14, 18, or
21.
Note Only one of the following properties will be true at a time: IsDesktop, IsLaptop, IsServer.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The target computer is a portable computer.
FALSE The target computer is not a portable computer.
Example
None
IsServer
Indicator of whether the computer is a server, because the
Win32_SystemEnclosure ChassisType property value is 23.
Note Only one of the following properties will be true at a time: IsDesktop, IsLaptop, IsServer.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The target computer is a server.
FALSE The target computer is not a server.
Example
None
IsServerCoreOS
Indicator of whether the current operating system running on the target computer
is the Server Core installation option of the Windows Server 2008 operating
system.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The operating system on the target computer is the
Server Core installation option of Windows
Server 2008.
FALSE The operating system on the target computer is not
the Server Core installation option of Windows
Server 2008.
Example
None
IsServerOS
Indicator of whether the current operating system running on the target computer
is a server operating system (such as Windows Server 2003).
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The operating system on the target computer is a
server operating system.
FALSE The operating system on the target computer is not a
server operating system.
Example
None
IsUEFI
Specifies whether the target computer is currently running with Unified Extensible
Firmware Interface (UEFI). The UEFI is a specification that defines a software
interface between an operating system and platform firmware. UEFI is a more
secure replacement for the older BIOS firmware interface present in some
personal computers. For more information on UEFI, go to http://www.uefi.org.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The target computer is currently running with UEFI.
FALSE The target computer is not currently running with
UEFI.
Note It is possible that the target computer may support UEFI,
but is running in a compatibility mode that emulates the older BIOS
firmware interface. In this situation this value of this property will
set to FALSE even though the target computer supports UEFI.
Example
None
IsVM
Specifies whether the target computer is a VM based on information gathered
from the CPUID interface. You can determine the specific VM environment using
the VMPlatform property.
For further information collected about VMs and information returned from the
CPUID interface, see the following properties:
IsHypervisorRunning
SupportsHyperVRole
SupportsNX
SupportsVT
Supports64Bit
VMPlatform
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The target computer is a VM.
FALSE The target computer is not a VM.
Example
None
JoinDomain
The domain that the target computer joins after the target operating system is
deployed. This is the domain where the computer account for the target
computer is created. The JoinDomain property can contain alphanumeric
characters, hyphens (-), and underscores (_). The JoinDomain property cannot
be blank or contain spaces.
Value Description
domain_name The name of the domain that the target computer joins
Example
[Settings]
Priority=Default
[Default]
JoinDomain=WOODGROVEBANK
MachineObjectOU=OU=Reception,OU=NYC,DC=Woodgrovebank,DC=com
JoinWorkgroup
The workgroup that the target computer joins after the target operating system is
deployed. The JoinWorkgroup property can contain alphanumeric characters,
hyphens (-), and underscores (_). The JoinWorkgroup property cannot be blank
or contain spaces.
Value Description
workgroup_name The name of the workgroup that the target computer
joins
Example
[Settings]
Priority=Default
[Default]
JoinWorkgroup=WDGV_WORKGROUP
KeyboardLocale
A list of keyboard locales to be used with the target operating system. More than
one keyboard locale can be specified for the target operating system. Each
locale must be separated by a semicolon (;). If not specified, the Windows
Deployment Wizard uses the keyboard locale configured in the image being
deployed.
Exclude this setting in USMT when backing up and restoring user state
information. Otherwise, the settings in the user state information will override the
values specified in the KeyboardLocale property.
Note This property is used only for deploying Windows Vista and Windows Server 2008. For this
property to function properly, it must be configured in both CustomSettings.ini and BootStrap.ini.
BootStrap.ini is processed before a deployment share (which contains CustomSettings.ini) has
been selected.
Value Description
keyboard_locale1; The locale of the keyboard attached to the target
keyboard_locale2 computer.
The value can be specified in the following formats:
Text (en-us)
Hexadecimal (0409:00000409)
Example 1
[Settings]
Priority=Default
[Default]
UserLocale=en-us
KeyboardLocale=en-us
Example 2
[Settings]
Priority=Default
[Default]
UserLocale=en-us
KeyboardLocale=0409:00000409;1809:00001809;041A:0000041A;08
3b:0001083b
KeyboardLocalePE
The name of the keyboard locale to be used while in Windows PE only.
Note For this property to function properly, it must be configured in both CustomSettings.ini and
BootStrap.ini. BootStrap.ini is processed before a deployment share (which contains
CustomSettings.ini) has been selected.
Value Description
keyboard_locale The locale of the keyboard attached to the target
computer.
The value can be specified in the following formats:
Text (en-us)
Hexadecimal (0409:00000409)
Example 1
[Settings]
Priority=Default
[Default]
KeyboardLocalePE=en-us
Example 2
[Settings]
Priority=Default
[Default]
KeyboardLocalePE=0409:00000409
LanguagePacks
A list of the GUIDs for the language packs to be deployed on the target
computer. Deployment Workbench specifies these language packs on the OS
Packages node. These GUIDs are stored in the Packages.xml file. The
LanguagePacks property has a numeric suffix (for example,
LanguagePacks001 or LanguagePacks002).
Value Description
language_pack_guid The GUID that the Deployment Workbench specifies
Value Description
for the language packs to install on the target
computer. The GUID corresponds to the language
pack GUID stored in Packages.xml.
Example
[Settings]
Priority=Default
[Default]
LanguagePacks001={a1923f8d-b07b-44c7-ac1e-353b7cc4c1ad}
LoadStateArgs
The arguments passed to the USMT Loadstate process. The ZTI script inserts
the appropriate logging, progress, and state store parameters. If this value is not
included in the settings file, the user state restore process is skipped.
If the Loadstate process finishes successfully, the user state information is
deleted. In the event of a Loadstate failure (or non-zero return code), the local
state store is moved to %WINDIR%\StateStore to prevent deletion and to ensure
that no user state information is lost.
Note Do not add any of the following command-line arguments when configuring this property:
/hardlink, /nocompress, /decrypt, /key, or /keyfile. The MDT scripts will add these command-line
arguments if applicable to the current deployment scenario.
Value Description
Arguments The command-line arguments passed to
Loadstate.exe.
The default arguments specified by Deployment
Workbench are as follows:
/v. Enables verbose output in the Loadstate log.
The default is 0. Specify any number from 0 to 15.
The value 5 enables verbose and status output.
/c. When specified, Loadstate will continue to run
even if there are nonfatal errors. Without the /c
option, Loadstate exits on the first error.
/lac. Specifies that if the account being migrated is
a local (non-domain) account, and it does not exist
Value Description
on the destination computer, then USMT will
create the account but it will be disabled.
For more information about these and other
arguments, see the USMT Help files.
Example
[Settings]
Priority=Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
Location
The geographic location of the target computers. A list of IP addresses that
correspond to the default gateways defined for the computers within that location
defines the Location property. An IP address for a default gateway can be
associated with more than one location.
Typically, the value for the Location property is set by performing a database
query on the database managed using Deployment Workbench. Deployment
Workbench can assist in creating the locations, defining property settings
associated with the locations, and then in configuring CustomSettings.ini to
perform the database query for the Location property and the property settings
associated with the locations.
For example, a LocationSettings section in CustomSettings.ini can query the
LocationSettings view in the database for a list of locations that contain the value
specified in the DefaultGateway property listed in the Parameters property. The
query returns all settings associated with each default gateway.
Then the scripts parse each section that corresponds to the locations returned in
the query. For example, the value [Springfield] and the section
[Springfield-123 Oak Street-4th Floor] in CustomSettings.ini can
represent the corresponding locations. This is an example of how one computer
can belong to two locations. The [Springfield] section is for all computers in a
larger geographic area (an entire city), and the [Springfield-123 Oak
Street-4th Floor] section is for all computers on the fourth floor at 123 Oak
Street, in Springfield.
Value Description
location1, The list of locations to be assigned to an individual
location2 computer or a group of computers
Example
[Settings]
Priority=LSettings, Default
[Default]
UserDataLocation=AUTO
DeployRoot=\\W2K3-SP1\Distribution$
OSInstall=YES
ScanStateArgs=/v:15 /o /c
LoadStateArgs=/v:7 /c
[LSettings]
SQLServer=w2k3-sp1
Instance=MDT2010
Database=MDTDB
Netlib=DBNMPNTW
SQLShare=SQL$
Table=LocationSettings
Parameters=DefaultGateway
[Springfield]
UDDir=%OSDComputerName%
UDShare=\\Springfield-FIL-01\UserData
LongDistanceAccess
The dialing digits to gain access to an outside line to dial long distance. The
property can contain only numeric digits. This value is inserted into the
appropriate configuration settings in Unattend.txt or Sysprep.inf for Windows XP
and Windows Server 2003 or in Unattend.xml for Windows Vista and later
operating systems.
Value Description
language_pack_guid The GUID that the Deployment Workbench specifies
for the language packs to install on the target
computer. The GUID corresponds to the language
pack GUID stored in Packages.xml.
Example
[Settings]
Priority=Default
[Default]
AreaCode=206
CountryCode=001
Dialing=TONE
LongDistanceAccess=9
MACAddress
The media access control (MAC) layer address of the primary network adapter of
the target computer. The MACAddress property is included on the Priority line
so that property values specific to a target computer can be provided. Create a
section for each MAC address for each of the target computers (such as
[00:0F:20:35:DE:AC] or [00:03:FF:FE:FF:FF]) that contain target
computer–specific settings.
Value Description
mac_address The MAC address of the target computer
Example
Example
[Settings]
Priority=MACAddress, Default
[Default]
CaptureGroups=YES
Groups1=NYC Application Management
Groups2=NYC Help Desk Users
[00:0F:20:35:DE:AC]
OSDNEWMACHINENAME=HPD530-1
[00:03:FF:FE:FF:FF]
OSDNEWMACHINENAME=BVMXP
MachineObjectOU
The AD DS OU in the target domain where the computer account for the target
computer is created.
Note The OU specified in this property must exist before deploying the target operating system.
Note If a computer object already exists in AD DS, specifying MachineObjectOU will not cause
the computer object to be moved to the specified OU.
Value Description
OU_name The name of the OU where the computer account for
the target computer will be created
Example
[Settings]
Priority=Default
[Default]
JoinDomain=WOODGROVEBANK
MachineObjectOU=OU=Reception,OU=NYC,DC=Woodgrovebank,DC=com
Make
The manufacturer of the target computer. The format for Make is undefined. Use
this property to create a subsection that contains settings targeted to a specific
computer manufacturer (most commonly in conjunction with the Model and
Product properties).
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
make The manufacturer of the target computer
Example
[Settings]
Priority=Make, Default
[Default]
[Dell-Latitude D600]
Packages001=XXX00009:Program9
Packages002=XXX0000A:Program10
MandatoryApplications
A list of application GUIDs that will be installed on the target computer. These
applications are specified on the Applications node in the Deployment
Workbench. The GUIDs are stored in the Applications.xml file. The
MandatoryApplications property is a list of text values that can be any non-
blank value. The MandatoryApplications property has a numeric suffix (for
example, MandatoryApplications001 or MandatoryApplications002).
Value Description
application_guid The GUID specified by the Deployment Workbench for
the application to be deployed to the target computer.
The GUID corresponds to the application GUID stored
in the Applications.xml file.
Example
[Settings]
Priority=Default
[Default]
MandatoryApplications001={1D7DF331-47B7-472C-87B3-
442597EC2F7D}
MandatoryApplications002={9d2b8999-5e4d-4f3d-bb05-
edaaf4fe5628}
Administrators001=WOODGROVEBANK\NYC Help Desk Staff
Memory
The amount of memory installed on the target computer in megabytes. For
example, the value 2038 indicates 2,038 MB (or 2 GB) of memory is installed on
the target computer.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
memory The amount of memory installed on the target
computer in megabytes
Example
None
Model
The model of the target computer. The format for Model is undefined. Use this
property to create a subsection that contains settings targeted to a specific
computer model number for a specific computer manufacturer (most commonly
in conjunction with the Make and Product properties).
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
model The model of the target computer
Example
[Settings]
Priority=Make, Default
[Default]
[Dell-Latitude D600]
Packages001=XXX00009:Program9
Packages002=XXX0000A:Program10
NetLib
The protocol to be used to communicate with the computer running SQL Server
specified in the SQLServer property.
Value Description
DBNMPNTW Use the named pipes protocol to communicate.
Value Description
DBMSSOCN Use TCP/IP sockets to communicate.
Example
[Settings]
Priority=Computers, Default
[Default]
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
[Computers]
SQLServer=NYC-SQL-01
SQLShare=SQL$
NetLib=DBNMPNTW
Database=MDTDB
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
NewDomain
Indicates the type of a new domain: whether a new domain in a new forest, the
root of a new tree in an existing forest, or a child of an existing domain.
Value Description
Child The new domain is a child of an existing domain.
Forest The new domain is the first domain in a new forest of
domain trees.
Tree The new domain is the root of a new tree in an
existing forest.
Example
[Settings]
Priority=Default
Example
[Default]
NewDomain=Tree
NewDomainDNSName
Specifies the required name of a new tree in an existing domain or when Setup
installs a new forest of domains.
Value Description
name Specifies the required name of a new tree in an
existing domain or when Setup installs a new forest of
domains
Example
[Settings]
Priority=Default
[Default]
NewDomainDNSName=newdom.WoodGroveBank.com
Order
The sorting order for the result set on a database query. The result set is based
on the configuration settings of the Database, Table, SQLServer, Parameters,
and ParameterCondition properties. More than one property can be provided to
sort the results by more than one property.
For example, if Order=Sequence is specified in the CustomSettings.ini file, then
an ORDER BY sequence clause is added to the query. Specifying
Order=Make, Model adds an ORDER BY Make, Model clause to the query.
Value Description
Value Description
property1, property2, … Properties to define the sort order for the result set
(where propertyn represents the properties in the sort
criteria)
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
[Computers]
SQLServer=NYC-SQL-01
SQLShare=SQL$
NetLib=DBNMPNTW
Database=MDTDB
Instance=SQLEnterprise2005
Table=MakeModelSettings
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
Order=Make, Model
OrgName
The name of the organization that owns the target computer. This value is
inserted into the appropriate configuration settings in Unattend.txt or Sysprep.inf
for Windows XP and Windows Server 2003 or in Unattend.xml for Windows Vista
and later operating systems.
Value Description
org_name The name of the organization that owns the target
computer
Example
Example
[Settings]
Priority=MACAddress, Default
Properties=CustomProperty, ApplicationInstall
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
UserDataLocation=NONE
CustomProperty=TRUE
OrgName=Woodgrove Bank
[00:0F:20:35:DE:AC]
OSDNEWMACHINENAME=HPD530-1
ApplicationInstall=Custom
FullName=Woodgrove Bank User
[00:03:FF:FE:FF:FF]
OSDNEWMACHINENAME=BVMXP
ApplicationInstall=Minimum
FullName=Woodgrove Bank Manager
OSArchitecture
The processor architecture type for the target operating system. This property is
referenced during OEM deployments. Valid values are x86 and x64.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
x86 The processor architecture type for the operating
system is 32 bit.
x64 The processor architecture type for the operating
system is 64 bit.
Example
Example
None
OSCurrentBuild
The build number of the currently running operating system.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
2600 Windows XP
3790 Windows Server 2003
6000 Windows Vista, Windows PE 2.0
6001 Windows Vista with Service Pack 1 (SP1), Windows
Server 2008
7600 Windows 7
Example
None
OSCurrentVersion
The version number of the currently running operating system.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
version_number The operating system major version, minor version,
and build numbers (major.minor.build). For example,
6.1.7601 would represent Windows 7 with SP1.
Example
None
OSDAdapterxDescription
Specifies the name of the network connection as it appears in the Control Panel
Network Connections item. The name can be between 0 and 255 characters in
length.
This property is for LTI only. For the equivalent property for ZTI, see
OSDAdapterxName.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0Description or OSDAdapter1Description.
Value Description
Description The name of the network connection as it appears in
the Control Panel Network Connections item
Example
None
OSDAdapterxDNSDomain
Specifies the DNS domain name (DNS suffix) that will be assigned to the network
connection. This property is for ZTI only. For LTI, see the
OSDAdapterxDNSSuffix property.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0DNSDomain or OSDAdapter1DNSDomain.
Value Description
DNS_domain_name A DNS domain name (DNS suffix) that will be
assigned to the network connection
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0DNSDomain=WoodGroveBank.com
OSDAdapterxDNSServerList
This is a comma-delimited list of DNS server IP addresses that will be assigned
to the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0DNSServerList or OSDAdapter1DNSServerList.
Value Description
DNS_servers A comma-delimited list of DNS server IP addresses
that will be assigned to the network connection
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0DNSServerList=192.168.0.254,192.168.100.254
OSDAdapterxDNSSuffix
A DNS suffix that will be assigned to the network connection. This property is for
LTI only. For ZTI, see the OSDAdapterxDNSDomain property.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0DNSSuffix or OSDAdapter1DNSSuffix.
Value Description
DNS_suffix A DNS suffix that will be assigned to the network
connection
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0DNSSuffix= WoodGroveBank.com
OSDAdapterxEnableDHCP
Specifies whether the network connection will be configured via DHCP.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableDHCP or OSDAdapter1EnableDHCP.
Value Description
TRUE The network connection will be configured via DHCP.
FALSE The network connection will be configured with static
configuration.
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableDHCP=TRUE
OSDAdapterxEnableDNSRegistration
Specifies whether DNS registration is enabled on the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableDNSRegistration or
OSDAdapter1EnableDNSRegistration.
Value Description
TRUE Enables DNS registration
FALSE Disables DNS registration
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableDNSRegistration=TRUE
OSDAdapterxEnableFullDNSRegistration
Specifies whether full DNS registration is enabled on the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableFullDNSRegistration or
OSDAdapter1EnableFullDNSRegistration.
Value Description
TRUE Enables full DNS registration
FALSE Disables full DNS registration
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableFullDNSRegistration=TRUE
OSDAdapterxEnableLMHosts
Specifies whether LMHOSTS lookup is enabled on the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableLMHosts or OSDAdapter1EnableLMHosts.
Value Description
TRUE Enables LMHOSTS lookup
FALSE Disables LMHOSTS lookup
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableLMHosts=TRUE
OSDAdapterxEnableIPProtocolFiltering
This property specifies whether IP protocol filtering should be enabled on the
network connection.
Note The x in this property’s name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableIPProtocolFiltering or
OSDAdapter1EnableIPProtocolFiltering.
Value Description
TRUE Enables IP protocol filtering
FALSE Disables IP protocol filtering
Example
[Settings]
Priority=Default
Example
[Default]
OSDAdapter0EnableIPProtocolFiltering =TRUE
OSDAdapterxEnableTCPFiltering
Specifies whether TCP/IP filtering should be enabled on the network connection.
This property is for ZTI only. For LTI, see the OSDAdapterxEnableTCPIPFiltering
property.
Note The x in this property’s name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableTCPFiltering or
OSDAdapter1EnableTFiltering.
Value Description
TRUE Enables TCP/IP filtering
FALSE Disables TCP/IP filtering
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableTCPFiltering=TRUE
OSDAdapterxEnableTCPIPFiltering
Specifies whether TCP/IP filtering should be enabled on the network connection.
This property is for LTI only. For ZTI, see the OSDAdapterxEnableTCPFiltering
property.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableTCPIPFiltering or
OSDAdapter1EnableTCPIPFiltering.
Value Description
TRUE Enables TCP/IP filtering
FALSE Disables TCP/IP filtering
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableTCPIPFiltering=TRUE
OSDAdapterxEnableWINS
Specifies whether WINS will be enabled on the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0EnableWINS or OSDAdapter1EnableWINS.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
TRUE Enables WINS
FALSE Disables WINS
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableWINS=TRUE
OSDAdapter0WINSServerList=192.168.0.1,192.168.100.1
OSDAdapterxGatewayCostMetric
A comma-delimited list of Gateway Cost Metrics specified as either integers or
the string ―Automatic‖ (if empty, uses ―Automatic‖) that will be configured on the
connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0GatewayCostMetric or
OSDAdapter1GatewayCostMetric.
Value Description
cost_metrics A comma-delimited list of Gateway Cost Metrics
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0GatewayCostMetrics=Automatic
OSDAdapterxGateways
A comma-delimited list of gateways to be assigned to the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0Gateways or OSDAdapter1Gateways.
Value Description
gateways A comma-delimited list of gateways
Example
[Settings]
Priority=Default
Example
[Default]
OSDAdapter0Gateways=192.168.0.1,192.168.100.1
OSDAdapterxIPAddressList
A comma-delimited list of IP addresses to be assigned to the network
connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0IPAddressList or OSDAdapter1IPAddressList.
Value Description
IP_addresses A comma delimited list of IP addresses
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0IPAddressList=192.168.0.40,192.168.100.40
OSDAdapter0SubnetMask=255.255.255.0,255.255.255.0
OSDAdapterxIPProtocolFilterList
A comma-delimited list of IP protocol filters to be assigned to the network
connection. This property can be configured using the CustomSettings.ini file or
the MDT DB but not the Deployment Workbench. If using Configuration Manager
2012 or Configuration Manager 2007 R3, it is also configurable using an Apply
Network Settings task sequence step.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0IPProtocolFilterList or
OSDAdapter1IPProtocolFilterList.
Value Description
protocol_filter_list A comma-delimited list of IP protocol filters
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0IPProtocolFilterList=a list of approved IP
protocols
OSDAdapterxMacAddress
Assign the specified configuration settings to the network interface card that
matches the specified MAC address.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0MacAddress or OSDAdapter1MacAddress.
Value Description
MAC_address Network adapter MAC address
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0MacAddress=00:0C:29:67:A3:6B
OSDAdapterxName
Assign the specified configuration settings to the network adapter that matches
the specified name. This property is for ZTI only. For the equivalent property for
LTI, see OSDAdapterxDescription.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0Name or OSDAdapter1Name.
Value Description
name Network adapter name
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0Name=3Com 3C920 Integrated Fast Ethernet
Controller
OSDAdapterxSubnetMask
A comma-delimited list of IP subnet masks to be assigned to the network
connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0SubnetMask or OSDAdapter1SubnetMask.
Value Description
subnet_masks A comma-delimited list of IP subnet masks
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0IPAddressList=192.168.0.40,192.168.100.40
OSDAdapter0SubnetMask=255.255.255.0,255.255.255.0
OSDAdapterxTCPFilterPortList
A comma-delimited list of TCP filter ports to be assigned to the network
connection. This property can be configured using the CustomSettings.ini file or
the MDT DB but not the Deployment Workbench. If using Configuration
Manager 2012 or Configuration Manager 2007 R3, it is also configurable using
an Apply Network Settings task sequence step.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0TCPFilterPortList or
OSDAdapter1TCPFilterPortList.
Value Description
port_list A comma-delimited list of TCP/IP filter ports
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0TCPFilterPortList=a list of approved TCP ports
OSDAdapterxTCPIPNetBiosOptions
Specifies the TCP/IP NetBIOS options to be assigned to the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0TCPIPNetBiosOptions or
OSDAdapter1TCPIPNetBiosOptions.
Value Description
0 Disable IP forwarding.
1 Enable IP forwarding.
Example
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0TCPIPNetBiosOptions=0
OSDAdapterxUDPFilterPortList
A comma-delimited list of User Datagram Protocol (UDP) filter ports to be
assigned to the network connection. This property can be configured using the
CustomSettings.ini file and the MDT DB but not the Deployment Workbench. If
using Configuration Manager 2012 or Configuration Manager 2007 R3, it is also
configurable using an Apply Network Settings task sequence step.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0UDPFilterPortList or
OSDAdapter1UDPFilterPortList.
Value Description
port_list A comma-delimited list of UDP filter ports
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0UDPFilterPortList=a list of approved UDP ports
OSDAdapterxWINSServerList
A two-element, comma-delimited list of WINS server IP addresses to be
assigned to the network connection.
Note The x in this properties name is a placeholder for a zero-based array that contains network
adapter information, such as OSDAdapter0WINSServerList or OSDAdapter1WINSServerList.
Value Description
WINS_server_list A comma-delimited list of WINS server IP addresses
Example
[Settings]
Priority=Default
[Default]
OSDAdapter0EnableWINS=TRUE
OSDAdapter0WINSServerList=192.168.0.1,192.168.100.1
OSDAdapterCount
Specifies the number of network connections that are to be configured.
Value Description
count The number of network adapters
Example
[Settings]
Priority=Default
[Default]
OSDAdapterCount=1
OSDAdapter0EnableDHCP=FALSE
OSDAdapter0IPAddressList=192.168.0.40,192.168.100.40
OSDAdapter0SubnetMask=255.255.255.0,255.255.255.0
OSDAdapter0Gateways=192.168.0.1,192.168.100.1
OSDAdapter0EnableWINS=TRUE
OSDAdapter0WINSServerList=192.168.0.1,192.168.100.1
OSDAdapter0TCPIPNetBiosOptions=0
OSDAdapter0MacAddress=00:0C:29:67:A3:6B
Example
OSDAdapter0GatewayCostMetrics=Automatic
OSDAdapter0EnableTCPIPFiltering=TRUE
OSDAdapter0EnableLMHosts=TRUE
OSDAdapter0EnableFullDNSRegistration=TRUE
OSDAdapter0EnableDNSRegistration=TRUE
OSDAdapter0DNSSuffix=WoodGroveBank.com
OSDAnswerFilePath
Specifies the path to the answer file to be used during OEM deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
file_path Specifies the path to the answer file to be used during
OEM deployments
Example
None
OSDBitLockerCreateRecoveryPassword
A Boolean value that indicates whether the process creates a recovery key for
BitLocker. The key is used for recovering data encrypted on a BitLocker volume.
This key is cryptographically equivalent to a startup key. If available, the recovery
key decrypts the VMK, which, in turn, decrypts the FVEK.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
Value Description
AD A recovery key is created.
Not specified A recovery key is not created.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
OSDBitLockerMode=TPMKey
OSDBitLockerCreateRecoveryPassword=AD
OSDBitLockerStartupKeyDrive=C:
OSDBitLockerMode
The type of BitLocker installation to be performed. Protect the target computer
using one of the following methods:
A TPM microcontroller
A TPM and an external startup key (using a key that is typically stored on a
UFD)
A TPM and PIN
An external startup key
Value Description
TPM Protect the computer with TPM only. The TPM is a
microcontroller that stores keys, passwords, and
digital certificates. The microcontroller is typically an
integral part of the computer motherboard.
TPMKey Protect the computer with TPM and a startup key. Use
this option to create a startup key and to save it on a
UFD. The startup key must be present in the port each
time the computer starts.
Value Description
TPMPin Protect the computer with TPM and a pin. Use this
option in conjunction with the BDEPin property.
Note This value is not valid when using ZTI 2012 or
Configuration Manager 2007 R3.
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
OSDBitLockerMode=TPM
OSDBitLockerCreateRecoveryPassword=AD
OSDBitLockerRecoveryPassword
Instead of generating a random recovery password, the Enable BitLocker task
sequence action uses the specified value as the recovery password. The value
must be a valid numerical BitLocker recovery password.
Value Description
password A valid 48-digit password
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
Example
OSDBitLockerMode=TPMKey
OSDBitLockerCreateRecoveryPassword=AD
OSDBitLockerRecoveryPassword=621280128854709621167486709731
081433315062587367
OSDBitLockerStartupKeyDrive=C:
OSDBitLockerStartupKey
Instead of generating a random startup key for the key management option
Startup Key on USB only, the Enable BitLocker task sequence action uses the
value as the startup key. The value must be a valid, Base64-encoded BitLocker
startup key.
Value Description
startupkey Base64-encoded BitLocker startup key
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=KEY
OSDBitLockerCreateRecoveryPassword=AD
OSDBitLockerStartupKey=8F4922B8-2D8D-479E-B776-12629A361049
OSDBitLockerStartupKeyDrive
The location for storing the BitLocker recovery key and startup key.
Value Description
location The storage location for the recovery key and startup
key (either local to the target computer or to a UNC
that points to a shared network folder)
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
OSDBitLockerMode=TPMKey
OSDBitLocker CreateRecoveryPassword=AD
OSDBitLockerStartupKeyDrive=C:
OSDBitLockerTargetDrive
Specifies the drive to be encrypted. The default drive is the drive that contains
the operating system.
Value Description
drive The drive that is to be encrypted
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
BDERecoveryPassword=TRUE
OSDBitLockerMode=TPMKey
OSDBitLockerCreateRecoveryPassword=AD
Example
OSDBitLockerTargetDrive=C:
OSDBitLockerWaitForEncryption
Specifies that the deployment process should not proceed until BitLocker has
completed the encryption process for all specified drives. Specifying TRUE could
dramatically increase the time required to complete the deployment process.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
TRUE Specifies that the deployment process should wait for
drive encryption to finish
FALSE Specifies that the deployment process should not wait
for drive encryption to finish
Example
[Settings]
Priority=Default
[Default]
BDEInstallSuppress=NO
BDEDriveLetter=S:
BDEDriveSize=2000
OSDBitLockerMode=TPMKey
OSDBitLockerStartupKeyDrive=C:
OSDBitLockerCreateRecoveryPassword=AD
OSDBitLockerWaitForEncryption=TRUE
OSDComputerName
The new computer name to assign to the target computer.
Note This property can also be set within a task sequence using a customized Set Task
Sequence Variable task sequence step.
Value Description
computer_name The new computer name to assign to the target
computer
Example
[Default]
OSDComputerName=%_SMSTSMachineName%
OSDDiskAlign
This property is used to pass a value to the align parameter of the create
partition primary command in the DiskPart command. The align parameter is
typicaly used with hardware RAID Logical Unit Number (LUN) arrays to improve
performance when the logical units (LUs) are not cylinder aligned. The align
parameter aligns a primary partition that is not cylinder aligned at the beginning
of a disk and rounds the offset to the closest alignment boundary. For more
information on the align parameter, see Create partition primary.
Note This property can be used in conjunction with the OSDDiskOffset property to set the offset
parameter for the create partition primary command in the DiskPart command. For more
information, see the OSDDiskOffset property.
Value Description
alignment_value Specifies the number of kilobytes (KB) from the
beginning of the disk to the closest alignment
boundary.
Example
[Settings]
Priority=Default
[Default]
OSDDiskAlign=1024
OSDDiskOffset=2048
OSDDiskIndex
Specifies the disk index that will be configured.
Value Description
disk_index Specifies the disk index that will be configured (The
default value is 0.)
Example
[Settings]
Priority=Default
[Default]
OSDDiskIndex=0
OSDDiskOffset
This property is used to pass a value to the offset parameter of the create
partition primary command in the DiskPart command. For more information on
the offset parameter, see Create partition primary.
Note This property can be used in conjunction with the OSDDiskAlign property to set the align
parameter for the create partition primary command in the DiskPart command. For more
information, see the OSDDiskAlign property.
Value Description
offset_value Specifies the byte offset at which to create the
partition. For master boot record (MBR) disks, the
offset rounds to the closest cylinder boundary.
Example
[Settings]
Priority=Default
Example
[Default]
OSDDiskAlign=1024
OSDDiskOffset=2048
OSDDiskPartBiosCompatibilityMode
This property specifies whether to disable cache alignment optimizations when
partitioning the hard disk for compatibility with certain types of BIOS. Doing so
may be necessary when deploying Windows XP or Windows Server 2003
operating systems. For more information, see the Microsoft Support articles, You
cannot install Windows XP successfully after you use Windows Vista or
Windows PE 2.0 to create partitions on a hard disk and You cannot install
Windows Server 2003 successfully after you use Windows Vista or
Windows PE 2.0 to create partitions on a hard disk.
Value Description
TRUE Enables cache alignment optimizations when
partitioning the hard disk for compatibility with certain
types of BIOS
FALSE Disables cache alignment optimizations when
partitioning the hard disk for compatibility with certain
types of BIOS (This is the default value.)
Example
[Settings]
Priority=Default
[Default]
OSDDiskPartBiosCompatibilityMode=TRUE
OSDImageCreator
Specifies the name of the installation account that will be used during OEM
deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
image_creator Specifies the name of the installation account that will
be used during OEM deployments
Example
None
OSDImageIndex
Specifies the index of the image in the .wim file. This property is referenced
during OEM deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
index Specifies the index of the image in the WIM file
Example
None
OSDImagePackageID
Specifies the package ID for the image to install during OEM deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
package_ID Specifies the package ID for the image to install during
OEM deployments
Example
None
OSDInstallEditionIndex
Specifies the index of the image in the WIM file. This property is referenced
during OEM deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
index Specifies the index of the image in the WIM file
Example
None
OSDInstallType
Specifies the installation type used for OEM deployments. The default is
Sysprep.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
install_type Specifies the installation type used for OEM
deployments
Example
Example
None
OSDisk
Specifies the drive used to install the operating system during OEM deployments.
The default value is C:.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
disk Specifies the drive used to install the operating system
during OEM deployments
Example
None
OSDPartitions
Specifies the number of defined partitions configurations. The maximum number
of partitions that can be configured is two. The default is None.
Value Description
partitions Specifies the number of defined partitions
configurations
Example
[Settings]
Priority=Default
[Default]
Example
OSDPartitions=1
OSDPartitions0Bootable=TRUE
OSDPartitions0FileSystem=NTFS
OSDPartitions0QuickFormat=TRUE
OSDPartitions0Size=60
OSDPartitions0SizeUnits=GB
OSDPartitions0Type=Primary
OSDPartitions0VolumeName=OSDisk
OSDPartitions0VolumeLetterVariable=NewDrive1
OSDPartitionsxBootable
The partition at the specified index should be set bootable. The default first
partition is set bootable.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Value Description
TRUE The partition should be set to bootable.
FALSE Do not set the partition to bootable.
Example
[Settings]
Priority=Default
[Default]
OSDPartitions0Bootable=TRUE
OSDPartitionsxFileSystem
The type of file system for the partition at the specified index. Valid values are
NTFS or FAT32.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
file_system The type of file system for the partition
Example
[Settings]
Priority=Default
[Default]
OSDPartitions0FileSystem=NTFS
OSDPartitionsxQuickFormat
The partition at the specified index should be quick formatted. The default is
TRUE.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
TRUE Quick-format the partition.
FALSE Do not quick-format the partition.
Example
[Settings]
Priority=Default
[Default]
OSDPartitions0QuickFormat=TRUE
OSDPartitionsxSize
The size of the partition at the specified index.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Value Description
Size Partition size
Example
[Settings]
Priority=Default
[Default]
OSDPartitions0Size=60
OSDPartitions0SizeUnits=GB
OSDPartitionsxSizeUnits
The units of measure used when specifying the size of the partition. Valid values
are MB, GB, or %. The default value is MB.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Value Description
size_units The units of measure used when specifying the size of
the partition
Example
[Settings]
Priority=Default
Example
[Default]
OSDPartitions0Size=60
OSDPartitions0SizeUnits=GB
OSDPartitionsxType
The type of partition to be created at the specified index.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Value Description
Primary Create a primary partition. This is the default value.
Logical Create a logical partition.
Extended Create an extended partition.
Example
[Settings]
Priority=Default
[Default]
OSDPartitions0Type=Primary
OSDPartitionsxVolumeLetterVariable
The property that receives the drive letter that is assigned to the partition being
managed.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Value Description
Value Description
volume_letter_variable The name of the variable that will be assigned the
drive letter of the partition being managed
Example
[Settings]
Priority=Default
[Default]
OSDPartitions0VolumeLetterVariable=NewDrive1
OSDPartitionsxVolumeName
The volume name that will be assigned to the partition at the specified index.
Note The x in this properties name is a placeholder for a zero-based array that contains partition
configurations.
Value Description
volume_name The volume name that will be assigned to the partition
Example
[Settings]
Priority=Default
[Default]
OSDPartitions0VolumeName=OSDisk
OSDStateStorePath
LTI and ZTI use this property to set the path where the user state migration data
will be stored, which can be a UNC path, a local path, or a relative path.
Note The OSDStateStorePath property takes precedence over the StatePath or
UserDataLocation property when those properties are also specified.
In a Replace Computer deployment scenario in ZTI, the Restore User State task
sequence step is skipped if the OSDStateStorePath property is set to a valid
local or UNC path. The workaround is to set the USMTLocal property to TRUE.
Doing so forces ZTI UserState.wsf to recognize the path in the
OSDStateStorePath property. This is caused by the Request State Store task
Solution Accelerators microsoft.com/technet/SolutionAccelerators
Toolkit Reference: Properties 185
sequence step being skipped and the previous value in the OSDStateStorePath
property being retained.
In a Replace Computer deployment scenario in ZTI, where user state migration
data and the entire computer are being backed up, the Backup.wim file is stored
in the folder specified in the OSDStateStorePath property. This may be caused
by specifying the wrong value for the ComputerBackupLocation property.
For example, the following CustomSettings.ini file will cause the Backup.wim file
to be stored in the same folder specified in the OSDStateStorePath property:
USMTLocal=True
OSDStateStorePath=\\fs1\Share\ReplaceVista
ComputerBackupLocation=NETWORK
BackupShare=\\fs1\Share\VistaComputerBackup
BackupDir=Vista01
Value Description
path The volume name that will be assigned to the partition
Example
[Settings]
Priority=Default
[Default]
USMTLocal=True
OSDStateStorePath=\\fs1\Share\ReplaceVista
ComputerBackupLocation=\\fs1\Share\VistaComputerBackup\Vista01
OSDTargetSystemDrive
Specifies the drive where the operating system will be installed during OEM
deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read-only.
Value Description
system_drive Specifies the drive where the operating system will be
installed during OEM deployments
Example
None
OSDTargetSystemRoot
Specifies the install path where the operating system will be installed during OEM
deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
system_root Specifies the install path where the operating system
will be installed during OEM deployments
Example
None
OSFeatures
A comma-delimited list of server feature IDs that will be installed on the target
computer.
Note Not all features listed in the ServerManager.xml file are compatible with all server operating
systems.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
ID1,ID2 The server features that are to be installed on the
target computer. Valid values are located in the
program_files\Microsoft Deployment
Toolkit\Bin\ServerManager.xml file on the MDT server.
Example
[Settings]
Priority=Default
[Default]
OSFeatures=CMAK,MSMQ-Multicasting,RSAT
OSInstall
Indicates whether the target computer is authorized to have the target operating
system installed. If the OSInstall property is not listed, the default is to allow
deployment of operating systems to any target computer.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES Deployment of an operating system to the target
computer is authorized. This is the default value.
NO Deployment of an operating system to the target
computer is not authorized.
Example
[Settings]
Priority=Default
[Default]
OSInstall=YES
OSRoles
A comma-delimited list of server role IDs that will be installed on the target
computer.
Note Not all roles are compatible with all server operating systems.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
ID1,ID2 The server role that is to be installed on the target
computer.
ID FullName
AD-Certificate Active Directory Certificate Services (Core)
ADCS-Cert-Authority * Certification Authority
ADCS-Web-Enrollment * Certification Authority Web Enrollment
ADCS-Online-Cert * Online Responder
ADCS-Device- * Network Device Enrollment Service
Enrollment
ADCS-Enroll-Web-Svc * Certificate Enrollment Web Service (2008R2)
ADCS-Enroll-Web-Pol * Certificate Enrollment Policy Web Service (2008R2)
AD-Domain-Services Active Directory Domain Services (Core)
ADDS-Domain- * Active Directory Domain Controller (Core)
Controller
ADDS-Identity-Mgmt * Identity Management for UNIX
ADDS-NIS * Server for Network Information Services
ADDS-Password-Sync * Password Synchronization
ADDS-IDMU-Tools * Administration Tools
AD-Federation-Services Active Directory Federation Services
ADFS-Federation * Federation Service
ADFS-Proxy * Federation Service Proxy
ADFS-Web-Agents * AD FS Web Agents
ID FullName
ADFS-Claims * Claims-aware Agent
ADFS-Windows-Token * Windows Token-based Agent
ADLDS Active Directory Lightweight Directory Services (Core)
ADRMS Active Directory Rights Management Services
ADRMS-Server * Active Directory Rights Management Server
ADRMS-Identity * Identity Federation Support
Application-Server Application Server
AS-NET-Framework * .NET Framework 3.5.1 (2008R2)
AS-AppServer- * Application Server Foundation
Foundation
AS-Web-Support * Web Server (IIS) Support
AS-Ent-Services * COM+ Network Access
AS-TCP-Port-Sharing * TCP Port Sharing
AS-WAS-Support * Windows Process Activation Service Support
AS-HTTP-Activation * HTTP Activation (Win7)
AS-MSMQ-Activation * Message Queuing Activation
AS-TCP-Activation * TCP Activation
AS-Named-Pipes * Named Pipes Activation
AS-Dist-Transaction * Distributed Transactions
AS-Incoming-Trans * Incoming Remote Transactions
AS-Outgoing-Trans * Outgoing Remote Transactions
AS-WS-Atomic * WS-Atomic Transactions
DHCP DHCP Server (Core)
DNS DNS Server (Core)
Fax Fax Server (Win7)
File-Services File Services
FS-FileServer * File Server (Core)
FS-DFS * Distributed File System (Core)
FS-DFS-Namespace * DFS Namespaces
FS-DFS-Replication * DFS Replication (Core)
FS-Resource-Manager * File Server Resource Manager
ID FullName
FS-NFS-Services * Services for Network File System (Win7,Core)
FS-Search-Service * Windows Search Service (Win7)
FS-Win2003-Services * Windows Server 2003 File Services
FS-Replication * File Replication Service (2008)
FS-Indexing-Service * Indexing Service (Win7)
FS-BranchCache * BranchCache for network files (2008R2)
Hyper-V Hyper-V (x64 only)
NPAS Network Policy and Access Services
NPAS-Policy-Server * Network Policy Server
NPAS-RRAS-Services * Routing and Remote Access Services
NPAS-RRAS * Remote Access Service
NPAS-Routing * Routing
NPAS-Health * Health Registration Authority
NPAS-Host-Cred * Host Credential Authorization Protocol
Print-Services Print and Document Services (Win7)
Print-Server * Print Server (Core)
Print-LPD-Service * LPD Service (Win7,Core)
Print-Internet * Internet Printing
Print-Scan-Server * Distributed Scan Server (2008R2)
Terminal-Services Terminal Services (2008)
TS-Terminal-Server * Terminal Server (2008)
TS-Licensing * TS Licensing (2008)
TS-Session-Broker * TS Session Broker (2008)
TS-Gateway * TS Gateway (2008)
TS-Web-Access * TS Web Access (2008)
Remote-Desktop- Remote Desktop Services (2008R2)
Services
RDS-RD-Server * Remote Desktop Server (2008R2)
RDS-Virtualization * Remote Desktop Virtualization (2008R2)
RDS-Licensing * Remote Desktop Licensing (2008R2)
RDS-Connection- * Remote Desktop Connection Broker (2008R2)
Broker
ID FullName
RDS-Gateway * Remote Desktop Gateway (2008R2)
RDS-Web-Access * Remote Desktop Web Access (2008R2)
Web-Server Web Server (IIS)
Web-WebServer * Web Server (Win7,Core)
Web-Common-Http * Common HTTP Features (Win7,Core)
Web-Static-Content * Static Content (Win7,Core)
Web-Default-Doc * Default Document (Win7,Core)
Web-Dir-Browsing * Directory Browsing (Win7,Core)
Web-Http-Errors * HTTP Errors (Win7,Core)
Web-Http-Redirect * HTTP Redirection (Win7,Core)
Web-DAV-Publishing * WebDAV Publishing (2008R2)
Web-App-Dev * Application Development (Win7,Core)
Web-Asp-Net * ASP.NET (Win7,Core)
Web-Net-Ext * .NET Extensibility (Win7,Core)
Web-ASP * ASP (Win7,Core)
Web-CGI * CGI (Win7,Core)
Web-ISAPI-Ext * ISAPI Extensions (Win7,Core)
Web-ISAPI-Filter * ISAPI Filters (Win7,Core)
Web-Includes * Server Side Includes (Win7,Core)
Web-Health * Health and Diagnostics (Win7,Core)
Web-Http-Logging * HTTP Logging (Win7,Core)
Web-Log-Libraries * Logging Tools (Win7,Core)
Web-Request-Monitor * Request Monitor (Win7,Core)
Web-Http-Tracing * Tracing (Win7,Core)
Web-Custom-Logging * Custom Logging (Win7,Core)
Web-ODBC-Logging * ODBC Logging (Win7,Core)
Web-Security * Security (Win7,Core)
Web-Basic-Auth * Basic Authentication (Win7,Core)
Web-Windows-Auth * Windows Authentication (Win7,Core)
Web-Digest-Auth * Digest Authentication (Win7,Core)
Web-Client-Auth * Client Certificate Mapping Authentication
ID FullName
(Win7,Core)
Web-Cert-Auth * IIS Client Certificate Mapping Authentication
(Win7,Core)
Web-Url-Auth * URL Authorization (Win7,Core)
Web-Filtering * Request Filtering (Win7,Core)
Web-IP-Security * IP and Domain Restrictions (Win7,Core)
Web-Performance * Performance (Win7,Core)
Web-Stat-Compression * Static Content Compression (Win7,Core)
Web-Dyn-Compression * Dynamic Content Compression (Win7,Core)
Web-Mgmt-Tools * Management Tools (Win7,Core)
Web-Mgmt-Console * IIS Management Console (Win7)
Web-Scripting-Tools * IIS Management Scripts and Tools (Win7,Core)
Web-Mgmt-Service * Management Service (Win7,Core)
Web-Mgmt-Compat * IIS 6 Management Compatibility (Win7,Core)
Web-Metabase * IIS 6 Metabase Compatibility (Win7,Core)
Web-WMI * IIS 6 WMI Compatibility (Win7,Core)
Web-Lgcy-Scripting * IIS 6 Scripting Tools (Win7,Core)
Web-Lgcy-Mgmt- * IIS 6 Management Console (Win7)
Console
Web-Ftp-Publishing * FTP Publishing Service (2008)
Web-Ftp-Server * FTP Server (2008)
Web-Ftp-Mgmt-Console * FTP Management Console (2008)
Web-Ftp-Server * FTP Server (2008R2)
Web-Ftp-Service * FTP Service (2008R2)
Web-Ftp-Ext * FTP Extensibility (2008R2)
Web-WHC * IIS Hostable Web Core (2008R2)
WDS Windows Deployment Services
WDS-Deployment * Deployment Server
WDS-Transport * Transport Server
OOB-WSUS Windows Server Update Services (2008R2)
NET-Framework .NET Framework 3.x Features
NET-Framework-Core * .NET Framework 3.x (Win7,Core)
ID FullName
NET-XPS-Viewer * XPS Viewer (2008)
NET-Win-CFAC * WCF Activation
NET-HTTP-Activation * HTTP Activation (Win7)
NET-Non-HTTP-Activ * Non-HTTP Activation (Win7,Core)
BITS Background Intelligent Transfer Service (BITS)
BITS-Compact-Server * Compact Server (2008R2)
BITS-IIS-Ext * IIS Server Extension (2008R2)
BitLocker BitLocker Drive Encryption (Core)
BranchCache BranchCache (2008R2)
CMAK Connection Manager Administration Kit
Desktop-Experience Desktop Experience
DAMC DirectAccess Management Console (2008R2)
Failover-Clustering Failover Clustering (Core)
GPMC Group Policy Management
Ink-Handwriting Ink and Handwriting Services (2008R2)
IH-Ink-Support * Ink Support (2008R2)
IH-Handwriting * Handwriting Recognition (2008R2)
Internet-Print-Client Internet Printing Client (Win7)
ISNS Internet Storage Name Server
LPR-Port-Monitor LPR Port Monitor (Win7)
MSMQ Message Queuing
MSMQ-Services * Message Queuing Services
MSMQ-Server * Message Queuing Server (Win7)
MSMQ-Directory * Directory Service Integration
MSMQ-Triggers * Message Queuing Triggers (Win7)
MSMQ-HTTP-Support * HTTP Support
MSMQ-Multicasting * Multicasting Support (Win7)
MSMQ-Routing * Routing Service
MSMQ-Win2000 * Windows 2000 Client Support (2008)
MSMQ-DCOM * Message Queuing DCOM Proxy (Win7)
Multipath-IO Multipath I/O (Core)
ID FullName
NLB Network Load Balancing (Core)
PNRP Peer Name Resolution Protocol (Core)
qWave Quality Windows Audio Video Experience (Core)
Remote-Assistance Remote Assistance
RDC Remote Differential Compression (Win7)
RSAT Remote Server Administration Tools
RSAT-Role-Tools * Role Administration Tools
RSAT-ADCS * Active Directory Certificate Services Tools
RSAT-ADCS-Mgmt * Certification Authority Tools
RSAT-Online- * Online Responder Tools
Responder
RSAT-ADLDS * Active Directory Lightweight Directory Services
Tools (2008)
RSAT-AD-Tools * AD DS and AD LDS Tools (2008R2)
RSAT-ADDS * Active Directory Domain Services Tools
RSAT-ADDS-Tools * * AD DS Snap-Ins and Command-Line Tools
(2008R2)
RSAT-AD-AdminCenter * * Active Directory Administrative Center
(2008R2)
RSAT-ADDC * * Active Directory Domain Controller Tools
(2008)
RSAT-SNIS * * Server for NIS Tools
RSAT-ADLDS * AD LDS Snap-Ins and Command-Line Tools
(2008R2)
RSAT-AD-PowerShell * Active Directory PowerShell Snap-in
(2008R2)
RSAT-RMS * Active Directory Rights Management Services
Tools
RSAT-DHCP * DHCP Server Tools
RSAT-DNS-Server * DNS Server Tools
RSAT-Fax * Fax Server Tools (Win7)
RSAT-File-Services * File Services Tools
RSAT-DFS-Mgmt-Con * Distributed File System Tools
RSAT-FSRM-Mgmt * File Server Resource Manager Tools (Core)
ID FullName
RSAT-NFS-Admin * Services for Network File System Tools
(Win7)
RSAT-Hyper-V * Hyper-V Tools (Core)
RSAT-NPAS * Network Policy and Access Services Tools
RSAT-Print-Services * Print and Document Services Tools
RSAT-TS * Terminal Services Tools (2008)
RSAT-TS-RemoteApp * Terminal Server Tools (2008)
RSAT-TS-Gateway * TS Gateway Tools (2008)
RSAT-TS-Licensing * TS Licensing Tools (2008)
RSAT-RDS * Remote Desktop Services Tools (2008R2)
RSAT-RDS-RemoteApp * Remote Desktop Server Tools (2008R2)
RSAT-RDS-Gateway * Remote Desktop Gateway Tools (2008R2)
RSAT-RDS-Licensing * Remote Desktop Licensing Tools (2008R2)
RSAT-RDS-Conn- * Remote Desktop Connection Broker Tools
Broker (2008R2)
RSAT-UDDI * UDDI Services Tools (2008)
RSAT-Web-Server * Web Server (IIS) Tools
RSAT-WDS * Windows Deployment Services Tools
RSAT-Feature-Tools * Feature Administration Tools
RSAT-BitLocker * BitLocker Drive Encryption Tools (Core)
RSAT-BitLocker * BitLocker Drive Encryption Administration
Utilities
RSAT-Bitlocker- * BitLocker Drive Encryption Tools (2008R2)
DriveEnc
RSAT-Bitlocker- * BitLocker Recovery Password Viewer
RecPwd (2008R2)
RSAT-Bits-Server * BITS Server Extensions Tools
RSAT-Clustering * Failover Clustering Tools
RSAT-NLB * Network Load Balancing Tools
RSAT-SMTP * SMTP Server Tools
RSAT-WINS * WINS Server Tools
Removable-Storage Removable Storage Manager (2008)
RPC-over-HTTP-Proxy RPC over HTTP Proxy
ID FullName
Simple-TCPIP Simple TCP/IP Services (Win7)
SMTP-Server SMTP Server
SNMP-Services SNMP Services (Win7,Core)
SNMP-Service * SNMP Service
SNMP-WMI-Provider * SNMP WMI Provider (Win7)
Storage-Mgr-SANS Storage Manager for SANs
Subsystem-UNIX-Apps Subsystem for UNIX-based Applications (Win7,Core)
Telnet-Client Telnet Client (Win7,Core)
Telnet-Server Telnet Server (Win7)
TFTP-Client TFTP Client (Win7)
Biometric-Framework Windows Biometric Framework (2008R2)
Windows-Internal-DB Windows Internal Database
PowerShell Windows PowerShell (2008)
PowerShell-ISE Windows PowerShell Integrated Scripting
Environment (ISE)
WAS Windows Process Activation Service (Win7,Core)
WAS-Process-Model * Process Model (Win7,Core)
WAS-NET-Environment * .NET Environment (Win7,Core)
WAS-Config-APIs * Configuration APIs (Win7,Core)
Backup-Features Windows Server Backup Features
Backup * Windows Server Backup (Core)
Backup-Tools * Command-line Tools (Core)
Migration Windows Server Migration Tools (2008R2)
WSRM Windows System Resource Manager
TIFF-IFilter Windows TIFF IFilter (2008R2,Win7)
WinRM-IIS-Ext WinRM IIS Extension (2008R2)
WINS-Server WINS Server (Core)
Wireless-Networking Wireless LAN Service
XPS-Viewer XPS Viewer (2008R2,Win7)
Example
[Settings]
Priority=Default
Example
[Default]
OSRoles=ADDS
OSRoleServices
A comma-delimited list of server role service IDs that will be installed on the
target computer.
Note Not all server role service IDs are compatible with all server operating systems.
Value Description
ID The server role service that will be installed on the
target computer. The valid value is:
ADDS-Domain-Controller
Example
[Settings]
Priority=Default
[Default]
OSRoleServices=ADDS-Domain-Controller
OSSKU
The edition of the currently running operating system. The operating system
edition is determined by using the OperatingSystemSKU property of the
Win32_OperatingSystem WMI class. For a list of the editions the
OperatingSystemSKU property returns, see the section,
―OperatingSystemSKU,‖ at Win32_OperatingSystem class.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
edition The operating system edition. For example,
―BUSINESS‖ for a Business edition of an operating
system or ―ENTERPRISE‖ for an Enterprise edition of
an operating system.
Example
None
OSVersion
The version of the currently running operating system.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
WinPE Windows PE
XP Windows XP
2003 Windows Server 2003
Vista Windows Vista
2008 Windows Server 2008
2008R2 Windows Server 2008 R2
Win7Client Windows 7
Example
None
OSVersionNumber
The operating system major and minor version number. this property is
referenced during OEM deployments.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
version_number The operating system major and minor version
number
Example
None
OverrideProductKey
The Multiple Activation Key (MAK) string to be applied after the target operating
is deployed to the target computer. The value specified in this property is used by
the ZTILicensing.wsf script during the State Restore Phase to apply the MAK to
the target operating system. The script also configures the volume licensing
image to use MAK activation instead of Key Management Service (KMS). The
operating system needs to be activated with Microsoft after the MAK is applied.
This is used when the target computer is unable to access a server that is
running KMS.
Value Description
MAK The MAK string to be provided to the target operating
system
Example
[Settings]
Priority=Default
[Default]
ProductKey=AAAAA-BBBBB-CCCCC-DDDDD-EEEEE-FFFFF
OverrideProductKey=AAAAA-BBBBB-CCCCC-DDDDD-EEEEE-FFFFF
PackageGroup
A list of text values that associates operating system packages with each other
(typically based on the type of operating system package). An operating system
package can be associated with one or more package groups. The
PackageGroup property allows the operating system packages within one or
more groups to be deployed to a target computer.
The text values in the list can be any non-blank value. The PackageGroup
property value has a numeric suffix (for example, PackageGroup001 or
PackageGroup002). After it is defined, a package group is associated with a
computer. A computer can be associated with more than one package group.
Note The PackageGroup property applies only to Windows Vista and later operating systems.
Note Operating system packages are created on the OS Packages node in the Deployment
Workbench.
Value Description
package_group_name Name of the package group to be deployed to the
target computer
Example
[Settings]
Priority=Default
[Default]
PackageGroup001=Updates
Packages
The list of Configuration Manager 2012 or Configuration Manager 2007 R3
packages to be deployed to the target computer. The Packages property has a
numeric suffix (for example, Packages001 or Packages002).
Note The PackageGroup property can be specified in the format PackageGroup1=Updates or
PackageGroup001=Updates.
Value Description
package_id:program_name Name of the package to be deployed to the target
computer
Example
[Settings]
Priority=Default
[Default]
Packages001=NYC00010:Install
Packages002=NYC00011:Install
PackageSelectionProfile
Profile name used during package installation.
Value Description
profile_name Profile name used during package installation
Example
[Settings]
Priority=Default
[Default]
PackageSelectionProfile=CoreApplications
Parameters
The parameters to be passed to a database query that returns property values
from columns in the table specified in the Table property. The table is located in
the database specified in the Database property on the computer specified in the
SQLServer property. The instance of SQL Server on the computer is specified in
the Instance property.
Value Description
parameter1, The list of parameters to pass to the database query
parameter2
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
[Computers]
SQLServer=NYC-SQL-01
SQLShare=SQL$
Database=MDTDB
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
ParameterCondition
Indicator of whether a Boolean AND or OR operation is performed on the
properties listed in the Parameters property.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
AND A Boolean AND operation is performed on the
properties listed in the Parameters property. Only
results that match all properties specified in the
Parameters property are returned. This is the default
Value Description
value.
OR A Boolean OR operation is performed on the
properties listed in the Parameters property. Results
that match any property specified in the Parameters
property are returned.
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
[Computers]
SQLServer=NYC-SQL-01
SQLShare=SQL$
Database=MDTDB
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
ParentDomainDNSName
Specifies the DNS domain name of an existing directory service domain when
installing a child domain.
Value Description
name Specifies the DNS domain name of an existing
directory service domain when installing a child
domain
Example
[Settings]
Priority=Default
Example
[Default]
ParentDomainDNSName=WoodGroveBank.com
Password
Specifies the password for the user name (account credentials) to use for
promoting the member server to a domain controller.
Value Description
password Specifies the password for the user name (account
credentials) to use for promoting the member server to
a domain controller
Example
[Settings]
Priority=Default
[Default]
Password=<complex_password>
Phase
The current phase of the deployment process. The Task Sequencer uses these
phases to determine which tasks must be completed.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
VALIDATION Identifies that the target computer is capable of
Value Description
running the scripts necessary to complete the
deployment process.
STATECAPTURE Saves any user state migration data before deploying
the new target operating system.
PREINSTALL Completes any tasks that need to be done (such as
creating new partitions) before the target operating
system is deployed.
INSTALL Installs the target operating system on the target
computer.
POSTINSTALL Completes any tasks that need to be done before
restoring the user state migration data. These tasks
customize the target operating system before starting
the target computer the first time (such as installing
updates or adding drivers).
STATERESTORE Restores the user state migration data saved during
the State Capture Phase.
Example
None
Port
The number of the port that should be used when connecting to the SQL Server
database instance that is used for querying property values from columns in the
table specified in the Table property. The database resides on the computer
specified in the SQLServer property. The instance of SQL Server on the
computer is specified in the Instance property. The port used during connection
is specified in the Port property.
Value Description
port The number of the port used when connecting to
SQL Server
Example
[Settings]
Priority=Computers, Default
Example
[Default]
OSInstall=YES
[Computers]
SQLServer=NYC-SQL-01
Database=MDTDB
Instance=MDT2010
Port=1433
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
PowerUsers
A list of user accounts and domain groups to be added to the local Power Users
group on the target computer. The PowerUsers property is a list of text values
that can be any non-blank value. The PowerUsers property has a numeric suffix
(for example, PowerUsers1 or PowerUsers2).
Value Description
name Name of the user or group to be added to the local
Power Users group
Example
[Settings]
Priority=Default
[Default]
Administrators001=WOODGROVEBANK\NYC Help Desk Staff
PowerUsers001=WOODGROVEBANK\User01
PowerUsers002=WOODGROVEBANK\User02
PrepareWinRE
This property specifies if the LiteTouchPE.wim file, which includes Windows RE
and optionally DaRT, is applied to the system drive as the recovery partition. This
Value Description
YES The LiteTouchPE.wim file, which includes Windows
RE and optionally DaRT, is applied to the system drive
as the recovery partition.
any other value The LiteTouchPE.wim file, which includes Windows
RE and optionally DaRT, is not applied to the system
drive as the recovery partition. This is the default
value.
Example
[Settings]
Priority=Default
[Default]
PrepareWinRE=YES
Priority
The reserved property that determines the sequence for finding configuration
values. The Priority reserved property lists each section to be searched and the
order in which the sections are searched. When a property value is found, the
ZTIGather.wsf script quits searching for the property, and the remaining sections
are not scanned for that property.
Value Description
section1, section2 The sections to be searched in the order they are to
be searched
Example
Example
[Settings]
Priority=MACAddress, Default
[Default]
UserDataLocation=NONE
CustomProperty=TRUE
[00:0F:20:35:DE:AC]
OSDNEWMACHINENAME=HPD530-1
[00:03:FF:FE:FF:FF]
OSDNEWMACHINENAME=BVMXP
ProcessorSpeed
The speed of the processor installed on the target computer in MHz. For
example, the value 1995 indicates the processor on the target computer is
running at 1,995 MHz or 2 gigahertz.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
processor_speed The speed of the processor on the target computer in
megahertz
Example
None
Product
The product name of the target computer. With some computer vendors, the
make and model might not be sufficiently unique to identify the characteristics of
a particular configuration (for example, hyperthreaded or non-hyperthreaded
chipsets). The Product property can help to differentiate.
The format for Product is undefined. Use this property to create a subsection
that contains settings targeted to a specific product name for a specific computer
Value Description
product The product name of the target computer
Example
None
ProductKey
The product key string to be configured for the target computer. Before the target
operating system is deployed, the product key specified is automatically inserted
into the appropriate location in Unattend.txt or Sysprep.inf for Windows XP and
Windows Server 2003 or in Unattend.xml for Windows Vista and later operating
systems.
Value Description
product_key The product key to be assigned to the target computer
Example
[Settings]
Priority=Default
[Default]
ProductKey=AAAAA-BBBBB-CCCCC-DDDDD-EEEEE-FFFFF
Properties
A reserved property that defines any custom, user-defined properties. These
user-defined properties are located by the ZTIGather.wsf script in the
CustomSettings.ini file, BootStrap.ini file, or the MDT DB. These properties are
additions to the predefined properties in MDT.
Value Description
custom_property1, Custom, user-defined properties to be resolved
custom_property2
Example
[Settings]
Priority=MACAddress, Default
Properties=CustomProperty, ApplicationInstall
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
UserDataLocation=NONE
CustomProperty=TRUE
[00:0F:20:35:DE:AC]
OSDNEWMACHINENAME=HPD530-1
ApplicationInstall=Custom
[00:03:FF:FE:FF:FF]
OSDNEWMACHINENAME=BVMXP
ApplicationInstall=Minimum
ReplicaDomainDNSName
Specifies the DNS domain name of the domain to replicate.
Value Description
name Specifies the DNS domain name of the domain to
replicate
Example
[Settings]
Priority=Default
[Default]
ReplicaDomainDNSName=WoodGroveBank.com
ReplicaOrNewDomain
Specifies whether to install a new domain controller as the first domain controller
in a new directory service domain or to install it as a replica directory service
domain controller.
Value Description
Replica Installs the new domain controller as a replica
directory service domain controller.
Domain Installs the new domain controller as the first domain
controller in a new directory service domain. You must
specify the TreeOrChild entry with a valid value.
Example
[Settings]
Priority=Default
[Default]
ReplicaOrNewDomain=Domain
ReplicationSourceDC
Indicates the full DNS name of the domain controller from which you replicate the
domain information.
Value Description
name Indicates the full DNS name of the domain controller
from which you replicate the domain information
Example
[Settings]
Priority=Default
[Default]
ReplicationSourceDC=dc01.WoodGroveBank.com
ResourceDrive
The drive letter mapped to the ResourceRoot property for the ZTIDrivers.wsf
and ZTIPatches.wsf scripts to use to install drivers and patches to the target
computer.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
drive_letter The letter designation for the logical drive that
contains the resources
Example
None
ResourceRoot
The value of this property is used by the ZTIDrivers.wsf and ZTIPatches.wsf
scripts to install drivers and patches to the target computer.
Note For LTI, the scripts automatically set the ResourceRoot property to be the same as the
DeployRoot property. For ZTI, the values in the DeployRoot and ResourceRoot properties can
be unique.
Value Description
UNC_path The UNC path to the shared folder that contains the
resources
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceDrive=R:
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UserDataLocation=NONE
Role
The purpose of a computer based on the tasks performed by the user on the
target computer. The Role property lists text values that can be any non-blank
value. The Role property value has a numeric suffix (for example, Role1 or
Role2). When defined, a role is associated with a computer. A computer can
perform more than one role.
Typically, the value for the Role property is set by performing a database query
in the MDT DB. The Deployment Workbench can assist in creating the role and
property settings associated with the role, and then the Deployment Workbench
can configure CustomSettings.ini to perform the database query for the Role
property and the property settings associated with the role.
Value Description
Role The roles to be assigned to an individual computer or
a group of computers
Example 1
[Settings]
Priority=RoleSettings, Default
[Default]
SkipCapture=NO
UserDataLocation=AUTO
DeployRoot=\\W2K3-SP1\Distribution$
OSInstall=YES
ScanStateArgs=/v:15 /o /c
LoadStateArgs=/v:7 /c
[RoleSettings]
SQLServer=w2k3-sp1
Instance=MDT2010
Database=MDTDB
Netlib=DBNMPNTW
SQLShare=SQL_Share
Table=RoleSettings
Parameters=Role
Example 2
[Settings]
Priority=RoleSettings, Default
[Default]
SkipCapture=NO
UserDataLocation=AUTO
DeployRoot=\\W2K3-SP1\Distribution$
OSInstall=YES
Role1=Teller
Role2=Woodgrove User
[RoleSettings]
SQLServer=w2k3-sp1
Example 2
Instance=MDT2010
Database=MDTDB
Netlib=DBNMPNTW
SQLShare=SQL_Share
Table=RoleSettings
Parameters=Role
SafeModeAdminPassword
Supplies the password for the administrator account when starting the computer
in Safe mode or a variant of Safe mode, such as Directory Services Restore
mode.
Value Description
password Supplies the password for the administrator account
when starting the computer in Safe mode or a variant
of Safe mode, such as Directory Services Restore
mode
Example
[Settings]
Priority=Default
[Default]
SafeModeAdminPassword=<complex_password>
ScanStateArgs
Arguments passed to the USMT Scanstate process. The scripts call
Scanstate.exe, and then insert the appropriate logging, progress, and state store
parameters. If this value is not included in the settings file, the user state backup
process is skipped.
Note Use the USMTMigFiles property to specify the .xml files to be used by Scanstate.exe
instead of using the /I parameter in the ScanStateArgs property. This prevents the
ZTIUserState.wsf script from potentially duplicating the same list of .xml files.
Note Do not add any of the following command line arguments when configuring this property:
/hardlink, /nocompress, /encrypt, /key, or /keyfile. The MDT scripts will add these command-line
arguments if applicable to the current deployment scenario.
Value Description
arguments The command-line arguments passed to
Scanstate.exe.
The default arguments specified by the Deployment
Workbench are as follows:
/v. Enables verbose output in the Scanstate log.
The default is 0. Specify any number from 0 to 15.
The value 5 enables verbose and status output.
/o. Overwrites any existing data in the store. If not
specified, Scanstate will fail if the store already
contains data. This option cannot be specified
more than once in a Command Prompt window.
/c. When specified, Scanstate will continue to run
even if there are nonfatal errors. Without the /c
option, Scanstate exits on the first error.
For more information about these and other
arguments, see the USMT Help files.
Example
[Settings]
Priority=Default
[Default]
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SerialNumber
The serial number of the target computer. The format for serial numbers is
undefined. Use this property to create a subsection that contains settings
targeted to a specific computer.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
serial_number The format of the serial number is undefined and is
determined by the serial number standard of each
computer manufacturer.
Example
None
SiteName
Specifies the name of an existing site where you can place the new domain
controller.
Value Description
name Specifies the name of an existing site where you can
place the new domain controller
Example
[Settings]
Priority=Default
[Default]
SiteName=FirstSite
SkipAdminAccounts
Indicates whether the Local Administrators wizard page is skipped.
Note This default value for this property is YES, which means that the Local Administrators
wizard page will be skipped by default. To display this wizard page, you must specifically set the
value of this property to NO in CustomSettings.ini or in the MDT DB.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Solution Accelerators microsoft.com/technet/SolutionAccelerators
218 Microsoft Deployment Toolkit 2012
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES Wizard page is not displayed, and the information on
that page is not collected. This is the default value.
NO Wizard page is displayed, and the information on that
page is collected.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminAccounts=NO
SkipAdminPassword=NO
SkipApplications=NO
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipProductKey=YES
SkipAdminPassword
Indicates whether the Administrator Password wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES Wizard page is not displayed, and the information on
that page is not collected.
NO Wizard page is displayed, and the information on that
page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=YES
SkipApplications=NO
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipProductKey=YES
SkipApplications
Indicates whether the Select one or more applications to install wizard page is
skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
Value Description
YES Wizard page is not displayed, and the information on
that page is not collected.
NO Wizard page is displayed, and the information on that
page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=NO
SkipApplications=YES
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipProductKey=YES
SkipBDDWelcome
Indicates whether the Welcome to Windows Deployment wizard page is
skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Note For this property to function properly it must be configured in both CustomSettings.ini and
BootStrap.ini. BootStrap.ini is processed before a deployment share (which contains
CustomSettings.ini) has been selected.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES Wizard page is not displayed, and the information on
Value Description
that page is not collected.
NO Wizard page is displayed, and the information on that
page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=YES
SkipApplications=NO
SkipBDDWelcome=YES
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipProductKey=YES
SkipBitLocker
Indicates whether the Specify the BitLocker configuration wizard page is
skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES Wizard page is not displayed, and the information on
that page is not collected.
NO Wizard page is displayed, and the information on that
page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipApplications=NO
SkipBDDWelcome=YES
SkipBitLocker=YES
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipBuild
Indicates whether the Select a task sequence to execute on this computer
wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES Wizard page is not displayed, and the information on
that page is not collected.
NO Wizard page is displayed, and the information on that
page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
Example
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=YES
SkipApplications=NO
SkipBDDWelcome=YES
SkipBuild=YES
SkipComputerBackup=NO
SkipComputerName=NO
SkipDomainMembership=NO
SkipFinalSummary=NO
SkipSummary=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipCapture
Indicates whether the Specify whether to capture an image wizard page is
skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
Example
SkipWizard=NO
SkipCapture=YES
SkipApplications=NO
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipComputerBackup
Indicates whether the Specify where to save a complete computer backup
wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=NO
SkipApplications=NO
SkipComputerBackup=YES
SkipDomainMembership=NO
Example
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipComputerName
Indicates whether the Configure the computer name wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES Wizard page is not displayed, and the information on
that page is not collected.
NO Wizard page is displayed, and the information on that
page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=NO
SkipApplications=NO
SkipComputerBackup=NO
SkipComputerName=YES
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipDomainMembership
Indicates whether the Join the computer to a domain or workgroup wizard
page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=NO
SkipApplications=NO
SkipComputerBackup=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipDomainMembership=NO
SkipFinalSummary
Indicates whether the Operating system deployment completed successfully
wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipApplications=NO
SkipBDDWelcome=YES
SkipComputerBackup=NO
SkipComputerName=NO
SkipDomainMembership=NO
SkipFinalSummary=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipProductKey=YES
SkipGroupSubFolders
By default, when specifying folders to be included when injecting drivers, patches
(packages), and so on, values are specified something like:
DriverGroup001=TopFolder\SecondFolder
PackageGroup001=TopFolder\SecondFolder
This would, by default, also include all sub-folders located under the
―SecondFolder.‖ If SkipGroupSubFolders is set to YES in CustomSettings.ini,
this behavior will change so that the subfolders will be excluded and only the
contents of ―SecondFolder‖ will be added.
Value Description
YES Do not include subfolders when matching against
groups.
NO Include subfolders when matching against groups.
This is the default behavior.
Example
[Settings]
Priority=Default
[Default]
SkipGroupSubFolders=NO
SkipLocaleSelection
Indicates whether the Locale Selection wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipApplications=NO
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipPackageDisplay
Indicates whether the Packages wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipApplications=NO
Example
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=YES
SkipLocaleSelection=NO
SkipProductKey
Indicates whether the Specify the product key needed to install this
operating system wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=YES
SkipApplications=NO
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
Example
SkipProductKey=YES
SkipSummary
Indicates whether the Ready to begin wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=YES
SkipApplications=NO
SkipBDDWelcome=YES
SkipTaskSequence=Yes
SkipComputerBackup=NO
SkipComputerName=NO
SkipDomainMembership=NO
SkipFinalSummary=NO
SkipSummary=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipTaskSequence
Indicates whether the Select a task sequence to execute on this computer
wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Note Specify the SkipBuild property when using the Deployment Workbench to configure the
Windows Deployment Wizard to skip the Select a task sequence to execute on this computer
wizard page.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipApplications=NO
SkipBDDWelcome=YES
SkipTaskSequence=NO
SkipComputerBackup=NO
SkipComputerName=NO
SkipDomainMembership=NO
SkipFinalSummary=NO
SkipSummary=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipTimeZone
Indicates whether the Set the Time Zone wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=YES
SkipApplications=NO
SkipBDDWelcome=YES
SkipTaskSequence=YES
SkipComputerBackup=NO
SkipComputerName=NO
SkipDomainMembership=NO
SkipFinalSummary=NO
SkipSummary=NO
SkipTimeZone=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipUserData
Indicates whether the Specify whether to restore user data and Specify
where to save your data and settings wizard page is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The wizard page is not displayed, and the information
on that page is not collected.
NO The wizard page is displayed, and the information on
that page is collected. This is the default value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=NO
SkipCapture=NO
SkipAdminPassword=YES
SkipApplications=NO
SkipComputerBackup=NO
SkipDomainMembership=NO
SkipUserData=NO
SkipPackageDisplay=NO
SkipLocaleSelection=NO
SkipProductKey=YES
SkipWizard
Indicates whether the entire Windows Deployment Wizard is skipped.
For other properties that must be configured when this property is set to YES,
see Providing Properties for Skipped Windows Deployment Wizard Pages.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
YES The entire wizard is not displayed, and none of the
information on the wizard pages is collected.
NO The wizard is displayed, and the information on the
enabled wizard pages is collected. This is the default
value.
Example
[Settings]
Priority=Default
[Default]
SkipWizard=YES
SLShare
The network shared folder in which the deployment logs are stored at the end of
the deployment process.
Value Description
shared_folder The name of the network shared folder in which script
logs are stored
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
Example
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
UserDataLocation=NONE
SkipCapture=NO
SkipAdminPassword=YES
SkipProductKey=YES
SLShareDynamicLogging
The network shared folder in which all MDT logs should be written during
deployment. This is used for advanced real-time debugging only.
Value Description
shared_folder The name of the network shared folder in which script
logs are stored
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
SLShareDynamicLogging=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
UserDataLocation=NONE
SkipCapture=NO
SkipAdminPassword=YES
SkipProductKey=YES
SMSTSAssignUserMode
Specifies whether user device affinity (UDA) should be be enabled and whether
approval is required. This property only works with the UDA feature in
Configuration Manager 2012.
Value Description
Auto The affinity between a user and the target device is
established, and approval is automatically perfomed.
Pending The affinity between a user and the target device is
established, and approval is submitted for
Configuration Manager administrator approval.
Disable The affinity between a user and the target device is
not established.
Example
[Settings]
Priority=Default
[Default]
SMSTSAssignUserMode=Auto
SMSTSUdaUsers=Fabrikam\Ken, Fabrikam\Pilar
SMSTSRunCommandLineUserName
Specifies the user name in Domain\User_Name format that should be used with
a Run Command Line step that is configured to run as a user.
Value Description
user_name Specifies the user name in that should be used with a
Run Command Line step
Example
[Settings]
Priority=Default
[Default]
SMSTSRunCommandLineUserName=Fabrikam\Ken
SMSTSRunCommandLineUserPassword=<complex_password>
SMSTSRunCommandLineUserPassword
Specifies the password that should be used with a Run Command Line step
that is configured to run as a user.
Value Description
user_password Specifies the password that should be used with a
Run Command Line step
Example
[Settings]
Priority=Default
[Default]
SMSTSRunCommandLineUserName=Fabrikam\Ken
SMSTSRunCommandLineUserPassword=<complex_password>
SMSTSUdaUsers
Specifies the users who will be assigned affinity with a specific device using the
UDA feature, which is available only in Configuration Manager 2012.
Value Description
Value Description
user1, user2, … The comma-separated list of users in
Domain\User_Name format that will be assigned
affinity with the target device.
Note You can only use the NetBIOS domain name in this value,
such as Fabrikam\Ken. You cannot use the fully qualified domain
name (fabrikam.com\Ken) or the UPN notation
([email protected]).
Example
[Settings]
Priority=Default
[Default]
SMSTSAssignUserMode=Auto
SMSTSUdaUsers=Fabrikam\Ken, Fabrikam\Pilar
SQLServer
The identity of the computer running SQL Server that performs a database query
that returns property values from columns in the table specified in the Table
property. The query is based on parameters specified in the Parameters and
ParameterCondition properties. The instance of SQL Server on the computer is
specified in the Instance property.
Value Description
SQL_server The name of the computer running SQL Server
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
[Computers]
Example
SQLServer=NYC-SQL-01
SQLShare=SQL$
Database=MDTDB
Instance=SQLEnterprise2005
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
SQLShare
The name of a shared folder on the computer running SQL Server (specified by
the SQLServer property). The credentials used for authentication are provided
by the UserDomain, UserID, and UserPassword properties (for LTI and ZTI) or
by the Configuration Manager Advanced Client account credentials (ZTI only).
Note This property must be specified to perform Integrated Windows authentication. This is the
recommended authentication method, rather than using the DBID and DBPwd properties (which
support the SQL Server authentication method).
Value Description
shared_folder The name of a shared folder on the computer running
SQL Server
Example
[Settings]
Priority=Computers, Default
Properties=MyCustomProperty
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
[Computers]
SQLServer=NYC-SQL-01
SQLShare=SQL$
Database=MDTDB
Example
Instance=MDT2010
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
StorageDriverGroup
The name of the storage driver group that contains drivers to be added to the
target computer during unattended installation of Windows XP or Windows
Server 2003.
For more information about using the StorageDriverGroup property, see the
section, "Deploying Additional Mass Storage Drivers for Windows XP and
Windows Server 2003", in the MDT document Microsoft Deployment Toolkit
Samples Guide.
Value Description
group_name The name of the storage driver group that contains
drivers to be added to the target computer
Example
[Settings]
Priority=Default
[Default]
StorageDriverGroup001=Laptops
StorageDriverGroup001=Universal
StorageDriverSysprepGroup
The name of the storage driver Sysprep group that contains drivers to be added
to the Windows XP or Windows Server 2003 image that is captured.
For more information about using the StorageDriverSysprepGroup property,
see the section, "Automating the Installation of Mass Storage Device Drivers", in
the MDT document Microsoft Deployment Toolkit Samples Guide.
Value Description
group_name The name of the Sysprep storage driver group that
contains drivers to be added to the target computer
Example
[Settings]
Priority=Default
[Default]
StorageDriverSysprepGroup001=AccountingStorageGroup
StorageDriverSysprepGroup002=SalesStorageGroup
StoredProcedure
The name of the stored procedure used when performing a database query that
returns property values from columns in the table or view. The stored procedure
is located in the database specified in the Database property. The computer
running SQL Server is specified in the SQLServer property. The instance of
SQL Server on the computer is specified in the Instance property. The name of
the stored procedure is specified in the StoredProcedure property.
For more information about using a stored procedure to query a SQL Server
database, see the section, "Deploying Applications Based on Earlier Application
Versions", in the MDT document Microsoft Deployment Toolkit Samples Guide.
Value Description
stored_procedure The name of the stored procedure used to query the
SQL Server database
Example
[Settings]
Priority=DynamicPackages, Default
Example
[Default]
OSInstall=YES
[DynamicPackages]
SQLDefault=DB_DynamicPackages
[DB_DynamicPackages]
SQLServer=SERVER1
Database=MDTDB
StoredProcedure=RetrievePackages
Parameters=MacAddress
SQLShare=Logs
Instance=MDT2010
Port=1433
Netlib=DBNMPNTW
SupportsHyperVRole
Specifies whether the processor resources on the target computer can support
the Hyper-V server role in Windows Server. This property is True if the value for
the following properties is set to TRUE:
SupportsNX
SupportsVT
Supports64Bit
Each of the previous properties is set using information from the CPUID
interface. For further information collected about VMs and information returned
from the CPUID interface, see the following properties:
IsHypervisorRunning
IsVM
SupportsNX
SupportsVT
Supports64Bit
VMPlatform
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The processor resources of the target computer can
support the Hyper-V server role in Windows Server.
FALSE The processor resources of the target computer
cannot support the Hyper-V server role in Windows
Server.
Example
None
SupportsNX
Specifies whether the processor resources on the target computer support the
No Execute (NX) technology. The NX technology is used in processors to
segregate areas of memory for use by either storage of processor instructions
(code) or for storage of data. This property is set using information from the
CPUID interface.
For further information collected about VMs and information returned from the
CPUID interface, see the following properties:
IsHypervisorRunning
IsVM
SupportsHyperVRole
SupportsVT
Supports64Bit
VMPlatform
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The processor resources of the target computer
support NX technology.
Value Description
FALSE The processor resources of the target computer do not
support NX technology.
Example
None
SupportsVT
Specifies whether the processor resources on the target computer support the
Virtualization Technology (VT) feature. VT is used to support current virtualized
environments, such as Hyper-V. This property is set using information from the
CPUID interface.
For further information collected about VMs and information returned from the
CPUID interface, see the following properties:
IsHypervisorRunning
IsVM
SupportsHyperVRole
SupportsNX
Supports64Bit
VMPlatform
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The processor resources of the target computer
support VT technology.
FALSE The processor resources of the target computer do not
support VT technology.
Example
None
Supports64Bit
IsHypervisorRunning
IsVM
SupportsHyperVRole
SupportsNX
SupportsVT
VMPlatform
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
TRUE The processor resources of the target computer
support a Windows 64-bit operating system.
FALSE The processor resources of the target computer do not
support a Windows 64-bit operating system.
Example
None
SysPrepDriverSelectionProfile
Profile name used to pre-load storage drivers before running Sysprep on
Windows XP and Windows Server 2003 (the default selection profile is All
Drivers).
Value Description
profile Profile name used to pre-load storage drivers
Example
[Settings]
Priority=Default
[Default]
SysPrepDriverSelectionProfile=CustomDrivers_XP
SystemLocale
Default system locale used for the operating system.
Note This property is currently supported only for Windows XP.
Value Description
locale The local of the operating system
Example
[Settings]
Priority=Default
[Default]
SystemLocale=0409:00000409
SysVolPath
Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the
local computer.
Value Description
Value Description
path Specifies the fully qualified, non-UNC path to a
directory on a fixed disk of the local computer
Example
[Settings]
Priority=Default
[Default]
SysVolPath=%DestinationLogicalDrive%\Windows\Sysvol
Table
The name of the table or view to be used in performing a database query that
returns property values from columns in the table or view. The query is based on
parameters specified in the Parameters and ParameterCondition properties.
The table or view is located in the database specified in the Database property.
The computer running SQL Server is specified in the SQLServer property. The
instance of SQL Server on the computer is specified in the Instance property.
Value Description
table_name The name of the table or view to be queried for
property values
Example
[Settings]
Priority=Computers, Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
[Computers]
SQLServer=NYC-SQL-01
SQLShare=SQL$
Database=MDTDB
Instance=MDT2010
Example
Table=Computers
Parameters=SerialNumber, AssetTag
ParameterCondition=OR
TaskSequenceID
Identifies the operating system task sequence to be deployed to the target
computer. The task sequence ID is created on the Task Sequences node in the
Deployment Workbench. The TaskSequenceID property allows alphanumeric
characters, hyphens (-), and underscores (_). The TaskSequenceID property
cannot be blank or contain spaces.
Value Description
task_sequence_id Identifier of the operating system task sequence
defined in the Deployment Workbench for the target
operating system being deployed
Note Be sure to use the TaskSequenceID specified in the
Deployment Workbench UI, not the GUID of the
TaskSequenceID.
Example
[Settings]
Priority=Default
[Default]
TaskSequenceID=Vista_BareMetal
TaskSequenceName
Specifies the name of the task sequence being run.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
task_sequence_name Name of the task sequence being run, such as Deploy
Windows 7 to Reference Computer
Example
None
TaskSequenceVersion
Specifies the version of the task sequence being run.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
task_sequence_version Version of the task sequence being run, such as 1.00
Example
None
TimeZone
The time zone in which the target computer is located. This value is inserted into
the appropriate configuration settings in Unattend.txt or Sysprep.inf for
Windows XP and Windows Server 2003.
Note This property is currently supported only for Windows XP and Windows Server 2003. For
Windows Vista and later operating systems, use the TimeZoneName property.
Value Description
time_zone_offset The numeric value that indicates the time zone where
Value Description
the target computer is located. For more information,
see the TimeZone entry for Unattend.txt in the
Ref.chm file included in the Deploy.cab file in the
\support\tools folder of the Windows Server 2003
installation CD.
Example
[Settings]
Priority=Default
[Default]
TimeZone=004
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
UserDataLocation=NONE
TimeZoneName
The time zone in which the target computer is located. This value is inserted into
the appropriate configuration settings in Unattend.xml for Windows Vista and
Windows Server 2008.
Note This property is currently supported only for Windows Vista and Windows Server 2008. For
Windows XP and Windows Server 2003, use the TimeZone property.
Value Description
time_zone_name The text value that indicates the time zone where the
target computer is located
Example
[Settings]
Priority=Default
[Default]
Example
TimeZoneName=Pacific Standard Time
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
UserDataLocation=NONE
ToolRoot
Specifies the UNC path to the Tools\proc_arch folder (where proc_arch is the
processor architecture of the currently running operating system and can have a
value of x86 or x64), which is immediately beneath the root of the folder structure
specified in the DeployRoot property. The Tools\proc_arch folder contains
utilities that MDT uses during the deployment process.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
path The UNC or local path to the Tools\proc_arch folder
(where proc_arch is the processor architecture of the
currently running operating system and can have a
value of x86 or x64) immediately beneath the root of
the folder structure specified by the DeployRoot
property
Example
None
TPMOwnerPassword
The TPM password (also known as the TPM administration password) for the
owner of the target computer. The password can be saved to a file or stored in
AD DS.
Note If the TPM ownership is already set or TPM ownership is not allowed, then the
TPMOwnerPassword property is ignored. If the TPM password is needed and the
TPMOwnerPassword property is not provided, the TPM password is set to the local Administrator
password.
Value Description
password The TPM password for the owner of the target
computer
Example
[Settings]
Priority=Default
[Default]
BDEDriveLetter=S:
BDEDriveSize=2000
BDEInstall=TPMKey
BDERecoveryKey=TRUE
BDEKeyLocation=C:
TPMOwnerPassword=<complex_password>
BackupShare=\\NYC-AM-FIL-01\Backup$
BackupDir=%OSDComputerName%
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
UDDir
The folder in which the user state migration data is stored. This folder exists
beneath the network shared folder specified in UDShare.
Value Description
folder The name of the folder that exists beneath the network
Value Description
shared folder
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
UserDataLocation=NONE
SkipCapture=NO
UDProfiles
A comma-delimited list of user profiles that need to be saved by Scanstate.exe
during the State Capture Phase.
Value Description
user_profiles The list of user profiles to be saved, separated by
commas
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
Example
UserDataLocation=NONE
SkipCapture=NO
UDShare
The network share where user state migration data is stored.
Value Description
UNC_path The UNC path to the network share where user state
migration data is stored
Example
[Settings]
Priority=Default
[Default]
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
UDProfiles=Administrator, User-01, ExtranetUser
UserDataLocation=NONE
SkipCapture=NO
UILanguage
The default language to be used with the target operating system. If not
specified, the Windows Deployment Wizard uses the language configured in
the image being deployed.
Value Description
UI_language The default language for the operating system on the
target computer
Example
[Settings]
Priority=Default
[Default]
UserLocale=en-us
UILanguage=en-us
KeyboardLocale=0409:00000409
UserDataLocation
The location in which USMT stores user state migration data.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
blank If UserDataLocation is not specified or is left blank,
the Windows Deployment Wizard will default to using
the AUTO behavior.
UNC_path The UNC path to the network shared folder where the
user state migration data is stored.
AUTO The deployment scripts store the user state migration
data on a local hard disk if space is available.
Otherwise, the user state migration data is saved to a
network location, which is specified in the UDShare
and UDDir properties.
NETWORK The user state migration data is stored in the location
designated by the UDShare and UDDir properties.
NONE The user state migration data is not saved.
Example
[Settings]
Priority=Default
Example
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DoCapture=YES
BackupShare=\\NYC-AM-FIL-01\Backup$
BackupDir=%OSDComputerName%
UserDataLocation=NETWORK
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
UserDomain
The domain in which a user’s credentials (specified in the UserID property)
reside.
Note For a completely automated LTI deployment, provide this property in both
CustomSettings.ini and BootStrap.ini. However, note that storing the user credentials in these files
stores the credentials in clear text and therefore is not secure.
Value Description
domain The name of the domain where the user account
credentials reside
Example
[Settings]
Priority=Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
Example
UserDataLocation=NONE
UserDomain=WOODGROVEBANK
UserID=NYC Help Desk Staff
UserPassword=<complex_password>
UserID
The user credentials for accessing network resources.
Note For a completely automated LTI deployment, provide this property in both
CustomSettings.ini and BootStrap.ini. However, note that storing the user credentials in these files
stores the credentials in clear text and therefore is not secure.
Value Description
user_id The name of the user account credentials used to
access the network resources
Example
[Settings]
Priority=Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UserDataLocation=NONE
UserDomain=WOODGROVEBANK
UserID=NYC-HelpDesk
UserPassword=<complex_password>
UserLocale
The user locale to be used with the target operating system. If not specified, the
Windows Deployment Wizard uses the user locale configured in the image
being deployed.
Value Description
user_locale The locale for the user on the target computer. For:
Windows Server 2003, the value is specified as a
hexadecimal value (0409:00000409)
Windows Server 2008, the value is specified as a
text value (en-us)
Example 1
[Settings]
Priority=Default
[Default]
UserLocale=0409:00000409
KeyboardLocale=0409:00000409
Example 2
[Settings]
Priority=Default
[Default]
UserLocale=en-us
KeyboardLocale=en-us
UserPassword
The password for user credentials specified in the UserID property.
Note For a completely automated LTI deployment, provide this property in both
CustomSettings.ini and BootStrap.ini. However, note that storing the user credentials in these files
stores the credentials in clear text and therefore is not secure.
Value Description
Value Description
user_password The password for the user account credentials
Example
[Settings]
Priority=Default
[Default]
UserDataLocation=NONE
UserDomain=WOODGROVEBANK
UserID=NYC-HelpDesk
UserPassword=<complex_password>
USMT3
Specifies whether USMT version 3 should be used during the deployment.
Note This property is valid when DeploymentMethod equals Replace and the target operating
system is Windows XP.
Value Description
YES Use USMT version 3.
not_specified Let the deployment scripts determine what version of
USMT should be used.
Example
[Settings]
Priority=Default
[Default]
USMT3=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
Example
SLShare=\\NYC-AM-FIL-01\Logs$
USMTMigFiles1=MigApp.xml
USMTMigFiles2=MigUser.xml
USMTMigFiles3=MigSys.xml
USMTMigFiles4=MigCustom.xml
USMTConfigFile=USMTConfig.xml
UserDataLocation=NONE
USMTConfigFile
The USMT configuration XML file that should be used when running Scanstate
and Loadstate.
Value Description
USMTConfigFile The name of the XML configuration file that should be
used when running Scanstate.exe and Loadstate.exe
Example
[Settings]
Priority=Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
USMTMigFiles1=MigApp.xml
USMTMigFiles2=MigUser.xml
USMTMigFiles3=MigSys.xml
USMTMigFiles4=MigCustom.xml
USMTConfigFile=USMTConfig.xml
UserDataLocation=NONE
USMTMigFiles
A list of files in XML format that are used by USMT (Scanstate.exe) to identify
user state migration information to be saved. When this property is not specified,
the ZTIUserState.wsf script uses MigApp.xml, MigUser.xml, and MigSys.xml.
Otherwise, ZTIUserState.wsf uses the files explicitly referenced in this property.
The USMTMigFiles property has a numeric suffix (for example,
USMTMigFiles001 or USMTMigFiles002).
Note Use this property to specify the XML files to be used by Scanstate.exe instead of using the /I
parameter in the ScanStateArgs property. This prevents the ZTIUserState.wsf script from
potentially duplicating the same list of XML files.
Note This property name can be specified using single-digit nomenclature (USMTMigFiles1) or
triple-digit nomenclature (USMTMigFiles001).
Value Description
USMTMigFile The name of the .xml file to be used as input for
Scanstate.exe, on separate lines. If not specified, the
default is MigApp.xml, MigUser.xml, and MigSys.xml.
Note If this value is specified, the default files (MigApp.xml,
MigUser.xml, and MigSys.xml) must also be added to the list if
these files are to be included.
Example
[Settings]
Priority=Default
[Default]
OSInstall=YES
ScanStateArgs=/v:5 /o /c
LoadStateArgs=/v:5 /c /lac
DeployRoot=\\NYC-AM-FIL-01\Distribution$
ResourceRoot=\\NYC-AM-FIL-01\Resource$
UDShare=\\NYC-AM-FIL-01\MigData$
UDDir=%OSDComputerName%
SLShare=\\NYC-AM-FIL-01\Logs$
USMTMigFiles001=MigApp.xml
USMTMigFiles002=MigUser.xml
Example
USMTMigFiles003=MigSys.xml
USMTMigFiles004=MigCustom.xml
UserDataLocation=NONE
UUID
The Universal Unique Identifier (UUID) stored in the System Management BIOS
of the target computer.
The format for UUID is a 16-byte value using hexadecimal digits in the following
format: 12345678-1234-1234-1234-123456789ABC. Use this property to create
a subsection that contains settings targeted to a specific computer.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
UUID The UUID of the target computer
Example
None
ValidateDomainCredentialsUNC
This property is used to specify a UNC path to a network shared folder that is
used to validate the credentials provided for joining the target computer to a
domain. The credentials being validated are specified in the DomainAdmin,
DomainAdminDomain, and DomainAdminPassword properties.
Note Ensure that no other properties in MDT use the server sharing the folder in this property.
Using a server that is already referenced by other MDT properties could result in improper
validation of the credentials.
Value Description
Value Description
unc_path Specifies the fully qualified UNC path to a network
shared folder
Example
[Settings]
Priority=Default
[Default]
ValidateDomainCredentialsUNC=\\wdg-fs-01\Source$
VHDCreateDiffVHD
This property is used to specify the name of a differencing VHD (also known as a
child VHD) file. A differencing VHD is similar to a dynamically expanding VHD but
contains only the modified disk blocks of the associated parent VHD. The parent
VHD is read only, so you must modify the differencing VHD. The differencing
VHD file is created in the same folder as the parent VHD file, so only the file
name is specified in this property. This property is only valid for the MDT New
Computer deployment scenario.
Note All parent VHD files created by MDT are stored in the VHD folder in the root of the parent
drive.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
the Create Virtual Hard Disk (VHD) task sequence step sets by configuring this
property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used with VHD files, see:
VHDCreateFileName
VHDCreateSizeMax
VHDCreateSource
VHDCreateType
VHDDisks
VHDInputVariable
VHDOutputVariable
VHDTargetDisk
Value Description
filename Specifies the name of the differencing VHD file, which
is located in the same folder as the parent VHD file
Note The differencing VHD file cannot have the same name as
the parent VHD file.
Example
[Settings]
Priority=Default
[Default]
VHDCreateDiffVHD=Win7Diff_C.vhd
VHDInputVariable=VHDTargetDisk
VHDCreateFileName
This property is used to specify the name of a VHD file. The type of VHD file is
based on the value of the VHDCreateType property. The property only includes
the file name, not the path to the file name, and is valid only for the MDT New
Computer deployment scenario.
Note The VHD files created by MDT are stored in the VHD folder in the root of the parent drive.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
the Create Virtual Hard Disk (VHD) task sequence step sets by configuring this
property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used with VHD files, see:
VHDCreateDiffVHD
VHDCreateSizeMax
VHDCreateSource
VHDCreateType
VHDDisks
VHDInputVariable
VHDOutputVariable
VHDTargetDisk
Value Description
file_name Specifies the name of the VHD file
RANDOM Automatically generates a random name for the VHD
file, which is located in the VHD folder in the root of
the parent drive
Blank Same a RANDOM
Example
[Settings]
Priority=Default
[Default]
VHDCreateSizeMax=130048
VHDCreateType=EXPANDABLE
VHDCreateFileName=Win7_C.vhd
VHDInputVariable=VHDTargetDisk
VHDCreateSizeMax
This property is used to specify the maximum size of a VHD file in megabytes
(MB). The size of the VHD file at creation time is based on the type of VHD file
being created. For more information, see the VHDCreateType property. This
property is valid only for the MDT New Computer deployment scenario.
Note If this property is not specified, the default value for the maximum size of a VHD file is 90%
of the available disk space on the parent disk.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
that the Create Virtual Hard Disk (VHD) task sequence step sets by configuring
this property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used with VHD files, see:
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSource
VHDCreateType
VHDDisks
VHDInputVariable
VHDOutputVariable
VHDTargetDisk
Value Description
size The maximum size of the VHD file specified in MB.
For example, 130,048 MB equals 127 GB. The default
value is 90% of the available disk space on the parent
disk.
Example
[Settings]
Priority=Default
[Default]
VHDCreateSizeMax=130048
VHDCreateType=FIXED
VHDCreateFileName=Win7_C.vhd
VHDInputVariable=VHDTargetDisk
VHDCreateSource
This property is used to specify the name of a VHD file that is used as a template
(source) for creating a new VHD file. You can specify the file name using a UNC
path, local path, relative path, or just the file name. If just the file name is
specified, then MDT attempts to find the VHD file on the target computer. This
property is valid only for the MDT New Computer deployment scenario.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
that the Create Virtual Hard Disk (VHD) task sequence step sets by configuring
this property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used with VHD files, see:
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSizeMax
VHDCreateType
VHDDisks
VHDInputVariable
VHDOutputVariable
VHDTargetDisk
Value Description
name The file name, which can be specified using a UNC
path, local path, relative path, or just the file name. If
just the file name is specified, then MDT attempts to
find the VHD file on the target computer.
Example
[Settings]
Priority=Default
[Default]
VHDCreateSizeMax=130048
VHDCreateSource=\\wdg-mdt-01\vhds\win7_template.vhd
VHDCreateType=FIXED
VHDCreateFileName=Win7_C.vhd
VHDInputVariable=VHDTargetDisk
VHDCreateType
This property is used to specify the type of VHD file that is specified in the
VHDCreateFileName property and can be one of the following VHD file types:
Fixed VHD file. For this VHD type, the size of the VHD specified at creation
is allocated and does not change automatically after creation. For example, if
you create a 24-gigabyte (GB) fixed VHD file, the file will be approximately
24 GB in size (with some space used for the internal VHD structure)
regardless of how much information is stored in the VHD file.
Dynamically expanding VHD file. For this VHD type, only a small
percentage of the size of the VHD specified at creation time is allocated.
Then, the VHD file continues to grow as more and more information is stored
in it. However, the VHD file cannot grow beyond the size specified at
creation. For example, if you create a 24 GB dynamically expanding VHD, it
will be small at creation. However, as information is stored in the VHD file, the
file will continue to grow but never exceed the maximum size of 24 GB.
This property is only valid for the MDT New Computer deployment scenario.
Note The maximum size of the VHD file is specified in the VHDCreateSizeMax property.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
that the Create Virtual Hard Disk (VHD) task sequence step sets by configuring
this property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used in creating VHD files, see:
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSizeMax
VHDCreateSource
VHDDisks
VHDInputVariable
VHDOutputVariable
VHDTargetDisk
Value Description
EXPANDABLE Creates a fixed VHD file
FIXED Creates a dynamically expanding VHD file
Example
[Settings]
Example
Priority=Default
[Default]
VHDCreateSizeMax=130048
VHDCreateType=EXPANDABLE
VHDCreateFileName=Win7_C.vhd
VHDInputVariable=VHDTargetDisk
VHDDisks
This property contains a list of the physical drive numbers assigned to VHD files
separated by spaces. Each time a VHD file is created, MDT adds the disk index
of the newly created disk to this property using the Index property of the
Win32_DiskDrive WMI class.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
that the Create Virtual Hard Disk (VHD) task sequence step sets by configuring
this property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used with VHD files, see:
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSizeMax
VHDCreateSource
VHDCreateType
VHDInputVariable
VHDOutputVariable
VHDTargetDisk
Value Description
Value Description
index1 index2 index3 A list of the the physical drive numbers assigned to the
VHD files separated by spaces—for example, 1 2 5.
Example
None
VHDInputVariable
This property contains a variable that contains the drive on the target computer
where the VHD files will be created. MDT creates the VHD files in the VHD folder
in the root of this drive.
Note If this property is omitted, MDT attempts to create the VHD files in the VHD folder in the root
of the first system drive.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
that the Create Virtual Hard Disk (VHD) task sequence step sets by configuring
this property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used with VHD files, see:
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSizeMax
VHDCreateSource
VHDCreateType
VHDDrives
VHDOutputVariable
VHDTargetDisk
Value Description
variable Variable that contains the drive letter on the target
computer where the VHD files will be created. MDT
creates the VHD files in the VHD folder in the root of
this drive. For example, if this property has a value of
Value Description
VHDTargetDisk, the VHDTargetDisk property
contains the drive letter (such as H).
Example
VHDCreateSizeMax=130048
VHDCreateType=EXPANDABLE
VHDCreateFileName=Win7_C.vhd
VHDInputVariable=VHDTargetDisk
VHDOutputVariable
This property contains a variable that contains the physical drive number that
was assigned to the newly created VHD file. Each time a VHD file is created,
MDT sets this property to the disk index of the newly created disk using the
Index property of the Win32_DiskDrive WMI class.
This property is commonly set using a task sequence step created using the
Create Virtual Hard Disk (VHD) task sequence type. You can override the value
that the Create Virtual Hard Disk (VHD) task sequence step sets by configuring
this property in CustomSettings.ini.
Note To configure this property in CustomSettings.ini, you must add this property to the
Properties line in CustomSettings.ini.
For related properties that are used with VHD files, see:
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSizeMax
VHDCreateSource
VHDCreateType
VHDDisks
VHDInputVariable
VHDTargetDisk
Value Description
Variable Variable will contains the physical drive number
assigned to the newly created VHD file. For example,
Value Description
if this property has a value of OSDDiskIndex, the
OSDDiskIndex property will contain the physical drive
number assigned to the newly created VHD file (such
as 4).
Example
None
VHDTargetDisk
Specifies the drive on the target computer where the VHD is to be created. This
property is later referenced in the VHDInputVariable property.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
For related properties that are used with VHD files, see:
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSizeMax
VHDCreateSource
VHDCreateType
VHDDisks
VHDInputVariable
VHDOutputVariable
Value Description
Disk Specifies the drive where the VHD is to be created
Example
None
VMHost
Specifies the name of the Hyper-V host running the VM where MDT is running.
This property is available only when the Hyper-V Integration Components are
installed and running.
Note This property is dynamically set by the MDT scripts and is not configured
in CustomSettings.ini or the MDT DB. Treat this property as read only.Table 4
lists the Windows operating systems that MDT supports and their corresponding
Hyper-V Integration Components support.
Table 4. Windows Operating Systems and Hyper-V Integration Components
Support
Value Description
Name The name of the Hyper-V host running the VM where
MDT is running
Example
None
VMName
Specifies the name of the VM where MDT is running. This property is only
available when the Hyper-V Integration Components are installed and running.
Table 5 lists the Windows operating systems supported by MDT and their
corresponding Hyper-V Integration Components support.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
name The name of the VM where MDT is running
Example
None
VMPlatform
Specifies specific information about the virtualization environment for the target
computer when the target computer is a VM. The VM platform is determined by
using WMI.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
Value Description
Hyper-V Beta or RC0 Hyper-V Beta or RC0
Hyper-V Hyper-V
VS2005R2SP1 or Virtual Server 2005 R2 with Service Pack 1 or Virtual
VPC2007 PC 2007
VS2005R2 Virtual Server 2005 R2
Windows Virtual PC Windows Virtual PC
VS2005 or VPC2004 Virtual Server 2005 or Virtual PC 2004
VirtualBox Virtual Box
VMware VMware virtualization platform
Xen Citrix Xen Server
Example
None
VRefresh
The vertical refresh rate for the monitor on the target computer. The vertical
refresh rate is specified in Hertz. In the example, the value 60 indicates that the
vertical refresh rate of the monitor is 60 Hz. This value is inserted into the
appropriate configuration settings in Unattend.txt or Sysprep.inf for Windows
Server 2003 or in Unattend.xml for Windows Server 2008.
Note The default values (in the template files Unattend.txt, Sysprep.inf, and Unattend.xml) are
1,024 pixels horizontal resolution, 768 pixels vertical resolution, 32-bit color depth, and 60 Hz
vertical refresh rate.
Value Description
refresh_rate The vertical refresh rate for the monitor on the target
computer in Hertz
Example
[Settings]
Priority=Default
[Default]
Example
BitsPerPel=32
VRefresh=60
XResolution=1024
YResolution=768
VSSMaxSize
This property is used to pass a value to the maxsize parameter of the vssadmin
resize shadowstorage command in the Vssadmin command. The maxsize
parameter is used to specify the maximum amount of space on the target volume
that can be used for storing shadow copies. For more information on the
maxsize parameter, see Vssadmin resize shadowstorage.
Value Description
maxsize_value Specifies the maximum amount of space that can be
used for storing shadow copies. The value can be
specified in bytes or as a percentage of the target
volume.
To specify the value:
In bytes, the value must be 300 MB or greater and
accept the following suffixes: KB, MB, GB, TB, PB
and EB. You can also use B, K, M, G, T, P, and E
as suffixes—for example:
VSSMaxSize=60GB
As a percentage, use the % character as the suffix
to the numeric value—for example:
VSSMaxSize=20%
Note If a suffix is not supplied, the default suffix is bytes. For
example, VSSMaxSize=1024 indicates that the VSSMaxSize
will be set to 1,024 bytes.
Example
[Settings]
Example
Priority=Default
[Default]
VSSMaxSize=25%
WDSServer
The computer running Windows Deployment Services that is used for installing
Windows Deployment Services images. The default value is the server running
Windows Deployment Services from which the image was initiated.
Note This property is dynamically set by the MDT scripts and is not configured in
CustomSettings.ini or the MDT DB. Treat this property as read only.
Value Description
WDS_server The name of the computer running Windows
Deployment Services
Example
None
WipeDisk
Specifies whether the disk should be wiped. If WipeDisk is TRUE, the
ZTIWipeDisk.wsf script will clean the disk using the Format command. The
Format command is not the most ―secure‖ way of wiping the disk.
Securely wiping the disk should be done so in a manner that follows the U.S.
Department of Defense standard 5220.22-M, which states, ―To clear magnetic
disks, overwrite all locations three times (first time with a character, second time
with its complement, and the third time with a random character).‖
When MDT wipes the disk, it uses the Format command with the /P:3 switch,
which instructs Format to zero every sector on the volume and to perform the
operation three times. There is no way to tell the Format command to use a
particular character or a random character.
Note If the disk must be securely wiped, a non-Microsoft secure disk wipe tool should be added to
the task sequence using the Run Command Line task sequence step.
Caution This property value must be specified in uppercase letters so that the deployment scripts
can properly read it.
Value Description
TRUE If WipeDisk is set to TRUE, the Win32_DiskPartition
at DiskIndex 0 and Index 0 will be formatted.
FALSE The disk will not be formatted.
Example
[Settings]
Priority=Default
[Default]
WipeDisk=TRUE
WizardSelectionProfile
Profile name used by the wizard for filtering the display of various items.
Value Description
profile_name Profile name used by the wizard for filtering the
display of various items
Example
[Settings]
Priority=Default
[Default]
WizardSelectionProfile=SelectTaskSequenceOnly
WSUSServer
This is the name of the Windows Server Update Services (WSUS) server that the
target computer should use when scanning for, downloading, and installing
updates.
For more information about what script uses this property, see
ZTIWindowsUpdate.wsf.
Value Description
server_name The name of the WSUS server, specified in HTTP
format
Example
[Settings]
Priority=Default
[Default]
WSUSServer=http://WSUSServerName
WUMU_ExcludeKB
The list of Windows Update/Microsoft Update software updates to ignore (by
associated Knowledge Base articles).
Deployment project team members will want to periodically review the list of
updates being installed by the ZTIWindowsUpdate.wsf script to verify that each
update meets the project’s needs and expectations. All updates are logged and
recorded in the ZTIWindowsUpdate.log file, which is generated during
deployment. Each update will indicate its status as INSTALL or SKIP and lists the
UpdateID, the update name, and the QNumber associated with each update. If
an update needs to be excluded, that update should be added to the
CustomSettings.ini file (for LTI deployments).
For example, if the installation of Windows Vista language packs should be
excluded, look up the line in the ZTIWindowsUpdate.log that shows where the
update was identified and installed, and then select the QNumber. For example,
the QNumber for the Windows Vista language packs is 925471.
Value Description
WUMU_ExcludeKB The list of Windows Update/Microsoft Update software
updates to ignore by QNumber
Example
[Settings]
Priority=Default
[Default]
WUMU_ExcludeKB1=925471
WUMU_ExcludeID
The list of Windows Update/Microsoft Update software updates to ignore (by
associated update ID).
Deployment project team members will want to periodically review the list of
updates being installed by the ZTIWindowsUpdate.wsf script to verify that each
update meets the project’s needs and expectations. All updates are logged and
recorded in the ZTIWindowsUpdate.log file, which is generated during
deployment. Each update will indicate its status as INSTALL or SKIP and lists the
UpdateID, the update name, and the QNumber associated with each update. If
an update should be excluded, that update should be added to the
CustomSettings.ini file (for LTI deployments).
For example, if the installation of the Windows Malicious Software Removal Tool
should be excluded, look up the line in the ZTIWindowsUpdate.log that shows
where the update was identified and installed, and then select the UpdateID
number. For example, the UpdateID number for the Windows Malicious Software
Removal Tool is adbe6425-6560-4d40-9478-1e35b3cdab4f.
Value Description
WUMU_ExcludeID The list of Windows Update/Microsoft Update software
updates to ignore, by UpdateID number
Example
Example
[Settings]
Priority=Default
[Default]
WUMU_ExcludeID1={adbe6425-6560-4d40-9478-1e35b3cdab4f}
XResolution
The horizontal resolution of the monitor on the target computer, specified in
pixels. In the example, the value 1024 indicates the horizontal resolution of the
monitor is 1,024 pixels. This value is inserted into the appropriate configuration
settings in Unattend.txt or Sysprep.inf for Windows XP and Windows
Server 2003 or in Unattend.xml for Windows Vista and Windows Server 2008.
Note The default values (in the template files Unattend.txt, Sysprep.inf, and Unattend.xml) are
1,024 pixels horizontal resolution, 768 pixels vertical resolution, 32-bit color depth, and 60 Hz
vertical refresh rate.
Value Description
horizontal_resolution The horizontal resolution of the monitor on the target
computer in pixels
Example
[Settings]
Priority=Default
[Default]
BitsPerPel=32
VRefresh=60
XResolution=1024
YResolution=768
YResolution
The vertical resolution of the monitor on the target computer, specified in pixels.
In the example, the value 768 indicates the vertical resolution of the monitor is
768 pixels. This value gets inserted into the appropriate configuration settings in
Unattend.txt or Sysprep.inf for Windows XP and Windows Server 2003 or in
Unattend.xml for Windows Vista and later operating systems.
Solution Accelerators microsoft.com/technet/SolutionAccelerators
Toolkit Reference: Properties 283
Note The default values (in the template files Unattend.txt, Sysprep.inf, and Unattend.xml) are
1,024 pixels horizontal resolution, 768 pixels vertical resolution, 32-bit color depth, and 60 Hz
vertical refresh rate.
Value Description
vertical_resolution The vertical resolution of the monitor on the target
computer in pixels
Example
[Settings]
Priority=Default
[Default]
BitsPerPel=32
VRefresh=60
XResolution=1024
YResolution=768
KeyboardLocale
OSDComputerName
UILanguage
UserLocale
OSDAddAdmin
This task sequence variable specifies a list of domain-based accounts or local
accounts to be added to the Administrators local built-in group on the target
computer.
Value Description
domain\account_name1; The format of the accounts to be made members of
computer\account_name2 the Administrators group on the target computer in
the format of domain\account and separated by
semicolons, where domain can be the name of an
Active Directory domain or the target computer
name.
Example
OSDAddAdmin=domain\user01;Win7-01\LocalUser01
OSDApplicationList
This task sequence variable specifies which applications should be selected by
default on the Install Software page of the Operating System Deployment
(OSD) Setup Wizard.
Value Description
app_id1;app_id2 A semicolon-delimited list of application to be selected
by default on the Install Software page of the
Operating System Deployment (OSD) Setup Wizard;
each application is represented by an application ID
and separated by a semicolon. The application ID is
derived from the Id attribute of each application in the
UDIWizard_Config.xml file. In the following excerpt
from a UDIWizard_Config.xml file, the 2007 Microsoft
Office system with SP2 application has an Id attribute
of 1:
<Application DisplayName="Office 2007
SP2" State="Disabled" Id="1">
Example
OSDApplicationList=2;3
OSDArchitecture
This task sequence variable specifies the processor architecture of the target
operating system to be deployed.
Value Description
Value Description
x86 The target operating system is a 32-bit operating
system.
amd64 The target operating system is a 64-bit operating
system.
Example
OSDArchitecture=amd64
OSDBitlockerStatus
This task sequence variable specifies if BitLocker is enabled on the target
computer by the BitLocker preflight check.
Value Description
PROTECTED The target computer has BitLocker enabled.
Does not exist If the target computer does not have BitLocker
enabled, then the task sequence variable does not
exist.
Example
None
OSDDiskPart
This task sequence variable specifies whether the target disk partition should be
formatted.
Value Description
TRUE The target disk partition will be formatted.
FALSE The target disk partition will not be formatted.
Example
OSDDiskPart=TRUE
OSDDomainName
This task sequence variable specifies the name of the domain to which the target
computer will be joined if the computer is configured to be a domain member.
Value Description
domain_name The name of the domain to which the target computer
will be joined. If you have configured the Computer
wizard page in the Operating System Deployment
(OSD) Setup Wizard to be Silent, the value in this
Solution Accelerators microsoft.com/technet/SolutionAccelerators
288 Microsoft Deployment Toolkit 2012
Value Description
task sequence variable must match the values
specified in the UDI Wizard Designer. Otherwise, the
wizard page will be displayed.
Note This task sequence variable is only necessary when you
are creating a new computer account in the OU. If the computer
account already exists, this variable is not needed.
Example
OSDDomainName=domain01
OSDDomainOUName
This task sequence variable specifies the name of the OU in the domain to which
the target computer account will be created when the computer joins a domain.
Value Description
ou_name The name of the OU in the domain in which the
computer account will be created
Note This task sequence variable is only necessary when you
are creating a new computer account in the OU. If the computer
account already exists, this variable is not needed.
Example
OSDDomainOUName=NewDeployOU
OSDImageIndex
This task sequence variable specifies the index number of the target operating
system in a WIM file.
Value Description
index_number The index number of the target, which is starts with an
index number of 1 for the first operating system in the
WIM file
Example
OSDImageIndex=1
OSDJoinAccount
This task sequence variable specifies the domain-based account used to join the
target computer to the domain specified in the OSDDomainName task sequence
variable. This task sequence variable is necessary if the target computer will be
joined to a domain.
Value Description
account_name The name of the account used to join the target
computer to the domain in the format of
domain\account
Example
OSDJoinAccount=domain\admin01
OSDJoinPassword
This task sequence variable specifies the password for the domain-based
account used to join the target computer to the domain specified in the
OSDJoinAccount task sequence variable. This task sequence variable is
necessary if the target computer will be joined to a domain.
Value Description
password The password of the account used to join the domain
Example
OSDJoinPassword=P@ssw0rd10
OSDLocalAdminPassword
This task sequence variable specifies the password for the Administrator local
built-in account on the target computer.
Value Description
password The password of the Administrator local built-in
account on the target computer
Example
OSDLocalAdminPassword=P@ssw0rd10
OSDNetworkJoinType
This task sequence variable specifies whether the target computer joins a
domain or a workgroup.
Value Description
0 The target computer will join a domain.
If you select this option and configure the
corresponding Operating System Deployment (OSD)
Setup Wizard page to be Silent, you must also
provide values for the OSDJoinAccount,
OSDJoinPassword, OSDDomainName, and
OSDDomainOUName task sequence variables
Value Description
accordingly. In addition, you must select Domain in
Default Selection in the Workspace pane on the
Computer Page in the UDI Wizard Designer.
1 The target computer will join a workgroup.
If you select this option and configure the
corresponding Operating System Deployment (OSD)
Setup Wizard page to be Silent, you must also
provide a value for the OSDWorkgroupName task
sequence variable. In addition, you must select
Workgroup in Default Selection in the Workspace
pane on the Computer Page in the UDI Wizard
Designer.
Example
OSDNetworkJoinType=0
OSDSetupWizCancelled
This task sequence variable specifies if the user cancelled the Operating System
Deployment (OSD) Setup Wizard.
Value Description
TRUE The user cancelled the Operating System Deployment
(OSD) Setup Wizard.
Does not exist If the wizard is not cancelled, then the task sequence
variable does not exist.
Example
None
OSDTargetDrive
This task sequence variable specifies the disk volume where the target operating
system will be deployed.
Value Description
disk_volume The disk volume designation
Example
OSDTargetDrive=C:
OSDWinPEWinDir
This task sequence variable specifies the folder in which the Windows operating
system is currently installed on the target computer.
Value Description
windows_directory The directory in which the Windows operating system
is currently installed
Example
OSDWinPEWinDir=C:\Windows
OSDWorkgroupName
This task sequence variable specifies the name of the workgroup to which the
target computer will be joined if the computer is configured to be a workgroup
member.
Value Description
workgroup_name The name of the workgroup to which the target
computer will be joined
Example
OSDWorkgroupName=WORKGROUP01
backgroundOpacity
This XML element configures the opaqueness of the background wallpaper
image specified as a decimal-formatted percentage in the
backgroundWallpaper element.
Value Description
opacity_percent The percentage of opaqueness of the
backgroundWallpaper element specified in a
decimal formatted percentage—for example, a value
of 0.8 designates 80% opaqueness.
Example
Example
<add key="backgroundOpacity" value="0.8"/>
backgroundWallpaper
This XML element provides the file name and relative path to the image that is
displayed as the background in the OSD Results dialog box. The path is relative
to the Tools\OSDResults folder in the MDT Package.
Value Description
path\\file_name Includes the relative path and file name of the
background image; the path is delimited with double
forward slashes (//).
Example
<add key="backgroundWallpaper" value="images\\Wallpaper.jpg"/>
completedText
This XML element provides the text that is displayed in the OSD Results dialog
box when the deployment is complete.
Value Description
text The text to be displayed in the OSD Results dialog
box in quotation marks when deployment is complete
Example
<add key="completedText" value="Deployment Complete"/>
headerImagePath
This XML element provides the file name and relative path to the image that is
displayed in the header of the OSD Results dialog box. The path is relative to
the Tools\OSDResults folder in the MDT Package.
Value Description
path\\file_name Includes the relative path and file name of the header
image; the path is delimited with double backslashes
(\\).
Example
<add key="headerImagePath" value="images\\Windows7_h_rgb.png"/>
timeoutMinutes
This XML element configures how many minutes the OSD Result dialog box is
displayed before the dialog box is automatically closed and the computer is
restarted.
Value Description
Non-numeric value The dialog box remains opens until Start Windows is
clicked.
Negative value The dialog box remains opens until Start Windows is
clicked.
0 The dialog box remains opens until Start Windows is
clicked.
Include decimal point The dialog box remains opens until Start Windows is
clicked.
1 - 10080 The number of minutes the dialog box will be
displayed, with a minimum value of 1 minute and a
maximum value of 10080 minutes (1 week).
Example
<add key="timeoutMinutes" value="30"/>
welcomeText
This XML element provides the welcome text that is displayed in the OSD
Results dialog box.
Value Description
welcome_text The welcome text to be displayed in the OSD Results
dialog box in quotation marks
Example
<add key="welcomeText" value="Congratulations, Windows 7 has been
sucessfully deployed to your computer."/>
Scripts
The scripts used in LTI and ZTI deployments reference properties that determine
the process steps and configuration settings used during the deployment
process. Use this reference section to help it determine the correct scripts to
include in actions and the valid arguments to provide when running each script.
The following information is provided for each script:
BDD_Autorun.wsf
This script displays a dialog box that indicates the user inserted deployment
media created by the MDT process (such as a bootable DVD or a removable
hard disk). The message is displayed for 15 seconds. If no action is taken, the
script starts LiteTouch.vbs.
For more information about LiteTouch.vbs, see the corresponding topic in
Scripts.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information required by the
Value Description
scripts to complete the deployment process
Output None
References LiteTouch.vbs. Initiates LTI
Location distribution\Scripts
Use None
Arguments
Value Description
None None
Properties
Name Read Write
None
BDD_Welcome_ENU.xml
This XML file contains the script code and HTML layout for the Welcome to
Windows Deployment page that is displayed at the start of the Windows
Deployment Wizard. This XML file is read by Wizard.hta, which runs the wizard
pages embedded in this XML file.
Value Description
Input None
Output None
References NICSettings_Definition_ENU.xml. Allows the user
to provide configuration settings for network
adapters
Wizard.hta. Displays the Windows Deployment
Wizard pages
WPEUtil.exe. Initializes Windows PE and network
connections; initiates LTI
Location distribution\Tools\platform
Use mshta.exe Wizard.hta BDD_Welcome_ENU.xml
Arguments
Value Description
None None
Properties
Name Read Write
KeyboardLocalePE
WelcomeWizardCommand
WizardComplete
Credentials_ENU.xml
This XML file contains the script code and HTML layout for the Specify
credentials for connecting to network shares wizard page in the Windows
Deployment Wizard. This XML file is read by Wizard.hta, which runs the wizard
pages embedded in this XML file.
Note This wizard page is only displayed if there is a failure while validating the predefined user
credentials.
Value Description
Input None
Output None
References Credentials_scripts.vbs. Contains user credential
support functions
Location distribution\Scripts
Use mshta.exe Wizard.hta /NotWizard
/definition:Credentials_ENU.xml
[/ValidateAgainstDomain:domain |
/ValidateAgainstUNCPath:uncpath]
</DoNotSave> </LeaveShareOpen>
Arguments
Value Description
None None
Properties
Name Read Write
None
Credentials_scripts.vbs
This script parses the arguments that were provided when loading the
Credentials_ENU.xml file into the Windows Deployment Wizard. It also performs
user credential validation. This script is read by the Credentials_ENU.xml file.
For more information about Credentials_ENU.xml, see the corresponding topic in
Scripts.
Value Description
Input None
Output Event message are written to these log files:
Credentials_scripts.log. Log file that contains
events generated by this script
BDD.log. Log file that contains events generated by
all MDT scripts
References None
Location distribution\Scripts
Use <script language="VBScript"
src="Credentials_scripts.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
UserCredentials
UserDomain
DeployWiz_Definition_ENU.xml
This XML file contains the script code and HTML layout for each wizard page in
the Windows Deployment Wizard. This file is read by Wizard.hta, which runs the
wizard pages embedded in this XML file. This .xml file contains the following
wizard pages:
Value Description
Input None
Output None
References DeployWiz_Initialization.vbs. Includes support
functions and subroutines used by the script
DeployWiz_Validation.vbs. Includes support
functions and subroutines used by the script
ZTIBackup.wsf. Creates a backup of the target
computer
ZTIPatches.wsf. Installs updates (language packs,
security updates, and so on)
ZTIUserState.wsf. Initializes user state migration to
capture and restore user state on the target
computer
Location distribution\Scripts
Use None
Arguments
Solution Accelerators microsoft.com/technet/SolutionAccelerators
Toolkit Reference: Scripts 299
Value Description
None None
Properties
Name Read Write
DeploymentMethod
DeploymentType
DeployRoot
ImageBuild
ImageFlags
IsServerOS
JoinDomain
OSDComputerName
SkipAdminPassword
SkipApplications
SkipBitLocker
SkipCapture
SkipComputerBackup
SkipComputerName
SkipDomainMembership
SkipLocaleSelection
SkipPackageDisplay
SkipProductKey
SkipSummary
SkipTaskSequence
SkipTimeZone
SkipUserData
UserDomain
UserID
UserPassword
DeployWiz_Initialization.vbs
This script initializes the pages in the Windows Deployment Wizard (stored in
DeployWiz_Definition_ENU.xml). It also contains functions and subroutines that
the Windows Deployment Wizard calls during an LTI deployment.
Value Description
Input DomainOUList.xml. Contains a list of domain OUs
ListOfLanguages.xml
LocationServer.xml. Contains a list of available
deployment shares
Environment variables. Contains the list of
property values, custom properties, database
connections, deployment rules, and other
information that the scripts require to complete the
deployment process; the environment variables are
populated by ZTIGather.wsf
Output Event message are written to these log files:
DeployWiz_Initialization.log. Log file that contains
events generated by this script
BDD.log. Log file that contains events generated by
all MDT scripts
References ZTIApplications.wsf. Initiates application installation
Location distribution\Scripts
Use <script language="VBScript"
src="DeployWiz_Initialization.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
Architecture
Applications
BackupDir
BackupFile
BackupShare
DeployWiz_Validation.vbs
This script initializes and validates the information typed in the pages of the
Windows Deployment Wizard (stored in DeployWiz_Definition_ENU.xml). This
script contains functions and subroutines that the Windows Deployment Wizard
calls during an LTI deployment.
Value Description
Input OperatingSystems.xml. Contains the list of
operating systems available for deployment
Environment variables. Contains the list of
property values, custom properties, database
connections, deployment rules, and other
information required by the scripts to complete the
deployment process; the environment variables are
Value Description
populated by ZTIGather.wsf
Output None
References Credentials_ENU.xml. Prompts the user for
credentials that will be used when connecting to
network resources
ZTIGather.wsf. Gathers properties and processing
rules
Location distribution\Scripts
Use <script language=”VBScript”
src=”DeployWiz_Validation.vbs”/>
Arguments
Value Description
None None
Properties
Name Read Write
Architecture
DeploymentType
DeployTemplate
ImageBuild
ImageProcessor
OSVersion
TaskSequenceID
TSGUID
UserCredentials
UserDomain
UserID
UserPassword
LiteTouch.vbs
This script is called by the Windows Deployment Wizard to initiate LTI. The
script:
Value Description
Input None
Output None
References BDDRun.exe
ZTIPrereq.vbs. Used to determine whether the
target computer meets the prerequisites for
deploying a new operating system
LiteTouch.wsf. The script responsible for controlling
the LTI deployment process
Location distribution\Scripts
Use cscript LiteTouch.vbs </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
None
LiteTouch.wsf
This script is called by LiteTouch.vbs and is responsible for controlling the LTI
deployment process. This includes:
Value Description
Input task_sequence_file.xml. Contains the tasks and
sequence of tasks for the LTI deployment process
Environment variables. Contains the list of
property values, custom properties, database
connections, deployment rules, and other
information required by the scripts to complete the
deployment process; the environment variables are
populated by ZTIGather.wsf
Output LiteTouch.log. Log file that contains events that this
script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References BDD_Welcome_ENU.xml. Displays the Windows
Deployment Wizard Welcome page for LTI
deployment
DeployWiz_Definition_ENU.xml. Displays the
Windows Deployment Wizard pages for LTI
deployment
Diskpart.exe. Utility that allows the automated
management of disks, partitions, and volumes
LTICleanup.wsf. Performs cleanup tasks after
deployment finishes
LTICopyScripts.wsf. Copies the deployment scripts
to a local hard drive on the target computer
MSHTA.exe. HTML application host
RecEnv.exe. If this utility exists, the user is
prompted to determine whether to launch Windows
Recovery Environment.
Regsvr32.exe. Registers files (.dll, .exe, .ocx, and
so on) with the operating system
Summary_Definition_ENU.xml. Displays the
summary results for the LTI deployment
TsmBootStrap.exe. Task sequence Bootstrap utility
Wizard.hta. Displays the Windows Deployment
Wizard pages
WPEUtil.exe. Initializes Windows PE and network
connections; initiates LTI
ZTIGather.wsf. Gathers properties and processing
rules
ZTIPrereq.vbs. Checks that the target computer
Value Description
meets the requirements for running the Windows
Deployment Wizard
ZTINICConfig.wsf. Configures activated network
adapters
ZTIUtility.vbs. Includes support functions and
subroutines the script uses
Location distribution\Scripts
Use BDDRun.exe “wscript.exe
<ScriptDirectory>\LiteTouch.wsf
</debug:value>”
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
/Start Creates a shortcut in the new operating system that
runs once the shell starts
Properties
Name Read Write
_DoNotCleanLiteTouch
_SMSTSPackageName
AdminPassword
Architecture
BootPE
ComputerBackupLocation
ComputerName
DeployDrive
DeploymentMethod
DeploymentType
LTIApply.wsf
This script is responsible for installing a Windows PE image, Windows XP image,
or Windows Vista image to the target computer. The Windows PE image is used
to collect information about the target computer and to run the deployment tasks
on the target computer.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information the scripts
require to complete the deployment process
Output LTIApply.log. Log file that contains events that this
script generates
LTIApply_wdsmcast.log. Log file that contains
events that the Wdsmcast utility generates
BDD.log. Log file that contains events that all MDT
scripts generate
References CMD.exe. Allows the running of command-line tools
Bootsect.exe. Applies a boot sector to the hard disk
ImageX.exe. A utility used to create and manage
WIM files
ZTIBCDUtility.vbs. Includes utility functions used
when performing Boot Manager tasks
ZTIConfigFile.vbs. Includes routines for processing
XML files
ZTIDiskUtility.vbs. Includes support functions and
subroutines the script uses
ZTIUtility.vbs. Includes support functions and
subroutines the script uses
Wdsmcast.exe. A utility that target computers use
to join a multicast transmission
Location distribution\Scripts
Use cscript LTIApply.wsf </pe> </post>
</debug:value>
Arguments
Value Description
/pe Uses the process for installing the Windows PE image
on the target computer
Value Description
/post Cleans up unnecessary files after the installation of an
image
/debug:value Outputs the event messages to the console and to the
.log files; if the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
Architecture
BootPE
DeployRoot
DestinationLogicalDrive
OSGUID
OSCurrentVersion
OSVersion
ImageBuild
ImageFlags
ImageProcessor
ISBDE
SourcePath
TaskSequenceID
UserDomain
UserID
UserPassword
WDSServer
LTICleanup.wsf
This script removes any files or configuration settings (such as scripts, folders,
registry entries, or automatic logon configuration settings) from the target
computer after the deployment process finishes.
Value Description
Input Environment variables. Contains the list of property
values, custom properties, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process. The
environment variables are populated by ZTIGather.wsf.
Output LTICleanup.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Bootsect.exe. Applies a boot sector to the hard disk
Net.exe. Performs network management tasks
RegSvr32.exe. Registers files (.dll, .exe, .ocx, and
so on) with the operating system
ZTIBCDUtility.vbs. Includes utility functions used
when performing Boot Manager tasks
ZTIUtility.vbs. Includes support functions and
subroutines the script uses
Location distribution\Scripts
Use cscript LTICleanup.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
_DoNotCleanLiteTouch
DeployRoot
DestinationLogicalDrive
OSVersion
LTICopyScripts.wsf
This script copies the deployment scripts for the LTI and ZTI deployment
processes to a local hard drive on the target computer.
Value Description
Input Summary_Definition_ENU.xml. Displays the
summary results for the LTI deployment
Environment variables. Contains the property
values, custom property values, database
connections, deployment rules, and other
information that the scripts require to complete the
deployment process
Output LTICopyScripts.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines the script uses
Location distribution\Scripts
Use cscript LTICopyScripts.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
None
LTIGetFolder.wsf
This script displays a dialog box that allows the user to browses to a folder. The
selected folder path is stored in the FOLDERPATH environment variable.
Solution Accelerators microsoft.com/technet/SolutionAccelerators
312 Microsoft Deployment Toolkit 2012
Value Description
Input Environment variables. Contains the list of property
values, custom properties, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process. The
environment variables are populated by ZTIGather.wsf.
Output None
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
WizUtility.vbs. Includes support functions and
subroutines that the UI uses (such as wizard pages)
Location distribution\Scripts
program_files\Microsoft Deployment Toolkit\Scripts
Use cscript LTIGetFolder.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
DefaultFolderPath
FolderPath
LTIOEM.wsf
This script is used by an OEM during an LTI OEM scenario to copy the contents
of a media deployment share to the target computer’s hard disk to prepare it for
duplication.
Value Description
Input Environment variables. Contains the list of property
Value Description
values, custom properties, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process. The
environment variables are populated by ZTIGather.wsf.
Output LTIOEM.log. Log file that contains events that this
script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References RoboCopy.exe. File and folder copy tool
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript LTIOEM.wsf </BITLOCKER | /BDE>
</debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
/BITLOCKER Enables BitLocker
/BDE Enables BitLocker
Properties
Name Read Write
_DoNotCleanLiteTouch
DeployDrive
DeployRoot
TSGUID
LTISuspend.wsf
This script suspends a task sequence to allow manual tasks to be performed.
When this script runs, it creates a Resume Task Sequence shortcut on the
user’s desktop that allows the user to restart the task sequence after all manual
tasks are completed.
Note This script is only supported while in the full operating system.
Value Description
Input Environment variables. Contains the list of property
values, custom properties, database connections,
deployment rules, and other information the scripts
require to complete the deployment process. The
environment variables are populated by ZTIGather.wsf.
Output LTISuspend.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References LiteTouch.wsf. Controls the LTI deployment
process
LTICopyScripts.wsf. Copies the deployment scripts
to a local hard drive on the target computer
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript LTISuspend.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
/Resume –
Properties
Name Read Write
LTISysprep.wsf
This script prepares the target computer for running Sysprep, runs Sysprep on
the target computer, and then verifies that Sysprep ran successfully.
Value Description
Input Environment variables. Contains the list of property
values, custom properties, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process. The
environment variables are populated by ZTIGather.wsf.
Output LTISysprep.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Expand.exe. Expands compressed files
Sysprep.exe. Prepares computers for duplication
ZTIConfigFile.vbs. Contains routines for processing
XML files
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript LTISysprep.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Solution Accelerators microsoft.com/technet/SolutionAccelerators
316 Microsoft Deployment Toolkit 2012
NICSettings_Definition_ENU.xml
This XML file contains the script code and HTML layout for the Configure Static
IP Network Settings wizard page in the Windows Deployment Wizard. During
an LTI deployment, Wizard.hta reads this file and runs the embedded wizard
page that prompts for the required network addressing configuration. If no static
IP addressing configuration is supplied, the deployment scripts will default to
using DHCP to obtain the required network configuration.
Value Description
Input None
Output None
References ZTINICUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use None
Arguments
Value Description
None None
Properties
Name Read Write
OSDAdapterxDNSServerList
Note The x in the property names listed above is a placeholder for a zero-based array that
contains network adapter information.
Summary_Definition_ENU.xml
This XML file contains the script code and HTML layout for the Deployment
Summary wizard page in the Windows Deployment Wizard. During an LTI
deployment, Wizard.hta reads this file and runs the embedded wizard page that
displays the summary results for the LTI deployment. This XML file contains the
following wizard pages:
Value Description
Input None
Output None
References Summary_Scripts.vbs. Includes support functions and
subroutines that the wizard pages embedded in this
XML file use
Location distribution\Scripts
Use None
Arguments
Value Description
None None
Properties
Summary_scripts.vbs
This script is called by the Summary wizard page of the Windows Deployment
Wizard. It contains functions and subroutines used for initialization and validation.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output Event message are written to these log files:
Summary_scripts.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References None
Location distribution\Scripts
Use <script language=”VBScript”
src=”Summary_Scripts.vbs”/>
Arguments
Value Description
None None
Properties
Name Read Write
DeploymentType
RetVal
Wizard.hta
This Hypertext Application displays the Windows Deployment Wizard pages.
Value Description
Input Environment variables. Contains the list of property
values, custom properties, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process. The
environment variables are populated by ZTIGather.wsf.
Output Wizard.log. Log file that contains events that this
script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References LTIGetFolder.wsf. Script file that initiates a
BrowseForFolder dialog box
ZTIConfigFile.vbs. Includes routines for processing
XML files
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
WizUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
program_files\Microsoft Deployment Toolkit\Scripts
Use mshta.exe Wizard.hta </definition:filename>
</NotWizard> </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
/NotWizard Used to bypass wizard page prompts
/Definition:filename Specifies the XML file that is to be loaded into the
wizard
Properties
Name Read Write
Definition
WizUtility.vbs
This script contains functions and subroutines that the various Windows
Deployment Wizard scripts reference.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output WizUtility.log. Log file that contains events that this
script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References LTIGetFolder.wsf. Script file that initiates a
BrowseForFolder dialog box
Location distribution\Scripts
program_files\Microsoft Deployment Toolkit\Scripts
Use <script language=”VBScript”
src=”WizUtility.vbs”/>
Arguments
Value Description
None None
Properties
Name Read Write
DefaultFolderPath
DefaultDestinationDisk
DefaultDestinationIsDirty
DefaultDestinationPartition
ZTIApplications.wsf
This script initiates an installation of applications that have been configured in the
Applications node in Deployment Workbench. This script will not attempt to install
any application that:
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIApplications.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIConfigFile.vbs. Includes routines for processing
XML files
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
BDDRun.exe. Runs a command that requires user
interaction
Location distribution\Scripts
Use cscript ZTIApplications.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
ApplicationGUID
ApplicationSuccessCodes
DependentApplications
DeploymentMethod
InstalledApplications
ResourceDrive
ResourceRoot
SMSTSRebootRequested
SMSTSRetryRequested
ZTIAppXmlGen.wsf
This script generates an XML file—ZTIAppXmlGen.xml—to use when
automatically capturing user data (documents) associated with installed
applications. It does so through the HKEY_CLASSES_ROOT\Software\Classes
registry key and captures any applications that:
Are not associated with one of these file extensions: .mp3, .mov, .wma, .wmv,
.chm, .evt, .evtx, .exe, .com, or .fon
Are not associated with Microsoft Office, such as the 2007 Office system or
Microsoft Office 2003.
Have a valid open handler listed at
HKEY_CLASSES_ROOT\application\shell\open\command
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
Value Description
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIAppXmlGen.xml. Contains a list of applications
installed on the target computer
ZTIAppXmlGen.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIAppXmlGen.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
DeploymentMethod
DeploymentType
ImageBuild
OSCurrentVersion
USMT3
USMTMigFiles
ZTIAuthorizeDHCP.wsf
This script uses the Netsh tool to configure the target computer so that it is an
authorized DHCP server in AD DS.
For more information about authorizing DHCP servers, see How to Use
Netsh.exe to Authorize, Unauthorize and List DHCP Servers in Active Directory.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIAuthorizeDHCP.log. Log file that contains
events that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Netsh.exe. A utility used to automate the
configuration of networking components
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIAuthorizeDHCP.wsf </debug:value>
Note The security context that this script runs under must be a member of the Enterprise Admins
group.
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
IPAddress
ZTIBackup.wsf
This script performs a backup of the target computer using the ImageX utility.
The backup is stored in the location specified in the BackupDir and BackupShare
properties.
Note When using Configuration Manager 2007 deployments, ZTIBackup.wsf performs a full
computer backup unless the ComputerBackupLocation property is set to NONE in
CustomSettings.ini or in the MDT DB.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIBackup.log. Log file that contains events that
this script generates
ZTIBackup_imagex.log. Log file that contains
events that ImageX generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ImageX.exe. A utility used to create and manage
WIM files
ZTIBCDUtility.vbs. Includes utility functions used
when performing Boot Manager tasks
ZTIDiskUtility.vbs. Includes support functions and
subroutines that the script uses
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIBackup.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
BackupDir
BackupDisk
BackupDrive
BackupFile
BackupPartition
BackupScriptComplete
BackupShare
ComputerBackupLocation
DeploymentMethod
DeploymentType
DestinationLogicalDrive
DoCapture
ImageBuild
ImageFlags
OSDStateStorePath
Phase
TaskSequenceID
ZTIBCDUtility.vbs
This script contains utility functions that some MDT scripts use when performing
Boot Manager tasks.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output None
References BCDEdit.exe. A tool for editing the boot configuration of
Windows Vista and later versions of Windows
Location distribution\Scripts
program_files\Microsoft Deployment Toolkit\Scripts
Value Description
Use <script language="VBScript"
src="ZTIBCDUtility.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
None
ZTIBde.wsf
This script installs and configures BitLocker on the target computer. BitLocker
configuration is limited to New Computer scenarios that have hard disks
configured with a single partition.
Note For ZTI and UDI deployments, the UILanguage property must be set in CustomSettings.ini
or in the MDT DB, because ZTIBde.wsf tries to read the locale from the UILanguage property.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIBde.log. Log file that contains events that this
script generates
ZTIBdeFix_diskpart.log. Log file that contains
events that the Diskpart tool generates
BDD.log. Log file that contains events that all MDT
scripts generate
References CMD.exe. Allows running of command-line tools
Defrag.exe. Defragments the hard disk
Diskpart.exe. Utility that allows for the automated
management of disks, partitions, and volumes
ServerManagerCmd.exe
ZTIDiskUtility.vbs. Includes support functions and
subroutines that the script uses
Value Description
ZTIOSRole.wsf. Installs server roles
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIBde.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
AdminPassword
BDEDriveLetter
BDEDriveSize
BDEInstall
BDEInstallSuppress
BDEKeyLocation
BDEPin
BDERecoveryKey
BDESecondPass
BdeWaitForEncryption
BitlockerInstalled
DeploymentMethod
ISBDE
OSDBitLockerCreateRecoveryPassword
OSDBitLockerMode
ZTIBIOSCheck.wsf
This script checks the BIOS on the target computer, and then looks at a list of
BIOSes that are incompatible with Windows Vista. The list of incompatible
BIOSes is stored in the ZTIBIOSCheck.xml file.
If the BIOS on the target computer is listed in the ZTIBIOSCheck.xml file, then
the script returns a status that indicates the BIOS is incompatible with Windows
Vista and the deployment process should be terminated. For information on
populating the list of incompatible BIOSes, see ZTIBIOSCheck.xml.
Value Description
Input ZTIBIOSCheck.xml. Contains a list of BIOSes that
are known to be incompatible with Windows Vista
Environment variables. Contains the property
values, custom property values, database
connections, deployment rules, and other
information that the scripts require to complete the
deployment process
Output ZTIBIOSCheck.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
Value Description
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIBIOSCheck.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (this is the behavior when the argument is not
provided)
Properties
Name Read Write
None
ZTICoalesce.wsf
Configuration Manager 2012 and Configuration Manager 2007 R3 require
packages to be numbered sequentially starting with PACKAGES001, with no
gaps in the number sequence. Otherwise, installation will fail.
This script allows you to define and name variables using identifying information
about the program to run—for example, ComputerPackages100,
ComputerPackages110, or CollectionPackages150. Then, when this script is
run, Configuration Manager 2012 or Configuration Manager 2007 R3 finds all
variables that match a pattern (for example, all variable names that contain the
string Packages) and builds a sequential list, without gaps, using the base name
PACKAGES.
For example, if the following variables were defined (using computer variables,
collection variables, or in CustomSettings.ini or the MDT DB, for example):
ComputerPackages100=XXX00001:Program
ComputerPackages110=XXX00002:Program
CollectionPackages150=XXX00003:Program
Packages001=XXX00004:Program
PACKAGES001=XXX00004:Program
PACKAGES002=XXX00001:Program
PACKAGES003=XXX00002:Program
PACKAGES004=XXX00003:Program
Configuration Manager 2012 or Configuration Manager 2007 R3 would then be
able to run all four programs.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTICoalesce.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTICoalesce.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
CoalescePattern
CoalesceTarget
ZTIConfigFile.vbs
This script contains common routines for processing MDT XML files.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIConfigFile.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Net.exe
Location distribution\Scripts
Use <script language="VBScript"
src="ZTIConfigFile.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
IsSafeForWizardHTML
MandatoryApplications
SkipGroupSubFolders
ZTIConfigure.wsf
This script configures the Unattend.xml, Sysprep.inf, or Unattend.txt file with the
property values specified earlier in the MDT deployment process. The script
configures the appropriate file based on the operating system being deployed.
This script reads the ZTIConfigure.xml file to determine how to update the
Unattend.xml, Sysprep.inf, or Unattend.txt file with the appropriate values
specified in the deployment properties. The ZTIConfigure.xml file contains the
information to translate properties to settings in the Unattend.xml, Sysprep.inf, or
Unattend.txt file.
Value Description
Input ZTIConfigure.xml. Contains a list of property values
(specified earlier in the deployment process) and
their corresponding configuration settings
Environment variables. Contains the property
values, custom property values, database
connections, deployment rules, and other
information that the scripts require to complete the
deployment process
Output ZTIConfigure.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIConfigure.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
ComputerName
DeploymentType
DeploymentMethod
DeployRoot
DestinationLogicalDrive
DomainAdminDomain
ImageBuild
ZTIConfigureADDS.wsf
This script starts Dcpromo to configure the target computer as an AD DS domain
controller. For more information about Dcpromo.exe, see Dcpromo.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIConfigureADDS.log. Log file that contains
events that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Dcpromo.exe. Installs and removes AD DS
Net.exe. Performs network management tasks
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIConfigureADDS.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
ADDSLogPath
ADDSPassword
ADDSUserDomain
ADDSUserName
AutoConfigDNS
ChildName
ConfirmGC
DatabasePath
DomainLevel
DomainNetBiosName
ForestLevel
NewDomain
NewDomainDNSName
OSVersion
ParentDomainDNSName
ReplicaOrNewDomain
ReplicaDomainDNSName
ReplicationSourceDC
SafeModeAdminPassword
SiteName
SysVolPath
ZTIConfigureDHCP.wsf
This script configures DHCP on the target computer.
Note DHCP should already be installed on the target computer before running this script.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Value Description
Output ZTIConfigureDHCP.log. Log file that contains
events that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Netsh.exe. A utility that permits automating the
configuration of networking components
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIConfigureDHCP.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
DHCPScopesxDescription
DHCPScopesxEndIP
DHCPScopesxExcludeStartIP
DHCPScopesxExcludeEndIP
DHCPScopesxIP
DHCPScopesxName
DHCPScopesxOptionRouter
DHCPScopesxOptionDNSDomainName
DHCPScopesxOptionDNSServer
DHCPScopesxOptionLease
DHCPScopesxOptionNBTNodeType
Note The x in the properties listed here is a placeholder for a zero-based array that contains
DHCP configuration information.
ZTIConfigureDNS.wsf
This script configures DNS on the target computer. To perform the actual
configuration tasks, the script uses the Dnscmd utility.
For more information about Dnscmd.exe, see Dnscmd Overview.
Note DNS should already be installed on the target computer before running this script.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIConfigureDNS.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Dnscmd.exe. Assists administrators with DNS
management
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIConfigureDNS.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
DNSServerOptionDisableRecursion
DNSServerOptionBINDSecondaries
DNSServerOptionFailOnLoad
DNSServerOptionEnableRoundRobin
DNSServerOptionEnableNetmaskOrdering
DNSServerOptionEnableSecureCache
DNSServerOptionNameCheckFlag
DNSZonesxName
DNSZonesxType
DNSZonesxMasterIP
DNSZonesxDirectoryPartition
DNSZonesxFileName
DNSZonesxScavenge
DNSZonesxUpdate
Note The x in the properties listed here is a placeholder for a zero-based array that contains DNS
configuration information.
ZTIConnect.wsf
The MDT deployment process uses this script to authenticate with a server
computer (such as a computer running SQL Server or another server that has a
shared network folder). When this script is run, it validates that a connection can
be created to the network shared folder specified in the /uncpath argument.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIConnect.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIConnect.wsf /UNCPath:<uncpath>
</debug:value>
Arguments
Value Description
/UNCPath:uncpath Specifies a fully qualified UNC path to a network shared
folder
/debug:value Outputs the event messages to the console and to the
.log files; if the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
None
ZTICopyLogs.wsf
Copy the Smsts.log and BDD.log files to a subfolder beneath the share that the
SLShare property specifies. The subfolder takes the name that
OSDComputerName, _SMSTSMachineName, or HostName specifies.
Value Description
Input Environment variables. Contains the property values,
Value Description
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTICopyLogs.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTICopyLogs.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
None
ZTIDataAccess.vbs
This script contains common routines for database access.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIDataAccess.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
Solution Accelerators microsoft.com/technet/SolutionAccelerators
Toolkit Reference: Scripts 341
Value Description
scripts generate
References None
Location distribution\Scripts
Use <script language="VBScript"
src="ZTIDataAccess.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
_SMSTSReserved1
_SMSTSReserved2
RulesFile
UserDomain
UserID
UserPassword
ZTIDisableBDEProtectors.wsf
If BitLocker is enabled, this script suspends the BitLocker protectors configured
on the system.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIDisableBDEProtectors.log. Log file that
contains events that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Value Description
Location distribution\Scripts
Use cscript ZTIDisableBDEProtectors.wsf
</debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
ImageBuild
ISBDE
OSCurrentBuild
OSCurrentVersion
OSVersion
ZTIDiskpart.wsf
This script creates the disk partitions on the target computer by calling the
Diskpart utility. The parameters used to configure the disk are specified by the
Task Sequencer or in CustomSettings.ini. ZTIDiskpart.wsf is primarily run in New
Computer scenarios. The process works like this:
1. The MDT deployment process runs the ZTIDiskpart.wsf script based on the
steps and sequence of steps in the Task Sequencer.
2. ZTIDiskpart.wsf starts the Diskpart utility and sends it the required
configuration commands.
3. ZTIDiskpart.wsf runs Diskpart.exe and provides a .txt file as a command-line
parameter.
4. The disk is initially cleaned by sending Diskpart the CLEAN command.
5. If this is the first disk and no disk configuration has been specified by the
Task Sequencer or in CustomSettings.ini, a single partition is created to store
the operating system. However, if a disk configuration has been specified, the
disk will be configured according to the specified configuration.
6. If BitLocker is to be enabled, space is reserved at the end of the first disk.
7. All format commands are queued until after Diskpart has finished. If not
explicitly specified by the Task Sequencer or in CustomSettings.ini,
ZTIDiskpart.wsf performs a quick format of drive C using the following
command: FORMAT C: /FS:NTFS /V:OSDisk /Q /Y.
8. ZTIDiskpart.wsf copies the ZTIDiskpart_diskpart.log and BDD.log files from
the RAM disk back to the hard drive.
Customize the disk configuration of the target computer by providing the required
information in the Task Sequencer or in CustomSettings.ini.
For more information about configuring disks, see the MDT document Using the
Microsoft Deployment Toolkit.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIDiskpart.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Diskpart.exe. Utility that allows for the automated
management of disks, partitions, and volumes
Format.com. Formats the hard disk
ZTIDiskUtility.vbs. Includes support functions and
subroutines that the script uses
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIDiskpart.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
Value Description
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
BDEDriveLetter
BDEDriveSize
BDEInstall
DeployDrive
DeploymentType
DestinationDisk
DestinationLogicalDrive
DoNotCreateExtraPartition
ImageBuild
OSDDiskIndex
OSDDiskpartBiosCompatibilityMode
OSDDiskType
OSDPartitions
OSDPartitionStyle
SMSTSLocalDataDrive
VolumeLetterVariable
ZTIDiskUtility.vbs
This script contains disk-related functions and subroutines that the various scripts
in the MDT deployment process call.
Value Description
Input None
Output ZTIDiskUtility.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
Value Description
References BcdBoot.exe. Configures the system partition
DiskPart.exe. Utility that allows for the automated
management of disks, partitions, and volumes
Location distribution\Scripts
Use <script language="VBScript"
src="ZTIDiskUtility.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
DestinationLogicalDrive
UILanguage
ZTIDomainJoin.wsf
During the State Restore deployment phase, this script verifies that the computer
is joined to a domain and recovers from failed attempts to join a domain.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIDomainJoin.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References LTISuspend.wsf
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIDomainJoin.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
/DomainErrorRecov Attempts to join the computer to the domain. If the value
ery: value specified in value is:
AUTO. Retry the domain join process. Restart and
retry. This is the default script behavior.
FAIL. Stops all processing. All task sequence
processing stops.
MANUAL. Stop processing; allows the user to
manually join the computer to the domain.
Properties
Name Read Write
DomainAdmin
DomainAdminDomain
DomainAdminPassword
DomainErrorRecovery
DomainJoinAttempts
JoinDomain
JoinWorkgroup
LTISuspend
MachineObjectOU
SMSTSRebootRequested
SMSTSRetryRequested
ZTIDrivers.wsf
This script installs additional device drivers onto the target computer before
initiating the configuration of the operating system. This script reads the
Drivers.xml file and copies the list of device driver files in the Drivers.xml file
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output PnpEnum.xml. Contains a list of all devices
installed on the target computer
ZTIDrivers.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Attrib.exe. Sets file and folder attributes
CMD.exe. Allows running of command-line tools
Microsoft.BDD.PnpEnum.exe. Utility that
enumerates Plug and Play devices
Reg.exe. The console registry tool for reading and
modifying registry data
ZTIConfigFile.vbs. Includes routines for processing
XML files
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIDrivers.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
Value Description
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
Architecture
CustomDriverSelectionProfile
DeploymentMethod
DeploymentType
DestinationLogicalDrive
DoCapture
DriverPaths
DriverSelectionProfile
ImageBuild
InstallFromPath
OSDAnswerFilePath
OSDAnswerFilePathSysPrep
OSDPlatformArch
Phase
ResourceRoot
SysPrepDriverSelectionProfile
ZTIGather.wsf
This script gathers the properties and processing rules that control the
deployment process. The properties and rules (also known as local properties)
are explicitly defined in this script and contained in the ZTIGather.xml file, in the
CustomSettings.ini file, and in the MDT DB (created in the Database node in the
Deployment Workbench).
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
Solution Accelerators microsoft.com/technet/SolutionAccelerators
Toolkit Reference: Scripts 349
Value Description
require to complete the deployment process
Output ZTIGather.log. Log file that contains events that this
script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Wpeutil.exe. Initializes Windows PE and network
connections; initiates LTI
ZTIDataAccess.vbs. Contains routines for database
access
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIGather.wsf </debug:value>
</localonly> </inifile:ini_file_name>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
/localonly Returns only information about the target computer and
the current operating system installed on the target
computer; does not parse the input .ini file (specified in
the /inifile argument); returns properties and rules
specified in the .ini file
If not specified, the script returns information about the
target computer and the currently installed operating
system; parses the .ini file
/inifile:ini_file_name Name and path of the input .ini file that contains the
properties and rules used in the deployment process
If not specified, the script uses the default value in
CustomSettings.ini
Properties
ZTIGroups.wsf
This script captures and restores the local group membership on the target
computer. This script is called with the /capture argument to back up the group
membership from the target computer before deploying the operating system.
The CaptureGroups property contains the list of groups that script backs up.
The script is called with the /restore argument to restore the group membership
after the operating system is deployed. When performing a restore operation, it
restores the membership of all groups that were backed up when the script was
run using the /capture argument.
Note When restoring group membership, the script does not create any destination groups that do
not already exist on the target computer. Therefore, be sure to include all required groups in the
reference computer when building the image file.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIGroups.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generates
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIGroups.wsf </debug:value>
</backup> </restore>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Value Description
/capture Backs up the group membership of the local groups on
the target computer as specified in the CaptureGroups
property
/restore Restores the group membership to the local groups
backed up earlier in the deployment process
Properties
Name Read Write
CaptureGroups
Groups
HostName
ZTILangPacksOnline.wsf
This script installs language packs for Windows Vista and later operating
systems.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTILangPacksOnline.log. Log file that contains
events that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References CMD.exe. Allows running of command-line tools
Lpksetup.exe. The Language Pack Setup tool used
to add or remove language packs
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTILangPacksOnline.wsf </debug:value>
Arguments
Value Description
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
Architecture
OSVersion
ZTIMoveStateStore.wsf
This script moves the captured user state and backup files to
C:\Windows\Temp\StateStore.
Note This script is run only when deploying images using Configuration Manager 2012 or
Configuration Manager 2007 R3.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIMoveStateStore.log. Log file that contains
events that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIMoveStateStore.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
Value Description
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
None
ZTINextPhase.wsf
This script updates the Phase property to the next phase in the deployment
process. The Task Sequencer uses these phases to determine the sequence in
which each task must be completed. The Phase property includes the following
values:
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Value Description
Output ZTINextPhase.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTINextPhase.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
DeploymentMethod
Phase
ZTINICConfig.wsf
This script configures activated network adapters with values that ZTIGather.wsf
captured based on the properties listed in the CustomSettings.ini file or the
MDT DB (created in the Database node in the Deployment Workbench).
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTINICConfig.log. Log file that contains events that
this script generates
Value Description
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
ZTINicUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTINicConfig.wsf </debug:value>
</ForceCapture> </RestoreWithinWinPE>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
/ForceCapture If there are any local networking adapters with static IP
addresses saved, this script captures those settings
and saves them to the local environment—for example,
C:\MININT\SMSOSD\OSDLogs\Variables.dat. This
script can be useful in capturing static IP settings for a
large number of computers for automation.
/RestoreWithinWinPE When specified, applies any saved static IP network
settings to the local computer, when appropriate; used
for internal processing only.
Properties
Name Read Write
DeployDrive
DeploymentMethod
DeploymentType
DeployRoot
OSDAdapterCount
OSGuid
ZTINICUtility.vbs
This script contains network adapter–related functions and subroutines that the
various scripts in the MDT deployment process call.
Value Description
Input None
Output None
References CMD.exe. Allows running of command-line tools
Netsh.exe. A utility used to automate the
configuration of networking components
Location distribution\Scripts
Use <script language="VBScript"
src="ZTINicUtility.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
OSDAdapterAdapterIndexAdapterName
Note AdapterIndex in this property is a placeholder for a zero-based array that contains network
adapter information.
ZTIOSRole.wsf
This script installs server roles for target computers that are running Windows
Server 2008 and Windows Server 2003. The script reads the OSRoles,
OSRoleServices, and OSFeatures properties to determine what should be
installed.
Value Description
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIOSRole.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References CMD.exe. Allows running of command-line tools
OCSetup.exe. Adds or to removes Windows
optional components
ServerManagerCmd.exe. Installs, configures, and
manages Windows Server 2008 roles and features
Sysocmgr.exe. Adds or removes Windows
components
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIOSRole.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
IsServerCoreOS
OSFeatures
OSRoles
OSRoleServices
ZTIPatches.wsf
This script installs updates (language packs, security updates, and so on) that
are listed in the Packages.xml file. The script self-terminates if the deployment is
not in one of the following states:
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIPatches.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Expand.exe. Expands compressed files
Pkgmgr.exe. Installs or updates Windows Vista
offline
ZTIConfigFile.vbs. Includes routines for processing
XML files
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIPatches.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
Value Description
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
Architecture
CustomPackageSelectionProfile
DeployRoot
DeploymentMethod
DeploymentType
DestinationLogicalDrive
LanguagePacks
OSDAnswerFilePath
OSDPlatformArch
PackageSelectionProfile
Phase
ResourceRoot
ZTIPowerShell.wsf
This script runs a Windows PowerShell script using a custom Windows
PowerShell host.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIPowerShell.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
Return code. The numeric value returned by the
Windows PowerShell script after completion, which
indicates the completion status of the script.
Value Description
References Microsoft.BDD.TaskSequencePSHost.exe.
Custom Windows PowerShell host used to run the
Windows PowerShell script.
Location distribution\Scripts
Use cscript ZTIPowerShell.wsf
Arguments
Value Description
None
Properties
Name Read Write
None
ZTIPrereq.vbs
This script verifies that the target computer has the prerequisite software installed
and that it is functional. The checks the script performs are:
Value Description
Input None
Output None
References None
Location distribution\Scripts
Use None
Arguments
Value Description
Value Description
None None
Properties
Name Read Write
None
ZTISCCM.wsf
This script initializes ZTI when deploying using Configuration Manager 2012 or
Configuration Manager 2007 R3. The script performs the following procedure:
1. If debugging is activated, the script creates the OSD.Debug file.
2. The script configures these properties:
ScriptRoot is set to the parent folder of the currently running script.
DeployRoot is set to the parent folder of ScriptRoot.
ResourceRoot is set to DeployRoot.
DeploySystemDrive is set to C:.
DeploymentMethod is set to SCCM.
3. When DeployRoot contains :\:
The DeployRoot folder is copied to _SMSTSMDataPath\WDPackage
ScriptRoot is set to _SMSTSMDataPath\WDPackage\Scripts
DeployRoot is set to the parent folder of ScriptRoot
ResourceRoot is set to DeployRoot
4. When Phase is NULL:
If the %SystemDrive% environment variable is X:, then DeploymentType
is set to NEWCOMPUTER and Phase is set to PREINSTALL. Otherwise,
DeploymentType is set to REPLACE and Phase is set to VALIDATION.
If the OldComputer.tag file exists in the parent folder of the current
running script, DeploymentType is set to REPLACE and Phase is set to
VALIDATION. Otherwise, DeploymentType is set to REFRESH and
Phase is set to VALIDATION.
For more information about these properties, see the corresponding topics in
Properties.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
Value Description
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTISCCM.log. Log file that contains events that this
script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTISCCM.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
_SMSTSMDataPath
Architecture
BDDPackageID
DeploymentMethod
DeploymentType
DeployRoot
Phase
ResourceRoot
ScriptRoot
ToolRoot
ZTISetVariable.wsf
This script sets the specified global task sequence variable that corresponds to
the name contained in VariableName to the value contained in VariableValue.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTISetVariable.log. Log file that contains events
that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTISetVariable.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
VariableName
VariableValue
ZTITatoo.wsf
This script tattoos the target computer with identification and version information.
The script performs the following procedure:
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTITatoo.log. Log file that contains events that this
script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Mofcomp.exe. Command-line .mof file compiler
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Value Description
Use cscript ZTITatoo.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
_SMSTSAdvertID
_SMSTSPackageID
_SMSTSSiteCode
DeploymentMethod
DeploymentType
OSVersion
TaskSequenceID
TaskSequenceName
TaskSequenceVersion
ZTIUserState.wsf
This script initializes USMT to capture and restore user state on the target
computer.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIUserState.log. Log file that contains events that
this script generates
Value Description
BDD.log. Log file that contains events that all MDT
scripts generate
References CMD.exe. Allows running of command-line tools
InstallUSMT30_x86_2000andXP.exe. Installs
USMT
InstallUSMT30_x64_XP.exe. Installs USMT
Loadstate.exe. Deposits user state data on a target
computer
Msiexec.exe. Manages the installation of .msi-
based applications
Scanstate.exe. Collects user data and settings
USMT Application Files
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIUserState.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
/Capture –
/Estimate –
/Restore –
Properties
Name Read Write
Architecture
DeploymentMethod
DeploymentType
ZTIUtility.vbs
This script contains utility functions that most of the MDT scripts use.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
Value Description
require to complete the deployment process
Output None
References Credentials_ENU.xml. Prompts the user for
credentials that will be used when connecting to
network resources
IPConfig.exe. Displays all current TCP/IP network
configuration values and refreshes DHCP and DNS
settings
MSHTA.exe. HTML application host
Regsvr32.exe. Registers files (.dll, .exe, .ocx, and
so on) with the operating system
Xcopy.exe. Copies files and directories, including
subdirectories
Location distribution\Scripts
program_files\Microsoft Deployment Toolkit\Scripts
Use <script language="VBScript"
src="ZTIUtility.vbs"/>
Arguments
Value Description
None None
Properties
Name Read Write
_SMSTSAdvertID
_SMSTSCurrentActionName
_SMSTSCustomProgressDialogMessage
_SMSTSInstructionTableSize
_SMSTSLogPath
_SMSTSMachineName
_SMSTSNextInstructionPointer
_SMSTSOrgName
_SMSTSPackageID
_SMSTSPackageName
ZTIValidate.wsf
This script ensures that it is safe for the deployment to continue by validating the
condition of the target computer. The script processes are:
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIValidate.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References Compact.exe. Displays or alters the compression of
files on NTFS file system partitions
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIValidate.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
DeploymentType
DestinationLogicalDrive
ImageBuild
ImageMemory
ImageProcessorSpeed
ZTIVHDCreate.wsf
This script is used to create a virtual hard disk (.vhd or .avhd) file on the target
computer and mount the .vhd file as a disk. Then, other portions of the LTI
deployment process deploy the Windows operating system and applications to
the newly created virtal hard disk. The script processes are as follows:
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIVHDCreate.log. Log file that contains events that
Value Description
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References ZTIDiskUtility.vbs. Includes support functions and
subroutines the script uses
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIVHDCreate.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
VHDCreateDiffVHD
VHDCreateFileName
VHDCreateSizeMax
VHDCreateSource
VHDCreateType
VHDDisks
VHDInputVariable
VHDOutputVariable
ZTIWindowsUpdate.wsf
This script downloads and installs updates from computers on a corporate
network that are running WSUS, Windows Update, or Microsoft Update using the
Windows Update Agent (WUA) application programming interface (API). By
default, this feature is disabled in each task sequence and must be manually
activated to run. This script was designed to run on Windows Vista, Windows XP,
Windows Server 2008, and Windows Server 2003.
Most enterprises will already have teams and infrastructures in place to update
newly deployed computers over the corporate network. This process involves
tracking the latest set of patches, drivers, and updates available for each desktop
configuration and determining which updates should be downloaded and
installed for each configuration. If the organization already has an established
process, this script might not be necessary. This script was designed to fill a
need for deployment teams that might not have established processes, yet want
to ensure that target computers are updated when deployed.
This script automatically scans the target computer and downloads a wide range
of updates that are found to be applicable. Among these are:
MDT supports the ability to deploy an updated version of WUA as part of the
operating system deployment. This helps ensure that target computers are
running the correct version of WUA when they are deployed. It also helps
eliminate the need to connect to the Internet and download the latest version of
WUA after deployment.
MDT can also configure WUA to collect updates from computers on the
corporate network that are running WSUS instead of connecting to Microsoft
Updates over the Internet. MDT can optionally configure WUA to use a specific
computer running WSUS using the WSUSServer property.
For additional information and for WUA deployment instructions, see How to
Install the Windows Update Agent on Client Computers.
Obtain the latest version of the WUA stand-alone installer for:
If the WUA 3.0 stand-alone installer files are in the TOOLS\architecture folder
(where architecture is either x86 or x64) on the deployment share, MDT
automatically installs WUA on the target computer.
When downloading the WUA 3.0 stand-alone installer files, save them in the
distribution\TOOLS\architecture folder (where distribution is the folder in
which the distribution point is created and architecture is either x86 or x64).
If the WUA 3.0 stand-alone installer files are not in the TOOLS\architecture
folder in the deployment share and if the existing version of WUA is
configured for a WSUS server, then WUA attempts to update itself from a
WSUS server. If the existing version of WUA is not configured for a WSUS
server, MDT attempts to download and install WUA 3.0 from the Microsoft
Update site. In this case, Internet access is required for the target computer.
Note MDT does not support authentication with proxy servers.
Verify that the latest version of the WUA is installed on the target computer.
Search the target computer for applicable updates that are not already
installed and that might be typically hidden.
Each update has an associated UpdateID and QNumber property:
The UpdateID property is in GUID form, such as 67da2176-5c57-4614-
a514-33abbdd51f67.
The QNumber property is a numerical value, such as 987654.
The script compares the UpdateID and KBArticle property values against
the list of exclusions specified in the following MDT properties:
WUMU_ExcludeID. A list of UpdateIDs to exclude; any update with an
UpdateID found in this list will not be installed.
WUMU_ExcludeKB. A list of QNumbers to exclude; any update with a
QNumber found in this list will not be installed.
In addition, any update that requires user input will be excluded and not
installed.
All updates that require approval of an End User License Agreement (EULA)
will automatically be approved by the script. Be sure to manually read and
check each EULA before running this script in a production environment.
The activity for each update is written to the ZTIWindowsUpdate.log file, with
the string INSTALL or SKIP if the update has been approved for installation,
along with the UpdateID, a short description of the update, and the QNumber.
Each update to be installed is downloaded and installed in batches.
The target computer might require more than one restart during the update
installation.
Note Windows Internet Explorer 7 requires user interaction, so it is not installed using this script.
Note By default, include QNumber 925471 in the WUMU_ExcludeKB list to prevent Windows
Vista Ultimate from installing extra language packs.
Note If intranet sources are not available, this script downloads files from two Microsoft sites:
http://update.microsoft.com/redist/wuredist.cab and
http://download.windowsupdate.com/v6/windowsupdate/redist/standalone/muauth.cab.
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIWindowsUpdate.log. Log file that contains
events that this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
Value Description
References Expand.exe. Expands compressed files
Net.exe. Performs network management tasks
WindowsUpdateAgent30-x86.exe. Installs WUA
WindowsUpdateAgent30-x64.exe. Installs WUA
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIWindowsUpdate.wsf </debug:value>
</UpdateCommand:"<IsInstalled=0|1>
<IsHidden=0|1>"> </Query:true|false>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to
the .log files. If the value specified in value is:
TRUE, event messages are sent to the console
and the .log files
FALSE, event messages are sent only to the
.log files (This is the behavior when the
argument is not provided.)
/UpdateCommand:param IsInstalled. Set to 0 to query for updates that
are not installed.
IsHidden. Set to 0 to query for updates that are
hidden.
/Query:value True. Query only for required updates. Do not
download and install any binaries.
False. Query for and install required updates.
Download and install binaries.
Note If specifying both options for UpdateCommand, they must be separated by and.
Properties
Name Read Write
Architecture
ZTIWipeDisk.wsf
This script formats the target computer’s hard disk. The script:
Value Description
Input Environment variables. Contains the property values,
custom property values, database connections,
deployment rules, and other information that the scripts
require to complete the deployment process
Output ZTIWipeDisk.log. Log file that contains events that
this script generates
BDD.log. Log file that contains events that all MDT
scripts generate
References CMD.exe. Allows running of command-line tools
Format.com. Formats the hard disk
ZTIUtility.vbs. Includes support functions and
subroutines that the script uses
Location distribution\Scripts
Use cscript ZTIWipeDisk.wsf </debug:value>
Arguments
Value Description
/debug:value Outputs the event messages to the console and to the
.log files. If the value specified in value is:
TRUE, event messages are sent to the console and
the .log files
FALSE, event messages are sent only to the .log
files (This is the behavior when the argument is not
provided.)
Properties
Name Read Write
WipeDisk
Support Files
The utilities and scripts used in LTI and ZTI deployments reference external
configuration files to determine the process steps and configuration settings used
during the deployment process.
The following information is provided for each utility:
ApplicationGroups.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
Applications.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
BootStrap.ini
The configuration file used when the target computer is not able to connect to the
appropriate deployment share. This situation occurs in the New Computer and
the Replace Computer scenarios.
Value Description
Location distribution\Control
CustomSettings.ini
The primary configuration file for the MDT processing rules used in all scenarios.
Value Description
Location distribution\Control
Deploy.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location program_files\Microsoft Deployment Toolkit\Control
DriverGroups.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
Drivers.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
LinkedDeploymentShares.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Scripts
ListOfLanguages.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Value Description
Location distribution\Scripts
MediaGroups.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Scripts
Medias.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Scripts
OperatingSystemGroups.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
OperatingSystems.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
PackageGroups.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
Packages.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
SelectionProfileGroups.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
SelectionProfiles.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
ServerManager.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location program_files\Microsoft Deployment Toolkit\Bin
Settings.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
TaskSequenceGroups.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Value Description
Location distribution\Control
TaskSequences.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control
TS.xml
Note This XML file is managed by MDT and should not require modification.
Value Description
Location distribution\Control\task_sequence_id
Note Task_sequence_id is a placeholder for the task sequence ID that was assigned to each task
sequence when it was created in the Task Sequences node in the Deployment Workbench.
Wimscript.ini
This .ini file is an ImageX configuration file that contains the list of folders and
files that will be excluded from an image. It is referenced by ImageX during the
LTI Capture Phase.
For assistance with customizing this file, see the section, ―Create an ImageX
Configuration File,‖ in the Windows Preinstallation Environment (Windows PE)
User’s Guide.
Value Description
Location distribution\Tools\platform
ZTIBIOSCheck.xml
This XML file contains metadata about BIOSes for target computers. This file is
edited manually and is read by ZTIBIOSCheck.wsf. Extract the necessary
information from a target computer to create an entry in this XML file using the
Microsoft Visual Basic® Scripting Edition (VBScript) program
(ZTIBIOS_Extract_Utility.vbs) that is embedded in this XML file.
Value Description
Value Description
Location distribution\Scripts
ZTIConfigure.xml
This XML file is used by the ZTIConfigure.wsf script to translate property values
(specified earlier in the deployment process) to configure settings in the
Unattend.xml, Sysprep.inf, or Unattend.txt file. This file is already customized to
make the appropriate translations and should not require further modification.
Value Description
Location distribution\Scripts
ZTIGather.xml
Note This XML file is preconfigured and should not require modification. Define custom properties
in the CustomSettings.ini file or the MDT DB.
Value Description
Location distribution\Scripts
ZTITatoo.mof
This .mof file, when imported into the WMI repository of the target computer
using Mofcomp.exe, creates the Microsoft_BDD_Info WMI class. This class
contains deployment-related information, such as:
DeploymentMethod
DeploymentType
DeploymentTimestamp
BuildID
BuildName
BuildVersion
OSDPackageID
OSDProgramName
OSDAdvertisementID
TaskSequenceID
TaskSequenceName
TaskSequenceVersion
Value Description
Location distribution\Scripts
Utilities
The scripts used in LTI and ZTI reference utilities that perform specialized tasks
supporting the steps used during the deployment process. Use the following
information to help determine the correct utilities to include in actions and the
valid arguments to provide when running each utility.
The following information is provided for each utility:
BCDBoot.exe
BCDBoot is a tool used to quickly set up a system partition or repair the boot
environment located on the system partition. The system partition is set up by
copying a small set of boot environment files from an installed Windows image.
BCDBoot also creates a Boot Configuration Data (BCD) store on the system
partition, with a new boot entry that enables Windows to boot to the installed
Windows image.
For more information about BCDBoot.exe, see the BCDBoot Command-Line
Options topic in the Windows Automated Installation Kit (Windows AIK) for
Windows 7.
Value Description
Location Included in the Windows AIK for Windows 7
Arguments
Value Description
See the command-line help provided by this utility and
the Windows AIK.
BDDRun.exe
This utility is run as an action by the Task Sequencer for executables (such as a
script or other code) that require user interaction. By default, the task sequence
cannot run an executable that requires user interaction. However, this utility
allows the Task Sequencer to run an executable that requires user interaction.
The executable that requires user interaction is provided as an argument to this
utility. This utility runs the executable in a separate command environment.
Note This utility can only be used in LTI deployments. ZTI deployments prohibit any user
interaction.
Value Description
Location distribution\Tools\platform
Use BDDRun.exe commandline
Arguments
Value Description
commandline The command to be run that requires user interaction
Note Put double quotation marks around any part of the command-line portion of the argument
that contains blanks. For example: BDDRun.exe MyAppInstall.exe
/destinationdir: "%ProgramFiles%\AppName".
Bootsect.exe
Bootsect.exe updates the master boot code for hard disk partitions to switch
between BOOTMGR and NTLDR. Use this utility to restore the boot sector on the
computer.
For more information on Bootsect.exe, see the section, ―Bootsect Command-Line
Options,‖ in the Windows Preinstallation Environment (Windows PE) User’s
Guide.
Value Description
Location distribution\Tools\platform
Use bootsect.exe /nt52 C:
Arguments
Value Description
/Help Displays the use instructions listed here.
/nt52 Applies the master boot code compatible with NTLDR to
SYS, ALL, or DriveLetter. The operating system
Value Description
installed on SYS, ALL, or DriveLetter must be an earlier
version of Windows Vista.
/nt60 Applies the master boot code compatible with
BOOTMGR to SYS, ALL, or DriveLetter. The operating
system installed on SYS, ALL, or DriveLetter must be
Windows Vista.
SYS Updates the master boot code on the system partition
used to boot Windows.
All Updates the master boot code on all partitions. ALL
does not necessarily update the boot code for each
volume. Instead, this option updates the boot code on
volumes that can be used as Windows boot volumes,
which excludes any dynamic volumes not connected
with an underlying disk partition. This restriction is
present, because the boot code must be located at the
beginning of a disk partition.
DriveLetter Updates the master boot code on the volume
associated with this drive letter. The boot code will not
be updated if either (1) DriveLetter is not associated
with a volume or (2) DriveLetter is associated with a
volume not connected to an underlying disk partition.
/Force Forcibly dismounts the volumes during the boot code
update. Use this option with caution.
Compact.exe
Displays or alters the compression of files on NTFS file system partitions.
Value Description
Location Included in the Windows source files
Arguments
Value Description
/C Compresses the specified files. Directories will be
marked so that files added afterward will be
compressed.
/V Decompresses the specified files. Directories will be
marked so that files added afterward will not be
compressed.
/S Performs the specified operation on files in the given
directory and in all subdirectories. Default dir is the
Value Description
current directory.
/A Displays files with the hidden or system attributes.
These files are omitted by default.
/I Continues performing the specified operation even after
errors have occurred. By default, Compact.exe stops
when an error is encountered.
/F Forces the compress operation on all specified files,
even those which are already compressed. Already-
compressed files are skipped by default.
/Q Reports only the most essential information.
filename Specifies a pattern, file, or directory.
Diskpart.exe
Diskpart is a text-mode command interpreter in Windows Vista, Windows XP,
and Windows Server 2003. Using this utility allows management of objects
(disks, partitions, or volumes) using scripts or direct input in a Command Prompt
window.
For more information on Diskpart.exe, see the section, ―Diskpart Command-Line
Options,‖ in the Windows Preinstallation Environment (Windows PE) User’s
Guide.
Value Description
Location Included in the Windows PE source files
Arguments
Value Description
See the guide referenced in the utility description.
Expand.exe
This utility is run to expand (extract) files from compressed files.
Value Description
Location Included in the Windows source files
Use Expand.exe -r wuredist.cab -F:wuRedist.xml
%temp%
Arguments
Value Description
-r Renames expanded files
-D Displays the list of files in the source directory
Source Source file specification (Wildcards can be used.)
-F:Files Name of files to expand from a .cab file
Destination Destination file | path specification (Destination can be
a directory. If Source is multiple files and -r is not
specified, Destination must be a directory.)
ImageX.exe
ImageX is a command-line utility that enables OEMs and corporations to capture,
modify, and apply file-based disk images for rapid deployment. ImageX works
with WIM files for copying to a network, or it can work with other technologies
that use WIM images, such as Windows Setup and Windows Deployment
Services.
For more information about ImageX, see the section, ―What is ImageX,‖ in the
Windows Preinstallation Environment (Windows PE) User’s Guide.
Value Description
Location distribution\Tools\platform
Arguments
Value Description
See the guide referenced in the utility description.
Intlcfg.exe
The International Settings Configuration Tool (Intlcfg.exe) is used to change the
language and locale, fonts, and input settings for a Windows Vista and Windows
Server 2008 images. Typically, you run Intlcfg.exe after applying one or more
language packs to your Windows image.
For more information about Intlcfg.exe, see the Intlcfg Command-Line Options
topic in the Windows AIK for Windows 7.
Note The Intlcfg tool is used to configure Windows Vista and Windows Server 2008 computers
only. To change the international settings on Windows 7 and Windows Server 2008 R2, use the
Deployment Image Servicing and Management tool.
Value Description
Location distribution\Tools\platform
Arguments
Value Description
See the command-line help that this utility and the
Windows AIK provide.
Microsoft.BDD.PnpEnum.exe
This utility is run to enumerate Plug and Play devices installed on the target
computer.
Value Description
Location distribution\Tools\platform
Arguments
Value Description
None –
Mofcomp.exe
Mofcomp.exe is the Managed Object Format compiler that parses a file that
contains Managed Object Format statements and adds the classes and class
instances defined in the file to the WMI repository. Mofcomp.exe provides
command-line help on the switch use options.
Value Description
Location Included in the Windows source files
Arguments
Value Description
See the command-line help that this utility provides.
Netsh.exe
Netsh.exe is a command-line and scripting utility used to automate the
configuration of networking components. For more information about Netsh.exe,
see The Netsh Command-Line Utility.
Value Description
Location Included in the Windows source files
Arguments
Value Description
See the command-line help that this utility provides or
the information found at the URL listed in the utility
description.
Reg.exe
The Console Registry Tool is used to read and modify registry data.
Value Description
Location Included in the Windows source files
Arguments
Value Description
See the command-line help that this utility provides.
Regsvr32.exe
This utility is used to register files (.dll, .exe, .ocx, and so on) with the operating
system.
Value Description
Location Included in the Windows source files
Arguments
Value Description
file The name of the file to register or unregister
/s Runs the utility in silent mode
/u Unregisters the file
Wdsmcast.exe
This utility is used by target computers to join a multicast transmission. It is only
available in the Windows Server 2008 Windows AIK.
Solution Accelerators microsoft.com/technet/SolutionAccelerators
394 Microsoft Deployment Toolkit 2012
For more information about Wdsmcast.exe, see the corresponding section in the
Windows Server 2008 Windows AIK.
Value Description
Location Included in the Windows Server 2008 Windows AIK
Arguments
Value Description
See the guide referenced in the utility description.
Wpeutil.exe
The Windows PE utility (Wpeutil) is a command-line utility with which various
commands can be run in a Windows PE session. For example, an administrator
can shut down or reboot Windows PE, activate or deactivate a firewall, configure
language settings, and initialize a network. MDT uses the utility to initialize
Windows PE and network connections, and start LTI deployments.
For more information on Wpeutil.exe, see the section, ―Wpeutil Command-Line
Options,‖ in the Windows Preinstallation Environment (Windows PE) User’s
Guide.
Value Description
Location Included in the Windows PE source files
Arguments
Value Description
See the guide referenced in the utility description.
Table Description
BDDAdminCore Provides backward-compatibility for Microsoft
Business Desktop Deployment (BDD) 2.5;
not managed by Deployment Workbench.
ComputerIdentity Used to identify a specific computer using
any combination of the AssetTag, UUID,
SerialNumber, and MACAddress
properties. The table includes a Description
column to provide a user-friendly method of
describing the computer (usually the
computer name).
Descriptions Contains descriptions of all properties
configurable via the database.
LocationIdentity Used to identify geographic locations using
the Location property. The values for this
property are stored in a corresponding
column in the table.
LocationIdentity_DefaultGateway Relates the default gateway values with a
location identified in the LocationIdentity
table. There is a one-to-many relationship
between this table and the LocationIdentity
table.
Table Description
MakeModelIdentity Used to identify a specific make and model of
a computer using the Make and Model
properties. The values for these properties
are stored in corresponding columns in the
table.
PackageMapping Used to associate the name presented in the
Add or Remove Programs Control Panel item
with a Configuration Manager 2012 or
Configuration Manager 2007 R3 package
and program to be deployed in place of the
application in Add or Remove Programs. For
more information on this table, see the
section, "Deploying Applications Based on
Earlier Application Versions", in the MDT
document Microsoft Deployment Toolkit
Samples Guide.
RoleIdentity Used to identify the purpose of a computer or
the users of a computer using the Role
property. The values for this property are
stored in a corresponding column in the
table.
Settings Identifies the settings that are applied to an
individual computer or a group of computers
based on the settings in the Computers,
Roles, Locations, and Make and Model
nodes in the Database node in the
Deployment Workbench.
Settings_Administrators Identifies the user accounts to be added to
the local Administrator group on the target
computer based on the settings in the
Computers, Roles, Locations, and Make and
Model nodes in the Database node in the
Deployment Workbench.
Settings_Applications Identifies the applications to be deployed to
the target computer based on the settings in
the Computers, Roles, Locations, and Make
and Model nodes in the Database node in the
Deployment Workbench.
Settings_Packages Identifies the packages to be deployed to the
target computer based on the settings in the
Computers, Roles, Locations, and Make and
Model nodes in the Database node in the
Deployment Workbench.
Settings_Roles Identifies the roles to be associated with the
Table Description
target computer based on the settings in the
Computers, Locations, and Make and Model
nodes in the Database node in the
Deployment Workbench.
View Description
ComputerAdministrators Used to find all accounts to be made members
of the local Administrators group on the target
computer. The view is a join of the
ComputerIdentity and Settings_Administrators
tables.
ComputerApplications Used to find all applications to be deployed to
the target computer. The view is a join of the
ComputerIdentity and Settings_Applications
tables.
ComputerPackages Used to find all packages to be deployed to the
target computer. The view is a join of the
ComputerIdentity and Settings_Packages
tables.
ComputerRoles Used to find all roles to be associated with the
target computer. The view is a join of the
ComputerIdentity and Settings_Roles tables.
ComputerSettings Used to find all property settings to be
configured for the target computer. The view is
a join of the ComputerIdentity and Settings
tables.
LocationAdministrators Used to find all the accounts to be made a
member of the local Administrators group on
the target computers within a location. The
view is a join of the LocationIdentity,
LocationIdentity_DefaultGateway, and
Settings_Administrators tables.
LocationApplications Used to find all the applications to be deployed
to the target computers within a location. The
view is a join of the LocationIdentity,
LocationIdentity_DefaultGateway, and
Settings_Applications tables.
View Description
LocationPackages Used to find all the packages to be deployed to
the target computers within a location. The
view is a join of the LocationIdentity,
LocationIdentity_DefaultGateway, and
Settings_Packages tables.
LocationRoles Used to find all the roles to be associated with
the target computers within a location. The
view is a join of the LocationIdentity,
LocationIdentity_DefaultGateway, and
Settings_Roles tables.
Locations Used to find the IP addresses for the default
gateways within a location or for all the
locations that contain a specified IP address
for a default gateway. The view is a join of the
LocationIdentity and
LocationIdentity_DefaultGateway tables.
LocationSettings Used to find all the property settings to be
configured for the target computers within a
location. The view is a join of the
LocationIdentity,
LocationIdentity_DefaultGateway, and Settings
tables.
MakeModelAdministrators Used to find all accounts to be made members
of the local Administrators group on the target
computers with a given make and model. The
view is a join of the MakeModelIdentity and
Settings_Administrators tables.
MakeModelApplications Used to find all applications to be deployed to
the target computers with a given make and
model. The view is a join of the
MakeModelIdentity and Settings_Applications
tables.
MakeModelPackages Used to find all packages to be deployed to the
target computers with a given make and
model. The view is a join of the
MakeModelIdentity and Settings_Applications
tables.
MakeModelRoles Used to find all roles associated with the target
computers with a given make and model. The
view is a join of the MakeModelIdentity and
Settings_Roles tables.
MakeModelSettings Used to find all property settings to be
configured for the target computers with a
View Description
given make and model. The view is a join of
the MakeModelIdentity and Settings tables.
RoleAdministrators Used to find all accounts to be made members
of the local Administrators group on the target
computers with a given role. The view is a join
of the RoleIdentity and Settings_Administrators
tables.
RoleApplications Used to find all applications to be deployed to
the target computers with a given role. The
view is a join of the RoleIdentity and
Settings_Applications tables.
RolePackages Used to find all packages to be deployed to the
target computers with a given role. The view is
a join of the RoleIdentity and
Settings_Packages tables.
RoleSettings Used to find all property settings to be
configured for the target computers with a
given role. The view is a join of the RoleIdentity
and Settings tables.
UDI Reference
This reference provides further information about UDI and includes topics on:
UDI Concepts
This section contains concepts that help describe UDI, the UDI Wizard, and the
UDI Wizard Designer.
Display Name
The display name is used to provide a user-friendly, descriptive name for a
wizard page within the Page Library in the UDI Wizard Designer. The display
name is displayed in blue text for each wizard page in the Page Library and on
the Flow tab in the UDI Wizard Designer.
When you add a page to the Page Library, you must provide the display name.
After the wizard page is added to the Page Library, you cannot change the
display name.
Flow
The Flow tab displays the list of wizard pages within a UDI stage in the UDI
Wizard Designer. You can use the Flow tab to perform the following tasks:
Add a wizard page from the Page Library to a UDI stage by dragging the
page from the Page Library to the UDI stage.
Remove a wizard page from a UDI stage.
Change the sequence of wizard pages within a UDI stage.
Page Library
The Page Library contains all the pages currently loaded in the UDI Wizard
Designer. When loading a UDI Wizard configuration file, all of the wizard pages
defined in the configuration file are displayed to the Page Library. The Page
Library shows the wizard pages in alphabetical order by page types. Each
instance of a specific page type is listed under the page type.
For example, you may need two different WelcomePage wizard pages for
different stages. The two WelcomePage wizard pages will be listed under the
WelcomePage wizard page type in the Page Library in the UDI Wizard Designer.
In addition, each wizard page instance in the Page Library indicates how many
times the wizard page is used in the stage flows. When you hover over a wizard
page in the Page Library, a thumbnail of the wizard page is displayed along with
the stages that include that page.
Page Name
The page name is used to uniquely identify a wizard page within the Page Library
in the UDI Wizard Designer. The page name is the name a UDI stage references
so that the UDI Wizard knows which wizard page to display within a specific UDI
stage. When you add a page to the Page Library, you must provide the page
name. After the wizard page is added to the Page Library, you cannot change the
page name. In the UDI Wizard Designer, the page name is shown at the bottom
of each wizard page in the Page Library in smaller, non-bold text.
Stage Group
Use a stage group to group one or more stages in the UDI Wizard Designer. UDI
stage groups are loosely related to MDT deployment scenarios, but there is no
one-to-one correlation between the two.
Stage
A stage is a subset of all the pages in the UDI Wizard configuration file that an
MDT deployment scenario uses. When you start the UDI Wizard using the UDI
Wizard task sequence step, the /stage parameter specifies the stage to run,
which in turn specifies the set of pages to use. You can preview how wizard
pages will appear in a stage by clicking Preview in the Preview Wizard group on
the Ribbon. You can use a UDI stage in more than one MDT deployment
scenario, even though the UDI stage is defined only once in the UDI Wizard
Designer. For example, the NewComputer stage can be used in the MDT New
Computer and Replace Computer deployment scenarios.
Task
UDI tasks are software that is run on a wizard page to perform specific functions.
In some instances, these tasks are used to verify that the target computer is
ready for deployment. Other tasks can be used to perform deployment steps,
such as copying configuration or result files.
Note The Next button on the wizard page where the tasks are run will be disabled if any of the
tasks finish with warning or error completion status.
UDI includes several built-in tasks that allow you to perform most of the tasks
necessary for deployment. For more information about the UDI built-in tasks, see
Built-in UDI Tasks.
The Shell Execute built-in UDI task allows you to run any software (scripts) that
can be initiated from a command line, such as Visual Basic or Windows
PowerShell scripts. This functionality allows you create tasks using familiar
scripting languages. For more information, see Shell Execute Task.
If your requirements go beyond scripting, you can write custom UDI tasks. UDI
tasks are DLLs written in C++ and implement the ITask interface. You register
the DLL with the UDI Wizard Designer task library by creating a UDI Wizard
Designer configuration (.config) file and placing it in the
installation_folder\Bin\Config folder (where installation_folder is the folder in
which you installed MDT). For more information on developing custom UDI tasks,
see the section, "Creating Custom UDI Tasks", in the User-Driven Installation
Developers Guide.
For more information about UDI task sequence templates, see the section,
"Identify the UDI Task Sequence Templates in MDT", in the MDT document
Using the Microsoft Deployment Toolkit. For more information about these
components, see the section, "Identify UDI Deployment Process Components",
in the MDT document Using the Microsoft Deployment Toolkit, which is included
with MDT.
UDI Wizard
The UDI Wizard provides the UI for collecting deployment settings that the UDI
task sequences consume. The UDI Wizard is initiated as a part of a UDI task
sequence and collects the necessary configuration information for customizing
the deployment of the Windows client operating systems and applications. The
wizard pages read their configuration settings from the UDI Wizard configuration
file, which is customized using the UDI Wizard Designer.
The UDI Wizard is initiated by the UDI Wizard task sequence step in task
sequences created using the UDI task sequence templates. The UDI Wizard
task sequence step runs the UDIWizard.wsf script, which in turn initiates the UDI
Wizard (OSDSetupWizard.exe). Table 7 lists the UDI Wizard command-line
parameters and provides a brief description of each.
Table 7. UDI Wizard Command-Line Parameters
Parameter Description
/preview Allows you to preview the current configuration of the wizard by
enabling the Next button, which allows you to move from page
to page without requiring valid input.
/xml Specifies the name of the UDI Wizard configuration file. The
UDIWizard.wsf script automatically sets this parameter to the
OSDSetupWizard.xml file, which is stored in the folder in which
the task sequence stores log files. This parameter defaults to
the config.xml file.
The syntax for this parameter is as follows (where <full_path>
is the fully qualified path to the .xml file, including the file name
and extension):
/xml:<full_path>
/stage Specifies the name of the UDI stage to run. The UDIWizard.wsf
script automatically sets this parameter to the appropriate stage,
as described in UDI Stage Reference. This parameter defaults
to the first stage in the UDI Wizard configuration file.
The syntax for this parameter is as follows (where
<stage_name> is the name of the stage to be run):
/stage:<stage_name>
Note The value for <stage_name> is case sensitive.
/locale Specifies the language to use in the UDI Wizard in the form of a
Parameter Description
locale identifier (LCID), which is represented by a numeric
value. For a list of the available LCIDs, see Locale IDs Assigned
by Microsoft.
You would use this list to identify the language you want to use,
and then provide the corresponding LCID.
The syntax for this parameter is as follows (where <locale_id>
is the numeric value of the LCID to be used):
/locale:<locale_id>
Validator
You use UDI validators to help ensure that the correct information is entered into
text fields on wizard pages in the UDI Wizard. UDI includes several built-in
validators that help you perform typical validations of fields used for entering text,
such as preventing users from entering invalid characters and ensuring that the
field is not empty. When a validator detects an invalid entry in a text box, a
message is displayed on the wizard page, and the Next button is disabled until
all invalid entries are resolved.
UDI includes built-in validators that allow you to perform most of the validation
necessary for deployment. For more information about the UDI built-in validators,
see Built-in UDI Validators.
If your requirements go beyond the built-in UDI validators, you can write custom
UDI validators. UDI validators are DLLs written in C++ that implement the
IValidator interface. Register the DLL with the UDI Wizard Designer validator
library by creating a UDI Wizard Designer configuration (.config) file and placing
it in the installation_folder\Bin\Config folder (where installation_folder is the folder
in which you installed MDT). For more information on developing custom UDI
tasks, see the section, "Creating Custom UDI Validators", in the MDT document
User-Driven Installation Developers Guide.
Wizard Page
You use a wizard page to collect configuration information in the UDI Wizard.
Configure UDI wizard pages using the UDI Wizard Designer. The configuration
settings are stored in the UDI Wizard configuration file and are read by the
wizard page when the page is initialized in the UDI Wizard.
Wizard pages are stored in the wizard Page Library, and they can be used in one
or more UDI stages. This design allows you to configure a wizard page that is
shared between stages once for all stages, dramatically reducing the amount of
effort required and the complexity of updating wizard page configuration.
UDI includes built-in wizard pages and wizard page editors that are typically
sufficient for most deployments. For more information about the built-in wizard
pages, see Built-in UDI Wizard Pages.
If your requirements go beyond the built-in UDI wizard pages and corresponding
wizard page editors, you can write custom UDI wizard pages and wizard page
editors. UDI wizard pages are implemented as DLLs that the UDI Wizard reads.
Wizard page editors are created using C++ in Visual Studio.
For more information on developing custom UDI wizard pages, see the section,
"Creating Custom UDI Wizard Pages", in the MDT document User-Driven
Installation Developers Guide.
the UDI Wizard configuration file; UDI includes a built-in wizard page editor for
each built-in wizard page. For more information about the built-in wizard pages
and wizard page editors, see Built-in UDI Wizard Pages.
If your requirements go beyond the built-in UDI wizard pages and corresponding
wizard page editors, you can write custom UDI wizard pages and wizard page
editors. UDI wizard page editors are implemented as DLLs that the UDI Wizard
Designer reads. Create wizard page editors using:
OSDResults Reference
OSDResults is a part of UDI that displays the results of a deployment performed
using UDI. OSDResults displays the Deployment Complete dialog box.
OSDResults is displayed prior to Windows logon the first time the target
computer is started. The user can use OSDResults and the information in the
Deployment Complete dialog box to determine the completion status of the
deployment process and the configuration of the computer prior to logging on for
the first time. In addition, the information in OSDResults can be used for
troubleshooting any problems encountered during the deployment process.
You can configure some of the user interface elements for OSDResults using
the OSDResults.exe.config file, which resides in Tools\OSDResults in the MDT
files Configuration Manager package. Table 8 lists the configuration settings in
the OSDResults.exe.config file.
Table 8. Configuration Settings in the OSDResults.exe.config File
Setting Description
headerImagePath This setting allows you to specify the fully qualified or
relative path to a .bmp file that is displayed in the
header of the OSDResults dialog box.
The default value for this setting is as follows:
images\UDI_Wizard_Banner.bmp
backgroundWallpaper This setting allows you to specify the fully qualified or
relative path to a .jpg file that is displayed as the
wallpaper in the OSDResults dialog box.
The default value for this setting is as follows:
images\Wallpaper.jpg
welcomeText This setting allows you to specify the text that
Setting Description
welcomes the user and provides information about
the deployment process. It is displayed in the
OSDResults dialog box.
completedText This setting allows you to specify the text that
indicates whether the deployment process is
complete. It is displayed in the OSDResults dialog
box.
timeoutMinutes This setting allows you to specify the length of time
the OSDResults dialog box is displayed prior to
automatically displaying the Windows logon screen.
The value for this setting is specified in minutes.
The default value for this setting is zero (0), which
indicates that the OSDResults dialog box will be
displayed indefinitely until manually closed.
The following is the high-level process for how the OSDResults feature works in
UDI:
1. A task sequence runs on the target computer.
The task sequence is based on one of the following UDI task sequence
templates:
UDI task sequence templates, see the section, "Identify the UDI Task
Sequence Templates in MDT", in the MDT document Using the Microsoft
Deployment Toolkit
Relationship between MDT deployment scenarios and UDI stages, see
UDI Stage Reference
2. During the task sequence, the configuration settings provided by task
sequence variables and from user input in the UDI Wizard are saved in the
%DEPLOYROOT%\Tools\OSDResults folder on the target computer (where
%DEPLOYROOT% is the root of the folder in which the MDT files are locally
cached on the target computer).
3. In the OSD Results and Branding group in the task sequence, the following
task sequence steps are run that affect OSDResults:
Cache OSD Results. This task sequence step copies the contents of the
%DEPLOYROOT%\Tools\OSDResults folder to the %WINDIR%\UDI
folder on the target computer. This ensures that the contents of the
OSDResults folder will be persisted after the task sequence finishes.
Run OSD Results. This tasks sequence step configures the target
computer to run OSDResults the first time the computer starts.
4. The target computer starts for the first time, and OSDResults.exe is run prior
to the Windows logon screen.
The Welcome tab in the Deployment Complete dialog box is displayed. The
Welcome tab provides helpful information about the deployment and contact
information in the event that issues with the deployment are discovered.
Review the information on the Deployment Summary and Applications
Installed tabs to verify that the operating system and applications were
installed correctly. When you have completed reviewing these tables, click
Start Windows to log on to Windows 7 for the first time.
Note Configuration Manager 2012 applications are not displayed on the Applications
Installed tab. The Configuration Manager 2012 applications are detected after the user logs
on to the target computer the first time.
5. The Windows logon screen is displayed, and the logon process continues
normally.
AppInstall.exe is run the first time a user logs on to the target computer. For
more information on this process, see User-Centric App Installer Reference.
6. The task sequence is run, and the user selects the Configuration
Manager 2012 applications on the ApplicatonPage wizard page in the UDI
Wizard.
The UDI Wizard is run in the UDI Wizard task sequence step in the
Preinstall group of the task sequence.When the user selects Configuration
Manager 2012 applications on the ApplicatonPage wizard page, the wizard
page creates a separate task sequence variable for each application
selected.
For more information on selecting the Configuration Manager 2012
applications on the ApplicatonPage wizard page in the UDI Wizard, see the
section, "Step 6-4: Start the Target Computer with the Task Sequence
Bootable Media", in the MDT document Quick Start Guide for User-Driven
Installation.
7. The task sequence installs the Configuration Manager 2012 applications that
were selected in the previous step.
The Configuration Manager 2012 applications are installed using the
following task sequence steps in the Install Applications group in the task
sequence:
Setting Description
timeoutMinutes This setting allows you to specify the length of
time for AppInstall to wait for a response from the
Configuration Manager 2012 Application Catalog
before timing out. The value is specified in
minutes. The default value for this setting is 5.
delayTimer This setting allows you to specify the length of
time for AppInstall to wait prior to attempting the
connection to the Configuration Manager 2012
Application Catalog. The value is specified in
minutes. The default value for this setting is 5.
13. AppInstall compares the list of applications discovered in the registry with the
list of applications available from the Configuration Manger 2012 Application
Catalog for the user currently logged on.
If the application discovered in the registry:
The applications used in this step were mapped in the previous step. That is
to say, they were both listed in the registry and found in the Application
Catalog.
15. As a part of the installation process, Configuration Manager 2012 detects
whether the application is already installed.
Because the application has already been installed, Configuration
Manager 2012 records that the application has been successfully deployed to
that user, and the application will be listed in Software Center for that user.
Configuration Manager 2012 begins management and monitoring of the
application for that user.
16. After 1 month, the task created on the target computer in step 8 runs and
removes the %WINDIR%\UDI folder.
The folder is retained for 1 month so that the primary users have an
opportunity to be log on and run AppInstall.exe.
Scenario Description
New Computer MDT for UDI automatically selects this scenario when you:
Create the advertised task sequence using the User-
Driven Installation Task Sequence task sequence
template
Start the task sequence in Windows PE using PXE boot,
Scenario Description
task sequence boot media, or prestaged media for the
NEWCOMPUTER.Prestaged stage
This scenario can be used with traditional deployments or
with prestaged media deployments as supported in
Configuration Manager 2012 or Configuration
Manager 2007 R3. Run the UDI Wizard with the following
UDI stages to support each type of deployment:
NEWCOMPUTER stage. The UDI Wizard is run with this
stage in the User-Driven Installation Task Sequence
task sequence when the operating system image is stored
on distribution points. For more information, see
NEWCOMPUTER Stage.
NEWCOMPUTER.Prestage stage. The UDI Wizard is
run with this stage in the User-Driven Installation Task
Sequence task sequence when the operating system
image is stored on a local disk on the target computer
(prestaged). For more information, see
NEWCOMPUTER.Prestaged Stage.
Refresh MDT for UDI automatically selects this scenario when you:
Computer Create the advertised task sequence using the User-
Driven Installation Task Sequence task sequence
template
Start the task sequence in the existing Windows operating
system on the target computer (not in Windows PE)
The UDI Wizard is run with the REFRESH stage to support
this deployment scenario. For more information, see
REFRESH Stage.
Replace This scenario includes an existing computer and a
Computer replacement computer. A separate task sequence is created
and run on each computer as described in the following
process:
On the existing computer. MDT for UDI automatically
selects this portion of the scenario when you:
Create the advertised task sequence using the User-
Driven Installation Replace Task Sequence task
sequence template
Start the task sequence in the existing Windows
operating system on the target computer (not in
Windows PE)
The UDI Wizard is run with the following UDI stages to
support this deployment scenario:
REPLACE stage. This stage is run in the existing
Windows operating system and captures configuration
Scenario Description
information from within Windows.
REPLACE.WinPE stage. This stage is run in
Windows PE and completes the capturing of
configuration information from the existing computer—
for example, running USMT and capturing the user
state migration data.
The user state is captured to a network shared folder or to
a local USB drive.
For more information on the REPLACE and
REPLACE.WinPE stages, see REPLACE and
REPLACE.WinPE Stages.
On the replacement computer. This portion of the
scenario is identical to the New Computer scenario,
except that the user state captured in the previous step is
restored. MDT for UDI automatically selects this portion of
the scenario when you:
Create the advertised task sequence using the User-
Driven Installation Task Sequence task sequence
template
Start the task sequence in Windows PE using PXE
boot, task sequence boot media, or prestaged media
for the NEWCOMPUTER.Prestaged stage.
This portion of the scenario can be used with traditional
deployments or with prestaged media deployments as
supported in Configuration Manager 2012 or
Configuration Manager 2007 R3. As a part of this portion
of the scenario, the user state migration data is restored.
The UDI Wizard is run with the following UDI stages to
support each type of deployment:
NEWCOMPUTER stage. The UDI Wizard is run with
this stage in the User-Driven Installation Task
Sequence task sequence when the operating system
image is stored on distribution points. For more
information, see NEWCOMPUTER Stage.
NEWCOMPUTER.Prestage stage. The UDI Wizard is
run with this stage in the User-Driven Installation
Task Sequence task sequence when the operating
system image is stored on a local disk on the target
computer (prestaged). For more information, see
NEWCOMPUTER.Prestaged Stage.
NEWCOMPUTER Stage
Figure 1 illustrates the use of the NEWCOMPUTER stage in a task sequence
created using the User-Driven Installation Task Sequence task sequence
template. The primary difference between the task sequences calling the
NEWCOMPUTER stage and the NEWCOMPUTER.Prestaged stage is that the
task sequence calling the NEWCOMPUTER.Prestaged stage does not run the
Apply Operating System Image task sequence step, because the operating
system image is already located on the target computer.
NEWCOMPUTER.Prestaged Stage
Figure 2 illustrates the high-level process flow for the
NEWCOMPUTER.Prestaged stage in a task sequence created using the User-
Driven Installation Task Sequence task sequence template. The primary
difference between the task sequences calling the NEWCOMPUTER stage and
the NEWCOMPUTER.Prestaged stage is that the task sequence calling the
NEWCOMPUTER.Prestaged stage does not run the Apply Operating System
Image task sequence step, because the operating system image is already
located on the target computer.
REFRESH Stage
Figure 3 illustrates the high-level process flow for the REFRESH stage in in a
task sequence created using the User-Driven Installation Task Sequence task
sequence template.
Note The Next button on the wizard page where the tasks are run will be disabled if any of the
tasks finish with warning or error completion status.
Task Description
Bitmap Filename This parameter specifies the graphic used to indicate
the task type.
Display Name This specifies the name of the task, which is displayed
on the wizard page when the task is run.
Exit Code Values This specifies a list of possible return codes for the
task. An item exists in the list for each possible return
code.
Error Code Values This specifies a list of possible unexpected exceptions
that may be encountered (thrown) by the task. An item
exists in the list for each possible exception.
Task Description
AC Power Check This UDI task is used to identify whether the target
computer is connected to AC power, not solely on
battery.
Application Discovery This UDI task is used to discover applications that are
installed on the target computer.
Copy Files Task This UDI task is used to copy files while the UDI
Wizard is running on the target computer.
Shell Execute Task This UDI task is used to run software that can be
initiated from a command line.
Wired Network Check This UDI task is used to identify whether the target
computer is connected to a wired network, not
connected using a wireless network connection.
AC Power Check
Use this UDI task to identify whether the target computer is connected to AC
power. This task uses only those parameters common to all UDI tasks. For more
information about these parameters, see UDI Task Configuration Settings.
Table 13 lists the error and exit codes that the AC Power Check task generates.
Table 13. Error and Exit Codes for the AC Power Check Task
Application Discovery
Use this UDI task to discover applications that are installed on the target
computer.
Table 14 lists the parameters that the Application Discovery task uses.
Table 14. Parameters Used by the Application Discovery Task
Task Description
Task Description
Readcfg This parameter specifies the fully qualified or relative
path to the location of the .app file that has a list of
applications for the task to discover. The .app file
contains the list of available software items from which
the user can select.
The Application Discovery task reads the .app file
and determines whether any of these software items is
installed. If a software item is installed, the item is
added to the file specified in the Writecfg parameter.
Ensure that this parameter uses the same location and
file name as the ApplicationPage wizard page.
Writecfg This parameter specifies the fully qualified or relative
path to the location of the .xml file that contains a list of
the applications discovered by the task.
Log This parameter specifies the fully qualified or relative
path to the location of the log file generated by this
task. The file name of the log file is AppDiscovery.log.
In addition to the parameters in Table 14, this task uses the parameters common
to all UDI tasks. For more information about these common parameters, see UDI
Task Configuration Settings.
Table 15 lists the error and exit codes that the Application Discovery task
generates.
Table 15. Error and Exit Codes for the Application Discovery Task
Task Description
Source This parameter specifies the fully qualified or relative
path to the source file, which can contain wildcards to
copy multiple files using a single task.
Destination This parameter specifies the fully qualified or relative
path to the destination file without a file name.
In addition to the parameters in Table 16, this task uses parameters common to
all UDI tasks. For more information about these parameters, see UDI Task
Configuration Settings.
Table 17 lists the error and exit codes that the Copy Files task generates.
Table 17. Error and Exit Codes for the Copy Files Task
Task Description
Filename This parameter specifies the fully qualified or relative
path to the command for the task to run.
Parameters This parameter specifies the command-line parameters
that are to be provided when running the command.
In addition to the parameters in Table 18, this task uses parameters common to
all UDI tasks. For more information about these parameters, see UDI Task
Configuration Settings.
You can also run custom Visual Basic scripts designed to run in cscript.exe using
the Shell Execute task. To run Visual Basic scripts, perform the following steps:
1. Type the following text in the Filename parameter:
%windir%\system32\cscript.exe
2. Type name of the Visual Basic script file (.vbs file) in the Parameters
parameter, including any command-line parameters for the script.
For example, to run a Visual Basic script named SelfTest.vbs with a
parameter value of Debug, type the following (where script_path is the fully
qualified path to the SelfTest.vbs file):
<script_path>\SelfTest.vbs Debug
Table 19 lists the common error and exit codes that the Shell Execute task
generates.
Note Each specific task based on the Shell Execute task has a unique set of error and exit
codes. Please check the return codes for the software you are running using this task.
Table 19. Common Error and Exit Codes for the Shell Execute Task
Validator Description
InvalidChars This validator identifies any invalid characters that have been
entered from a list that you configure.
NamedPattern This validator helps ensure that the text follows a predefined
pattern.
NonEmpty This validator is used to require text in a field.
RegEx This validator allows you ensure that the text matches a
regular expression that you specify as a part of the validator.
InvalidChars
This validator prevents users from entering specific characters. The Message
box allows you to enter a message that is displayed if the text field contains any
of the invalid characters. The Invalid Characters box allows you to enter the
characters that are considered invalid. The characters are entered without
spaces between them.
NamedPattern
This validator helps ensure that the text follows a predefined pattern. The
Message box allows you to enter a message that is displayed if the text field
does not match the named pattern. The Named Pattern box allows you to enter
the name of the predefined pattern and must be Username, ComputerName, or
Workgroup. The names are case insensitive.
NonEmpty
Use this validator to require text in a field. The Message box allows you to enter
a message that is displayed if the text field is empty.
RegEx
This validator allows you ensure that the text matches a regular expression that
you specify as a part of the validator. The Message box allows you to enter a
message that is displayed if the text field does not match the regular expression.
The Regular Expression box allows you to enter the regular expression used for
the validation. For more information about how to build regular expressions for
this validator, see TR1 Regular Expressions.
In addition to the built-in UDI wizard pages, you can create custom UDI wizard
pages using the UDI SDK. For more information about creating custom UDI
wizard pages using the UDI SDK, see the MDT document User-Driven
Installation Developers Guide.
Each wizard page can reference the following types of variables:
Table 22 lists the memory variables that are set when the UDI Wizard starts, the
description of the variables, and whether the UDI Wizard reads or writes the
variables during startup.
Table 22. Memory Variables Set by the UDI Wizard at Startup and Their
Descriptions
ConfigScanPage Use this wizard page to run UDI tasks that scan the
configuration of the target computer to determine whether
the target computer is ready for the deployment of the
operating system image. This readiness includes having
sufficient system resources and ensuring that any
prerequisite software is installed and configured properly.
ProgressPage Use this wizard page to run UDI tasks that capture the
user state migration data from the target computer.
RebootPage Use this wizard page to notify the user that the target
computer is going to be restarted. You can configure the
notification message using the UDI Wizard Designer.
SummaryPage Use this wizard page to notify the user about the
configuration options that were selected while running the
UDI Wizard. The configuration information displayed on
this wizard page is automatically collected from other
wizard pages. Some fields on other wizard pages allow
you to configure the caption (label) displayed on this
wizard page using the UDI Wizard Designer.
VolumePage Use this wizard page to configure the settings for the disk
volume on target computer where the operating system
will be deployed. These settings include selecting the
target operating system, selecting the target drive,
selecting any Windows installation, and determining
whether the target drive should be formatted as a part of
the deployment process.
AdminAccounts
Use this wizard page to set the password for the local administrator account and
to add other user to the local Administrators group on the target computer.
ApplicationPage
Use this wizard page to configure the list of application software that can be
installed during the setup process. These applications can include applications
from Configuration Manager 2012 or packages and programs from Configuration
Manager 2012 or Configuration Manager 2007 R3.
Memory Variables
Table 26 lists the ApplicationPage memory variables with the description and
whether the variable is read or written by the wizard page.
Table 26. ApplicationPage Memory Variables
BitLockerPage
This wizard page is used to configure BitLocker settings for the target computer.
Configuration Variables
Table 28 lists the BitLockerPage configuration variables with a description and
whether the variable is read by the wizard page, written by the wizard page, or
can be configured in the UDI Wizard configuration file.
Table 28. BitLockerPage Configuration Variables
ComputerPage
Use this wizard page to configure the computer name of the target computer, the
domain or workgroup to join, and the credentials to be used when joining a
domain. When you configure this page to join the target computer to a domain,
this wizard page will validate the credentials you provide for joining the domain in
AD DS by default. Then, this wizard page attempts to modify a computer object
in AD DS to verify that the user credentials provided on this page have
permissions to create or modify the computer object. You can disable either of
these behaviors. If you disable the validation of the credentials, then the
verification of permissions for creating or modifying computer objects is also
disabled. Both of these validations occur when the Next button is clicked. If either
of the validations encounters an error, an error message will be displayed and
this page will continue to be displayed.
The following is the order of precedence for determining the default computer
name:
1. If the UserExistingComputerName value in the UDI Wizard configuration
file is set to TRUE, then the existing computer name is used (if present).
2. If the OSDComputerName task sequence variable is set, then the computer
name in that variable is used.
3. If a default value is specified for the computer name in the UDI Wizard
configuration file, then that value is used.
Configuration Variables
Table 30 lists the ComputerPage configuration variables with a description and
whether the variable is read by the wizard page, written by the wizard page, or
can be configured in the UDI Wizard configuration file.
Table 30. ComputerPage Configuration Variables
ConfigScanPage
Use this wizard page to run UDI tasks that scan the configuration of the target
computer to determine whether the target computer is ready for the deployment
of the operating system image. This readiness includes having sufficient system
resources and any prerequisite software being installed and configured properly.
In addition, other UDI tasks are run that collect configuration information about
the target computer, such as identifying:
LanguagePage
Use this wizard page to determine which language packs should be installed, the
default language for the target operating system, the keyboard locale, and the
time zone in which the computer will be located.
ProgressPage
Use this wizard page to run UDI tasks that capture the user state migration data
from the target computer. These tasks include:
RebootPage
Use this wizard page to notify the user that the target computer is going to be
restarted. You can configure the notification message using the UDI Wizard
Designer.
SummaryPage
Use this wizard page to notify the user about the configuration options that were
selected while running the UDI Wizard. The configuration information displayed
on this wizard page is automatically collected from other wizard pages. Some
fields on other wizard pages allow you to configure the caption (label) displayed
on this wizard page using the UDI Wizard Designer.
UDAPage
Use this wizard page to configure the UDA between the target computer and a
specified user. Assigning a user as the primary user of a computer allows
automatic installation of software that is deployed to that user. The UDA feature
is only available in Configuration Manager 2012 and only in the New Computer
deployment scenario.
UserStatePage
Use this wizard page to configure the settings for capturing or restoring user
state migration data. This wizard page is used for both user state migration data
capture and restore.
The UserStatePage can capture or restore user state migration data from a disk
locally attached to the target computer, a USB drive attached to the target
computer, or a network shared folder. In addition, you can select to not restore
any user data. The code logic behind the wizard page enables, disables, or
automatically selects each of the following options based on the deployment
scenario and whether the disk is being formatted:
Network. This option indicates that the user state migration data should be
stored on a network shared folder and sets the OSDUserStateMode task
sequence variable and UserStateMode variable to Network.
Format the disk on the target computer, then the UserStatePage assumes
that no user state migration data is located on the local hard disk, so the
Local option is disabled and all other options are enabled
Not format the disk on the target computer, then the UserStatePage
assumes that there is user state migration data to be restored, and all options
are disabled other than the Local option (Using the Local option provides a
faster method for restoring the user state migration data than the USB or
network shared folder methods.)
Table 33 lists the behavior of the options on the wizard page for the
NEWCOMPUTER stage. The Format column indicates whether the target hard
disk is to be formatted as a part of the deployment. The other columns indicate
the configuration of the options when the UserStatePage is loaded.
Table 33. Behavior of Options for the NEWCOMPUTER Stage
Format the disk on the target computer, then the UserStatePage assumes
that no user state migration data is to be restored, and all options are
disabled other than the NoData option
Not format the disk on the target computer, then the UserStatePage
assumes that there is user state migration data to be restored, and all options
are disabled other than the Local option (Using the Local option provides a
faster method for restoring the user state migration data than the USB or
network shared folder methods.)
Table 35 lists the behavior of the options on the wizard page for the REFRESH
stage. The Format column indicates whether the target hard disk is to be
formatted as a part of the deployment. The other columns indicate the
configuration of the options when the UserStatePage is loaded.
Table 35. Behavior of Options for the REFRESH Stage
Memory Variables
Table 38 lists the UserStatePage memory variables with a description and
whether the variable is read or written by the wizard page.
Table 38. UserStatePage Memory Variables
Configuration Variables
Table 39 lists the UserStatePage configuration variables with a description and
whether the variable is read by the wizard page, written by the wizard page, or
can be configured in the UDI Wizard configuration file.
Table 39. UserStatePage Configuration Variables
VolumePage
Use this wizard page to configure the settings for the disk volume on the target
computer on which the operating system will be deployed. These settings include
selecting the target operating system, selecting the target drive, selecting any
Windows installation, and determining whether the target drive should be
formatted as a part of the deployment process.
Memory Variables
Table 41 lists the VolumePage memory variables with a description and whether
the variable is read or written by the wizard page.
Table 41. VolumePage Memory Variables
WelcomePage
Use this wizard page to provide information to the user about the UDI Wizard and
the deployment process. You can configure the notification message using the
UDI Wizard Designer.