4.9 Implementing iPrint by Using the Command Line

Iprntcmd.exe is a DOS command line utility that lets you install iPrint printers without a web browser and capture LPT ports to iPrint printers. This command is useful when you have legacy applications that require output to an LPT port or when you want to add printers through a login script.

4.9.1 Using iprntcmd.exe to Install iPrint Printers

If you need to install an iPrint printer but cannot use a web browser, you can use the iprntcmd.exe command at a DOS prompt. The iprntcmd.exe command can install, remove, or set a printer as the default printer.

Use the following parameters when executing the iprntcmd command.

Table 4-1 Parameters Used with iprntcmd

Parameters

Description

-a | --addprinter options printer_uri

Installs the specified printer. You can replace options with any or all of the following:

  • no-gui: Does not display the printer installation dialog box when installing a printer.

  • default: Installs the specified printer as the default printer.

  • temp: The installed printer is removed when the workstation is rebooted.

NOTE:These options are available only in the Windows Client.

-c

Clears the password from the cache.

-d | --delprinter printer_uri

Removes the specified printer.

-f | --fetchdriverlocal printer_uri

Pulls drivers from the server and stores them in the local cache directory, such as the c:\ndsp\drvr_cache directory.

-g | --getdefault

Displays the default printer installed on the workstation.

-h | --help

Displays help for the command.

-i | --info printer_uri

Displays the printer information.

-j | --listjobs printer_uri

Lists the print jobs for the specified printer that are on the server in a pending or printing state.

-l | --listlocalprinters

Lists printers installed on the workstation.

-L | --listprintersonserver psm-hostname or psm-address

Lists iPrint printers on the specified Print Manager where psm-hostname or psm-address can be a DNS name or IP address.

-p | --printfile printer-uri file path

Sends a printer-ready file to the specified iPrint printer.

This option is used to test the print path (job flow) from the client workstation to the server and subsequently to the printer. This requires a print-ready file as an input. The printer or the driver does not need to be installed on the client workstation.

-P | --ppdlist

Lists the PPDs installed on this workstation.

-s | --setdefault printer_uri

Sets the specified printer as the default.

-S | --setprimarypsm psm-hostname or psm-address

Sets the PSM address for iCM configuration.

-t | --testpage printer_uri

Prints a test page to the specified printer.

-v | --version server_uri server_user

Displays the server platform and version information, where server_uri is the URI for the server and server_user is a valid user for the server.

-U | --uploaddriver <ids-address> or <ids-hostname> <username> <password> [INF-Filepath <model-name>]

Uploads printer drivers.

IMPORTANT:INF-Filepath and model-name are mandatory only for Windows XP platforms.

-w | --trustedwebsiteforInternetExplorer printer_installation_page_uri

Adds the specified URI of the printer installation page to the trusted site list for Internet Explorer.

The trusted site list allows users to view and add the printers directly from the printer IPP site or printer map page, without running the Internet Explorer browser with administrator privileges on Windows Vista.

For example, http://printing.my_company.com/ipp.

Use quotes around printer-uri if it contains spaces.

Syntax

iprntcmd parameters

Example

To install a printer named ColorPrinter1 and set it as the default printer, you would enter the following command:

iprntcmd -a -s ipp://printing.my_company.com/ipp/ColorPrinter1