iprntcmd (1)

Name

iprntcmd - iprint administrative utility.

SYNTAX

iprntcmd <options> <parameter>

DESCRIPTION

iprntcmd provides command-line functionality for iPrint administrative tasks on a workstation.

OPTION SUMMARY

You must use quotes around parameters that contain spaces.

OPTIONS

Option type <parameter>

-a | --addprinter <printer-uri>

Installs the specified printer.

-c | --clearallpasswords

Clears all saved passwords.

-d | --delprinter <printer-uri>

Removes the specified printer.

-d | --delprinter all

Remove all the printers. This option requires your confirmation before removing all the printers.

-d | --delprinter all --force

Remove all the printers. This option removes all the printers forcibly without any user intervention.

-f | --fetchdriverlocal <printer-uri>

Fetches the printer driver on local machine.

-g | --getdefault

Displays the default printer installed on the workstation.

-h | --help

Displays help for the command.

-j | --listjobs <printer-uri>

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

-i | --info <printer-uri>

Displays the printer information.

--icm-refresh [no-gui]

Applies the iCM settings modified by the administrator. If the [no-gui] option is used, the modified settings are applied but no iCM GUI is displayed.

-l | --listprinters

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.

-P | --ppdlist

Lists the PPDs installed on this workstation. This option is only available on a Macintosh client.

-r | --run-listener

Launches the iprint-listener process if it is not already running. This option is only available on a Macintosh client.

-r | --purgealljobs <printer-uri>

Purges all jobs of the specified printer. This option is only available on a Windows client.

-s | --setdefault <printer-uri>

Sets the specified printer as the default.

-S | --setprimarypsm <IP/DNS>

Sets the PSM address for iCM configuration.

-t | --testpage <printer-uri>

Prints a test page to the specified printer.

-T | --tray-icon

Displays an iPrint icon to the notification area and launches the iprint-listener-gui process, if it is not running. This option is only available with Macintosh client.

-u | --uploadids <ids-uri> <ppd path with/without wildcards>

Uploads the specified PPD files to the indicated driver store where ids_uri is the IP address or DNS name for the driver store, and ppd is the directory path and filename to the PPD files. You can use a wildcard in the PPD filename.

-U | --uploadbroker <rms-uri> <rms-name> <ppd path with/without wildcards>

Uploads the specified PPD files to the indicated Broker where rms_uri is the IP address or DNS name for the Broker’s associated print manager, rms_name is the username with rights to add drivers to the broker, and ppd is the directory path and filename to the PPD files. You can use a wildcard in the PPD filename.

-v | --version <psm-hostname or psm-address>

Displays the server platform and version information where server_uri is the URI for the server.

-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.

EXAMPLES

Syntax

iprntcmd --<option> ipp://<host_address>/ipp/<printer_name>

Example to add a printer

iprntcmd --addprinter ipp://printing.MyCompany.com/ipp/Printer1

Example to delete a printer

iprntcmd --delprinter ipp://printing.MyCompany.com/ipp/Printer1

Example to get a default printer

iprntcmd --getdefault

Example to list the print jobs

iprntcmd --listjobs ipp://printing.MyCompany.com/ipp/Printer1

Example to get the list of installed printers

iprntcmd --listprinters

Example to get the list of printers on a server

iprntcmd --listprintersonserver printing.MyCompany.com

Example to print a file

iprntcmd --printfile ipp://printing.MyCompany.com/ipp/Printer1 /home/user1/temp.txt

Example to get a list of local ppd files

iprntcmd --ppdlist

Example to set a default printer

iprntcmd --setdefault ipp://printing.MyCompany.com/ipp/Printer1

Example to test a print page

iprntcmd --testpage ipp://printing.MyCompany.com/ipp/Printer1

Example to upload driver <without using a wildcard> to ids

iprntcmd --uploadids printing.MyCompany.com /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

or

iprntcmd --uploadids 192.168.3.4 /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

Example to upload driver <using a wildcard> to ids

iprntcmd --uploadids printing.MyCompany.com /usr/share/cups/model/HP/LaserJet_4*

or

iprntcmd --uploadids 192.168.3.4 /usr/share/cups/model/HP/LaserJet_4*

Example to upload drivers (without using a wildcard) to rms

iprntcmd --uploadbroker printing.MyCompany.com rms_name /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

or

iprntcmd --uploadbroker 192.168.3.4 rms_name /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

Example to upload drivers (using a wildcard) to rms

iprntcmd --uploadbroker printing.MyCompany.com rms_name /usr/share/cups/model/HP/LaserJet_4*

or

iprntcmd --uploadbroker 1.2.3.4 rms_name /usr/share/cups/model/HP/LaserJet_4*

Example to get iprint server version

iprntcmd --version printing.MyCompany.com

or

iprntcmd --version 192.168.3.4

Example to get information of a printer