{"id":126,"date":"2011-09-17T17:11:15","date_gmt":"2011-09-17T17:11:15","guid":{"rendered":"http:\/\/www.itcrumbs.com\/?p=126"},"modified":"2019-02-07T04:40:24","modified_gmt":"2019-02-07T04:40:24","slug":"print-queue-scripting","status":"publish","type":"post","link":"http:\/\/www.itcrumbs.com\/?p=126","title":{"rendered":"Print Queue Scripting"},"content":{"rendered":"

http:\/\/blogs.technet.com\/b\/askperf\/archive\/2011\/09\/16\/print-queue-scripting.aspx<\/a><\/p>\n

Many methods of programmatically working with printers exist and I\u2019ll be going over the main ones we use on the Windows platform support teams in this blog. These can be real lifesavers for print server administrators if changes need to be made across many queues.<\/p>\n

As a quick caveat, please keep in mind that we use many of these scripts and utilities for troubleshooting during the course of support incidents but not all of them are supported. I\u2019ll explicitly call out which tools are eligible for Microsoft support services and which ones are not while we walk through them.<\/p>\n

In-Box Print Admin Scripts<\/u><\/b><\/p>\n

<\/u><\/b><\/p>\n

Supportability<\/u><\/b><\/p>\n

The print management visual basic scripts provided with the OS are fully supported. <\/p>\n

\"clip_image003\"<\/a><\/b> Important Notes<\/b><\/p>\n

\u00fc These scripts are WMI-based and thus are only for use against a stand-alone print server.<\/p>\n

\u00fc The first versions of these scripts were included with the Windows Server 2003 Resource Kit.<\/p>\n

\u00fc The Resource Kit versions of these scripts are NOT supported but work against a cluster.<\/p>\n

Script List<\/u><\/b><\/p>\n

Location:<\/p>\n

\u00b7 Windows XP \/ Server 2003<\/b> – %windir%\\system32<\/p>\n

\u00b7 Windows Vista \/ 7 \/ 2008 \/ 2008R2<\/b> – %windir%\\system32\\printing_admin_scripts<\/p>\n

Scripts:<\/p>\n

\u00b7 PRNCNFG.VBS<\/b><\/a><\/b><\/p>\n

Configures or displays configuration information about a printer.<\/p>\n

\u00b7 PRNDRVR.VBS<\/b><\/a><\/b><\/p>\n

Adds, deletes, and lists printer drivers.<\/p>\n

\u00b7 PRNJOBS.VBS<\/b><\/a><\/b><\/p>\n

Pauses, resumes, cancels and lists print jobs.<\/p>\n

\u00b7 PRNMNGR.VBS<\/b><\/a><\/b><\/p>\n

Adds, deletes, and lists printers or printer connections, in addition to setting and displaying the default printer. <\/b><\/p>\n

\u00b7 PRNPORT.VBS<\/b><\/a><\/b><\/p>\n

Creates, deletes, and lists standard TCP\/IP printer ports, in addition to displaying and changing port configuration.<\/b><\/p>\n

\u00b7 PRNQCTL.VBS<\/b><\/a><\/b><\/p>\n

Prints a test page, pauses or resumes a printer, and clears a printer queue.<\/b><\/p>\n

\u00b7 PUBPRN.VBS<\/b><\/a><\/b><\/p>\n

Publishes a print queue to active directory.<\/p>\n

Built-in Self Help<\/u><\/b><\/p>\n

All of the in-box scripts display syntax information and examples if you run them without parameters.<\/p>\n

CSCRIPT.EXE <ScriptName.vbs><\/b><\/b><\/p>\n

Commonly used commands:<\/u><\/b><\/p>\n


<\/u>Add HP Universal Printer Driver (UPD) 5.3 PCL 6 driver<\/p>\n

\n

cscript prndrvr.vbs -a -m "HP Universal Printing PCL 6 (v5.3)" -v 3 -i "C:\\TEMP\\hpcu115u.inf" -h "C:\\TEMP"<\/p>\n<\/blockquote>\n

Add HP UPD 5.3 Postscript (PS) driver<\/p>\n

\n

cscript prndrvr.vbs -a -m "HP Universal Printing PS (v5.3)" -v 3 -i "C:\\TEMP\\hpcu115v.inf" -h "C:\\TEMP"<\/p>\n<\/blockquote>\n

Add Xerox GPD 2.1 PS driver<\/p>\n

\n

cscript prndrvr.vbs -a -m "Xerox GPD PS V2.1" -v 3 -i "C:\\TEMP\\x2UNIVP.inf" -h "C:\\TEMP"<\/p>\n<\/blockquote>\n

Delete all printer drivers that are not in use <\/p>\n

\n

cscript prndrvr.vbs -x<\/p>\n<\/blockquote>\n

Set a print queue to RAW only (disable Advanced Printing Features)<\/p>\n

\n

cscript prncnfg.vbs -t -p printer +rawonly<\/p>\n<\/blockquote>\n

<\/u><\/p>\n

Set a print queue to print directly to the printer<\/p>\n

\n

cscript prncnfg.vbs -t -p printer +direct<\/p>\n<\/blockquote>\n

Create a Standard TCP\/IP port with SNMP status disabled <\/p>\n

\n

cscript prnport.vbs -a -md -r IP_127.0.0.1 -h 127.0.0.1 -o raw -n 9100<\/p>\n<\/blockquote>\n

Print a test page to a queue<\/p>\n

\n

cscript prnqctl.vbs -p "HP Color LaserJet" -e<\/p>\n<\/blockquote>\n

Cancel all print jobs in a queue<\/p>\n

\n

cscript prnqctl.vbs -p "HP Color LaserJet" -x<\/p>\n<\/blockquote>\n

More Information:<\/u><\/b><\/p>\n

The unsupported<\/i> 2003 Resource Kit versions of these scripts can be run against a 32 or 64-bit cluster.
2466246<\/a> – Printer VBScript error: 0x1A8. Object required
http:\/\/support.microsoft.com\/kb\/2466246<\/a><\/p>\n

PrintUI.dll<\/u><\/b><\/p>\n

<\/u><\/b><\/p>\n

Supportability<\/u><\/b><\/p>\n

One-line PrintUI.dll commands are fully supported by Microsoft support services, but the in-box print admin scripts are always the preferred method of getting the same tasks done.<\/p>\n

PrintUI.dll Help<\/u><\/b><\/p>\n

PrintUI.dll contains a wealth of information and examples if you run the following command.<\/p>\n

RUNDLL32 PRINTUI.DLL,PrintUIEntry \/? <\/p>\n

\"clip_image003[1]\"<\/a><\/b> Important Notes<\/b><\/p>\n

\u00fc Use the \/u switch when connecting to queues or drivers may be downloaded repeatedly.<\/p>\n

\u00fc Adding a local port (standard tcp\/ip or otherwise) is NOT supported by this tool.<\/p>\n

\u00fc An undocumented \/x switch is required to map an IPP printer. (Content ID 314486<\/a>)<\/p>\n

\u00fc PrintUI.dll is updated somewhat frequently, so make sure you\u2019re using the latest<\/a> version.<\/p>\n

Commonly used commands:<\/u><\/b><\/p>\n

<\/u><\/p>\n

Connect to a print queue:<\/u><\/p>\n

rundll32 printui.dll,PrintUIEntry \/u \/in \/n \\\\machine\\printer<\/a><\/p>\n

<\/u><\/p>\n

Add OEM printer driver using inf:<\/u><\/p>\n

rundll32 printui.dll,PrintUIEntry \/ia \/m "Xerox WorkCentre 7775 PS" \/h "x64" \/v 3 \/f C:\\Xerox\\x2DLEXP.inf<\/p>\n

Add in-box printer driver:<\/u><\/p>\n

rundll32 printui.dll,PrintUIEntry \/ia \/m "Brother DCP-116C" \/h "x64" \/v 3<\/p>\n

Troubleshooting:<\/u><\/b><\/p>\n

The vast majority of PrintUI.dll problems are related to incorrect or incomplete syntax.<\/p>\n

\u00fc Use example syntax as a template.<\/p>\n

\u00fc PrintUI.dll switches are case sensitive.<\/p>\n

\u00fc Driver names must be exactly as you see them in the GUI. (when installed manually)<\/p>\n

\u00fc Drivers require specification of the correct processor architecture using the \/h switch. Use a simple \u201cx86\u201d or \u201cx64\u201d parameter to indicate your preference.<\/p>\n

\u00fc Drivers also require a version to be specified with the \/v switch. You will always use 3 as the parameter for this switch. (There are no supported v2 kernel mode drivers today.)<\/p>\n

More Information:<\/u><\/b><\/p>\n

Deploying Printers and Print Drivers Remotely<\/a><\/p>\n

SetPrinter (SetPrinter API wrapper)<\/u><\/b><\/p>\n

<\/u><\/b><\/p>\n

SetPrinter Support Guidelines<\/u><\/b><\/p>\n

SetPrinter.exe is distributed with the Windows Server 2003 Resource Kit and is subject to the Resource Kit Support Policy.<\/p>\n

Resource Kit Support Policy<\/p>\n

The SOFTWARE supplied in the Windows Resource Kit Tools is not supported under any Microsoft standard support program or service. Customers can, however, report issues and bugs by sending e-mail to rkinput@microsoft.com. Microsoft will, at its sole discretion, address issues and bugs reported in this manner, and responses are not guaranteed. This e-mail address is only for issues related to the Windows Resource Kit Tools and the Windows Deployment and Resource Kits.<\/p>\n

The SOFTWARE (including instructions for its use and all printed and online documentation) is provided "AS IS" without warranty of any kind. Microsoft further disclaims all implied warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or performance of the SOFTWARE and documentation remains with you.<\/p>\n

In no event shall Microsoft, its authors, or anyone else involved in the creation, production, or delivery of the SOFTWARE be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the SOFTWARE or documentation, even if Microsoft has been advised of the possibility of such damages.<\/p>\n

Although no support services are available for this tool, it generally works with all OS\u2019s, both clustered and stand-alone, from Windows XP to Windows Server 2008 R2.<\/p>\n

A few sample commands are provided later in this document, but consumers of this tool will generally need to use the embedded help to customize the command line for a desired result. <\/p>\n

\"clip_image003[2]\"<\/a><\/b>Note <\/b><\/p>\n

\u00fc A custom script (e.g. VBScript, PowerShell, etc.) is a good alternative if SetPrinter will not accomplish a specific goal or functions in an unexpected manner.<\/p>\n

<\/u><\/b><\/p>\n

SetPrinter Help<\/u><\/b><\/p>\n

Running SetPrinter.exe without any arguments will display the embedded help.<\/p>\n

Syntax: SetPrinter [-<mode>] <\\\\server|printer> <level> [<data> …] [<cmd>]<\/p>\n

or SetPrinter -help <level><\/p>\n

or SetPrinter -examples <level><\/p>\n

or SetPrinter -show [-<mode>] <\\\\server|printer> <level><\/p>\n

where:<\/p>\n

\\\\server : (or \\\\server\\*) change all local printers on this server<\/p>\n

(use "" or "*" for all printers on local machine)<\/p>\n

\\\\server\\\\: change server (not printer) settings<\/p>\n

printer : change this printer (printer or \\\\server\\printer)<\/p>\n

level : PRINTER_INFO level (0 – 9).<\/p>\n

data : (optional) Level specific data in ‘keyword=value keyword=value’<\/p>\n

format. Data is unchanged for keywords not specified.<\/p>\n

cmd : (optional, but must be last if present) one of:<\/p>\n

"pause", "resume", "purge", "setstatus"<\/p>\n

-help : show format of data for <level><\/p>\n

-examples : show usage examples for <level><\/p>\n

-show : show current settings (no changes applied – all <data> ignored)<\/p>\n

-<mode> : (optional) Only valid on Windows Vista and later.<\/p>\n

Possible values: -cached, or -notcached<\/p>\n

(See documentation for OpenPrinter2 API, pOptions parameter)<\/p>\n

<\/u><\/b><\/p>\n

The <level> determines which members of the printer structure<\/a> are used.<\/p>\n

The most common <level> values are:<\/p>\n

\"clip_image001\"<\/a> Level 2: Used to configure most print queue settings.<\/p>\n

\"clip_image001[1]\"<\/a> Level 3: Used to set print queue security.<\/p>\n

\"clip_image001[2]\"<\/a> Level 8: Used to set global document printing defaults.<\/p>\n

Help for each level is available by running SetPrinter \u2013help <level><\/p>\n

If there is a specific setting you are interested in, you may configure a print queue as desired in the GUI and then use the SetPrinter \u2013show option to find the value.<\/p>\n

Self-Help Walkthrough:<\/u><\/b><\/p>\n

These scenarios are intended to \u201cteach you to fish\u201d.<\/p>\n

Example One:<\/strong><\/p>\n

I need to know what setting controls landscape vs. portrait in the Printing Defaults, and then set that to landscape for all print queues.<\/p>\n

1) This is a global setting that I want all clients to get when the print queue is connected to for the first time, so 8 is the appropriate level.<\/p>\n

2) Run SetPrinter \u2013help 8 to see the level-specific help.<\/p>\n

3) Run SetPrinter \u2013examples 8 to see some examples.<\/p>\n

4) Create a printer called HP and configure it to print in portrait mode.<\/p>\n

5) Run setprinter -show "HP" 8.<\/p>\n

6) Use the GUI to reconfigure the HP printer to print in landscape mode.<\/p>\n

7) Run setprinter -show "HP" 8.<\/p>\n

8) Compare the SetPrinter \u2013show results to discover dmOrientation has changed from 1 to 2.<\/p>\n

9) Roll out the change to all print queues with SetPrinter "\u201d 8 pDevMode=dmOrientation=1.<\/p>\n

Example Two:<\/strong><\/p>\n

I need to know what setting controls a print processor, and then switch all queues to WinPrint.<\/p>\n

1) This is a general setting for the print queue, so 2 is the appropriate level.<\/p>\n

2) Run SetPrinter \u2013help 2 to see the level-specific help.<\/p>\n

3) Run SetPrinter \u2013examples 2 to see some examples. <\/p>\n

4) Create a printer called Xerox and set it to the WinPrint print processor.<\/p>\n

5) Run setprinter \u2013show \u201cXerox\u201d 2.<\/p>\n

6) Use the GUI to reconfigure the Xerox printer to use a 3rd<\/sup> party print processor.<\/p>\n

7) Run setprinter \u2013show \u201cXerox\u201d 2.<\/p>\n

8) Compare the SetPrinter \u2013show results to discover pPrintProcessor has changed.<\/p>\n

9) Roll out WinPrint to all print queues with SetPrinter "" 2 pPrintProcessor=WinPrint.
Note: Most 3rd<\/sup> party drivers work fine with WinPrint. When in doubt, ask your OEM.<\/p>\n

Example Three:<\/strong><\/p>\n

I need to mirror the security settings on one print queue to all other queues.<\/p>\n

1) This is a security setting for the print queue, so 3 is the appropriate level.<\/p>\n

2) Run SetPrinter \u2013help 3 to see the level-specific help.<\/p>\n

3) Run SetPrinter \u2013examples 3 to see some examples. <\/p>\n

4) Create a printer called Lexmark and set security as desired.<\/p>\n

5) Run setprinter \u2013show \u201cLexmark\u201d 3 and copy the security descriptor.<\/p>\n

6) Roll out the security descriptor to all print queues with SetPrinter "" 3 <Security Descriptor>.<\/p>\n

Note: You may need to run this as the local system account. (psexec \u2013s \u2013i cmd.exe)<\/p>\n

<\/u><\/b><\/p>\n

TechNet Script Repository<\/u><\/b><\/p>\n

The TechNet Script Repository provides printer management scripts with support provided through the forums. Whether you\u2019re a developer or a \u201cscript kiddie\u201d, this is the place to go for all of your custom printer management scripting needs. Maybe you can even contribute something to the community? J<\/p>\n

TechNet Script Center Repository
http:\/\/gallery.technet.microsoft.com\/scriptcenter<\/a><\/p>\n

Disclaimer: The sample scripts are not supported under any Microsoft standard support program or service. The sample scripts are provided AS IS without warranty of any kind. Microsoft further disclaims all implied warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or performance of the sample scripts and documentation remains with you. In no event shall Microsoft, its authors, or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the sample scripts or documentation, even if Microsoft has been advised of the possibility of such damages.<\/p>\n

I hope you\u2019ve enjoyed reading this information as much as I have putting it together for you, and I sincerely hope one or more of these options can save you some time in the near future.<\/p>\n

–Aaron Maxwell<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

http:\/\/blogs.technet.com\/b\/askperf\/archive\/2011\/09\/16\/print-queue-scripting.aspx Many methods of programmatically working with printers exist and I\u2019ll be going over the main ones we use on the Windows platform support teams in this blog. These can be real lifesavers for print server administrators if changes need to be made across many queues. As a quick caveat, please keep in mind that […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-126","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=\/wp\/v2\/posts\/126","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=126"}],"version-history":[{"count":1,"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=\/wp\/v2\/posts\/126\/revisions"}],"predecessor-version":[{"id":782,"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=\/wp\/v2\/posts\/126\/revisions\/782"}],"wp:attachment":[{"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=126"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=126"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.itcrumbs.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=126"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}