Copyright: Wednesday, January 22, 2003 17:52:06


Winnt32

Performs an installation of or upgrade to a product in the Windows  Server 2003 family. You can run winnt32 at the command prompt on a computer running Windows 95, Windows 98, Windows Millennium Edition, Windows NT, Windows 2000, Windows XP, or a product in the Windows  Server 2003 family. If you run winnt32 on a computer running Windows NT version 4.0, you must first apply Service Pack 5 or later.

Notes

If you are deploying Windows XP on client computers, you can use the version of Winnt32.exe that comes with Windows XP. Another way to deploy Windows XP is to use Winnt32.msi, which works through Windows Installer, part of the IntelliMirror set of technologies. For more information about client deployments, see the Windows  Server 2003 Deployment Kit.

On an Itanium architecture-based computer, winnt32 can be run from the Extensible Firmware Interface (EFI) or from Windows XP 64-Bit Edition, the 64-bit version of Windows  Server 2003, Enterprise Edition, or the 64-bit version of Windows  Server 2003, Datacenter Edition. Also, on an Itanium architecture-based computer, /cmdcons and /syspart are not available, and options relating to upgrades are also not available.

Syntax

winnt32 [/checkupgradeonly] [/cmd:command_line] [/cmdcons] [/copydir:{i386|ia64}\folder_name] [/copysource:folder_name] [/debug[level]:[filename]] [/dudisable] [/duprepare:pathname] [/dushare:pathname] [/emsport:{com1|com2|usebiossettings|off}] [/emsbaudrate:baudrate] [/m:folder_name] [/makelocalsource] [/noreboot] [/s:sourcepath] [/syspart:drive_letter] [/tempdrive:drive_letter] [/udf:id [,UDB_file]] [/unattend[num]:[answer_file]]

Parameters

/checkupgradeonly

Checks your computer for upgrade compatibility with products in the Windows  Server 2003 family.

If you use this option with /unattend, no user input is required. Otherwise, the results are displayed on the screen, and you can save them under the file name you specify. The default file name is Upgrade.txt in the systemroot folder.

/cmd:command_line

Instructs Setup to carry out a specific command before the final phase of Setup. This would occur after your computer has restarted and after Setup has collected the necessary configuration information, but before Setup is complete.

/cmdcons

On an x86-based computer, installs the Recovery Console as a startup option. The Recovery Console is a command-line interface from which you can perform tasks such as starting and stopping services and accessing the local drive (including drives formatted with NTFS). You can only use the /cmdcons option after normal Setup is finished.

/copydir:{i386|ia64}\folder_name

Creates an additional folder within the folder in which the operating system files are installed.

Folder_name refers to a folder that you have created to hold modifications just for your site. For example, for x86-based computers, you could create a folder called Private_drivers within the i386 source folder for your installation, and place driver files in the folder. Then you could type /copydir:i386\Private_drivers to have Setup copy that folder to your newly installed computer, making the new folder location systemroot\Private_drivers. You can use /copydir to create as many additional folders as you want.

/copysource:folder_name

Creates a temporary additional folder within the folder in which the operating system files are installed.

Folder_name refers to a folder that you have created to hold modifications just for your site. For example, you could create a folder called Private_drivers within the source folder for your installation, and place driver files in the folder. Then you could type /copysource:Private_drivers to have Setup copy that folder to your newly installed computer and use its files during Setup, making the temporary folder location systemroot\Private_drivers. You can use /copysource to create as many additional folders as you want. Unlike the folders /copydir creates, /copysource folders are deleted after Setup completes.

/debug[level]:[filename]

Creates a debug log at the level specified, for example, /debug4:Debug.log. The default log file is C:\systemroot\Winnt32.log, and the default debug level is 2. The log levels are as follows: 0 represents severe errors, 1 represents errors, 2 represents warnings, 3 represents information, and 4 represents detailed information for debugging. Each level includes the levels below it.

/dudisable

Prevents Dynamic Update from running. Without Dynamic Update, Setup runs only with the original Setup files. This option will disable Dynamic Update even if you use an answer file and specify Dynamic Update options in that file.

/duprepare:pathname

Carries out preparations on a shared installation folder so that it can be used with Dynamic Update files that you downloaded from the Windows Update Web site. This shared folder can then be used for installing Windows XP for multiple clients.

/dushare:pathname

Specifies a shared folder on which you previously downloaded Dynamic Update files (updated files for use with Setup) from the Windows Update Web site, and on which you previously ran /duprepare:pathname. When run on a client, specifies that the client installation will make use of the updated files on the shared folder specified in pathname.

For more detailed information about using Dynamic Update and installing multiple clients, see the Windows  Server 2003 Deployment Kit.

/emsport:{com1|com2|usebiossettings|off}

Enables or disables Emergency Management Services during Setup and after the server operating system has been installed. With Emergency Management Services, you can remotely manage a server in emergency situations that would typically require a local keyboard, mouse, and monitor, such as when the network is unavailable or the server is not functioning properly. Emergency Management Services has specific hardware requirements, and is available for products only in the Windows  Server 2003 family.

Usebiossettings is the default, and uses the setting specified in the BIOS Serial Port Console Redirection (SPCR) table, or, in Itanium architecture-based systems, through the Extensible Firmware Interface (EFI) console device path. If you specify usebiossettings and there is no SPCR table or appropriate EFI console device path, Emergency Management Services will not be enabled.

Com1 and com2 are applicable only for x86-based computers (not Itanium architecture-based computers).

If you disable Emergency Management Services by specifying /emsport:off, you can later enable it by modifying the boot settings. For information about modifying boot settings, see the Resource Kits for the Windows  Server 2003 family.

/emsbaudrate:baudrate

For x86-based computers, specifies the baud rate for Emergency Management Services. (The option is not applicable for Itanium architecture-based computers.) Must be used with /emsport:com1 or /emsport:com2 (otherwise, /emsbaudrate is ignored).

Baudrate can be 9600, 19200, 57600, or 115200. 9600 is the default.

/m:folder_name

Specifies that Setup copies replacement files from an alternate location. Instructs Setup to look in the alternate location first, and if files are present, to use them instead of the files from the default location.

/makelocalsource

Instructs Setup to copy all installation source files to your local hard disk. Use /makelocalsource when installing from a CD to provide installation files when the CD is not available later in the installation.

/noreboot

Instructs Setup to not restart the computer after the file copy phase of Setup is completed so that you can run another command.

/s:sourcepath

Specifies the source location of the files for your installation. To simultaneously copy files from multiple servers, type the /s:sourcepath option multiple times (up to a maximum of eight). If you type the option multiple times, the first server specified must be available, or Setup will fail.

/syspart:drive_letter

On an x86-based computer, specifies that you can copy Setup startup files to a hard disk, mark the disk as active, and then install the disk into another computer. When you start that computer, it automatically starts with the next phase of Setup. You must always use the /tempdrive parameter with the /syspart parameter.

You can start Winnt32 with the /syspart option on an x86-based computer running Windows NT 4.0, Windows 2000, Windows XP, or a product in the Windows  Server 2003 family. If the computer is running Windows NT version 4.0, it requires Service Pack 5 or later. The computer cannot be running Windows 95, Windows 98, or Windows Millennium Edition.

/tempdrive:drive_letter

Directs Setup to place temporary files on the specified partition. For a new installation, the server operating system will also be installed on the specified partition. For an upgrade, the /tempdrive option affects the placement of temporary files only; the operating system will be upgraded in the partition from which you run winnt32.

/udf:id [,UDB_file]

Indicates an identifier (id) that Setup uses to specify how a Uniqueness Database (UDB) file modifies an answer file (see the /unattend entry).

The UDB overrides values in the answer file, and the identifier determines which values in the UDB file are used. For example, /udf:RAS_user,Our_company.udb overrides settings specified for the RAS_user identifier in the Our_company.udb file. If no UDB_file is specified, Setup prompts the user to insert a disk that contains the $Unique$.udb file.

/unattend

On an x86-based computer, upgrades your previous version of  Windows NT 4.0 Server (with Service Pack 5 or later) or Windows 2000 in unattended Setup mode. All user settings are taken from the previous installation, so no user intervention is required during Setup.

/unattend[num]:[answer_file]

Performs a fresh installation in unattended Setup mode. The specified answer_file provides Setup with your custom specifications.

Num is the number of seconds between the time that Setup finishes copying the files and when it restarts your computer. You can use num on any computer running Windows 98, Windows Millennium Edition, Windows NT, Windows 2000, Windows XP, or a product in the Windows  Server 2003 family. If the computer is running Windows NT version 4.0, it requires Service Pack 5 or later.

Using the /unattend command-line option to automate Setup affirms that you have read and accepted the Microsoft License Agreement for a product in the Windows  Server 2003 family. Before using this command-line option to install a product in the Windows  Server 2003 family on behalf of an organization other than your own, you must confirm that the end user (whether an individual, or a single entity) has received, read, and accepted the terms of the Microsoft License Agreement for that product. OEMs may not specify this key on machines being sold to end users.