Article ID: 275529 - View products that this article applies to.
This article was previously published under Q275529
WARNING: This utility is used for creating or moving individual Microsoft Windows NT 4.0 or Microsoft Windows 2000 print servers. Do not use it to upgrade a Windows NT 4.0 print server to a Windows 2000 print server.
Microsoft Printer Migrator 2000 (Printmig.exe version 2.0) is included with the Microsoft Windows 2000 Resource Kit Supplement version 1.0. However, the Help file that is included with this supplement is for use with Printmig.exe version 1.0. This article provides Help information for Printmig.exe version 2.0.
OverviewPrinter Migrator 2000 (Printmig.exe) performs a complete printer configuration backup of a Windows NT 4.0-based or Windows 2000-based computer. This backup data is stored in a user-specified .cab file. If Printmig.exe is enabled (by default, it is enabled), Printmig.exe also writes status information to the Pm.log file in the %SystemRoot%\System32\Spool\Pm folder. The following data is backed up to the .cab file:
Features That Are Included in Printmig.exe Version 2.0 But Not Version 1.0
Merge ConfigurationsIn Restore mode, Printer Migrator version 1.0 performed a printer configuration registry overwrite of the target computer. Because of this, any existing printer configuration would be lost after the Printer Migrator restoration process finishes. The majority of development efforts for Printmig.exe version 2.0 have been dedicated to the registry-merging code upon a restoration. By merging registry information, printer configurations can be merged (this is the default behavior) or overwritten. To overwrite printer configurations, use the /o switch (in combination with the /r switch) or click to select the Replace (overwrite) existing print shares check box in the Restore dialog box.
Full Operation from a Command PromptBecause you can start Microsoft Printer Migrator version 2000 from a command prompt, you can use it with a script. Several switches have been added to Printer Migrator 2000 version 2.0 that are not included in version 1.0, and you can view these switches by using the /? switch. Note that if you start Printmig.exe from a command prompt, the user interface also starts, but it automatically shuts down when the operation is complete. The following list provides a description of the different switches you can use with Printmig.exe:
Terminal Services AwarePrintmig.exe 1.0 was not Terminal Services aware for restorations. Instead, version 1.0 would target the %SystemRoot% folder on a per-user basis, even though it needed to use a system-wide basis. This has been corrected with Printmig.exe 2.0, and is transparent when you restore to a computer that is running Terminal Services.
SchedulingPrintmig.exe has been fully tested with the Mstask.exe tool, and all known scheduling bugs have been fixed. For example, no one needs to be logged in for the program to operate successfully operate.
Multi-Threaded Graphical User InterfacePrintmig.exe 2.0 is multithreaded, so the tool should not stop responding (hang) during a long operation. Do not attempt to run simultaneous backups or restorations with a single instance of Printmig.exe 2.0. Instead, you must run separate instances of Printmig.exe 2.0 to perform simultaneous backups or restorations from a single computer.
BackupWhen you use Printmig.exe 2.0 to back up the printer configuration of a Windows NT-based or Windows 2000-based computer, you must specify the .cab file location and name that Printmig.exe will create. Optionally, you can specify the target server.
To create a backup from a command prompt, use the -b switch and the -f [file name] switch. Optionally, you can specify the target computer name as the last parameter of the command in the \\server name form. To create a backup from with the program:
RestoreWhen you use Printmig.exe 2.0 to restore a printer configuration to a Windows NT 4.0-based or Windows 2000-based computer, the default behavior is to merge the configuration from the .cab file to the existing configuration on the target computer. Note that this behavior differs from Printmig.exe 1.0 which overwrites the existing configuration on the target with the configuration from the .cab file. To overwrite with Printmig.exe 2.0, use the -o switch or click to select the Replace (overwrite) existing print shares check box in the Restore dialog box.
To restore from a command prompt, use the -r and the -f [filename] switches. Optionally, you can specify the target computer name as the last parameter of the command in the \\server name form.
To restore from within the program:
Note that Printmig.exe 2.0 is backwards compatible with .cab files that were created by Printmig.exe 1.0, but not the other way around.
Log FileThe log file records detailed information about backups, restorations, and errors that were encountered. The Pm.log log file is stored in the %SystemRoot%\System32\Spool\Pm folder. Warnings and errors are still logged even if these items are disabled. Log To Text is enabled by default on the Options menu. Click this command to disable logging to a text file. However, note that all of this information is still displayed in the lower portion of the Printer Migrator logging window.
ViewThe Target and Restore Local commands enumerate print queue information in a tree view format. The title bar identifies the computer that corresponds to the currently displayed tree view. Note that this computer is the target of all subsequent operations.
To enumerate a remote computer and populate the tree view: