Appendix A - Printbrm.exe Command-Line Tool Details
Applies To: Windows Server 2012
Printbrm.exe command-line tool syntax
The following table lists the available printbrm parameters:
Syntax |
Description |
---|---|
-s <server name> |
Specifies the destination server. |
-b |
Backs up the server to the specified file. |
-r |
Restores the configuration in the file to the server. |
-q |
Queries the server or the backup file. |
-f <file name> |
Specifies the backup file. |
-d <directory name> |
Unpacks the backup file to the directory (with -r), or repacks a backup file from the directory (with -b). |
-o force |
Forces overwriting of existing objects. |
-p all:org |
Publishes all printers in the directory, or publishes printers that were published originally. |
-nobin |
Omits binary files from the backup. |
-lpr2tcp |
Converts LPR ports to standard TCP/IP ports on restore. |
-c <file name> |
Uses the specified configuration file. |
-noacl |
Removes ACLs from print queues on restore. |
-? |
Displays Help. |
Printbrm enhancements
Printbrm.exe in Windows Server 2012 has several enhancements and improvements, including the following:
Supports both v3 and v4 print drivers
Windows Server 2012 supports both driver types, so with Printbrm you have full flexibility to back up, restore and configure the drivers you need to support your environment.
Supports backup CAB files greater than 2 GB
You should use the latest PrintBRM version when performing a migration or restoration. You will avoid CAB file size issues if you use the latest version of Printbrm to migrate and restore your Windows Server 2008 R2 (or previous) servers.
General improvements for reporting and error handling conditions during the backup and restore processes
These conditions are primarily logged in the Event Log under Custom Views\Printer Migration Events.
Printbrm usage scenarios
There are many ways Printprm can be used to make migrating your printers easier and more flexible.
Using the configuration file
You can use a configuration file to customize your printbrm migration for the following purposes:
Replace printer drivers during a restore operation.
For example, you might want to import your printers to a new print server, but use new v4 printer drivers.
Backup / Restore dependent files from third-party Language Monitors
Backup / Restore dependent files from third-party party Print Processors
For example, to replace your printer drivers, you can backup your printers using the –nobin parameter, and then restore the printers using the –c <file name> parameter to specify a configuration file with a DriverMap section.
To use a configuration file to specify updated print drivers
Backup you printers using the –nobin parameter. For example:
Printbrm.exe –b –nobin –s \\myoldprintserver –f printers.printerExport
On the new print server computer, manually install the updated printer drivers.
Create a BrmConfig.xml configuration file to map the old drivers to the new drivers. For example:
<BrmConfig> <PLUGINS> </PLUGINS> <LanguageMonitors> </LanguageMonitors> <DriverMap> <DRV old=”OldDriverName1” new=”NewDriverName1”/> <DRV old=”OldDrverName2” new=”NewDriverName2”/> </DriverMap> </BrmConfig>
Restore the printers specifying your configuration file using your configuration file. For example: PrintBrm.exe –r –c BrmConfig.xml –f printers.printerExport –o force
Check your installed printers to verify they are installed with the updated printer drivers.
Important
Remember that if you are running printbrm over the network to remote servers, the Print$ share must exist on both the source and target servers and the Remote Registry Service must be running.
Selectively restoring your printers
After you export the printers from your source server, you can selectively restore the printers and their related objects using the –d parameter. You can follow a general procedure to accomplish this:
To selectively restore your printers
Export the printer objects from the source server.
Restore to a temporary folder using the –d parameter.
Manually edit the files in the temporary folder.
Note
More information about the files created by a printbrm backup is described later.
Backup the temporary folder using the –d parameter.
Import the modified backup file to the target server.
A backup or export operation using PrintBRM produces a compressed file that is used for the restore or import operation. The following XML files are part of the export file in addition to the individual printer driver and configuration files:
BrmDrivers – contains a list of every driver installed on the computer and the driver files for each driver
BrmForms – contains a list of all the installed forms
BrmLMons – will usually contain either Windows NT x86 or Windows x64 as the architecture and a list of port monitors and the port monitor files installed
BrmPorts – contains a list of all the installed printer ports
BrmPrinters – contains a list of all printers that have been installed
BrmSpoolerAttrib – contains information about the spooler directory path and also indicates whether or not the source server was a cluster server
Moving printers to a different domain
If you move printers to a different domain, you will want to prevent the restoration of the print queue’s ACLs. Use the –NoACL parameter to do this. If you use this parameter, the restored print queues will inherit the permissions of the target print server.
See Also
Migrate Print and Document Services to Windows Server 2012
Preparing to Migrate
Migrating the Print and Document Services Role
Verifying the Migration
Post-Migration Tasks1
Appendix B - Additional Destination Server Scenarios
Appendix C - Printbrm Event IDs