C.2 Using IPPman Commands to Configure iPrint Printers

You can configure iPrint printers by using ZENworks Control Center or by using the zman command line utility. In addition, you can use the IPPman utility to perform repetitive and mass operations on printer policies that have an iPrint printer matching a specific iPrint URI or matching a specific search criteria.

For more information on creating printer policies by using ZENworks Control Center, see Section 3.5, Printer Policy.

For more information on creating printer policies by using zman command line utility, see ZENworks Command Line Utilities.

Review the following sections for more information on using the IPPman commands:

C.2.1 Creating an iPrint Printer

To create a new iPrint printer configuration for all the policies that match specific printer URI criteria:

  1. Create the iPrint printer configuration file.

    For information on creating the iPrint printer configuration file, see Section C.3, Understanding the Format of the iPrint Printer Configuration File.

  2. Use the ippman create command to create a new iPrinter printer for all the printer policies that have an iPrint printer with the URI specified in the command.

    The printer name and the printing preferences for the new iPrinter printer are specified in the iPrint printer configuration file.

    • On a ZENworks server, enter the command as follows:

      ippman create -uri iprint_printer_uri -conf iprint_printer_configuration file -username username -password password

      Example:

      ippman create -uri ipp://10.0.0.0/ipp/Printer1 -conf "c:\\printerdata.xml" -username Administrator -password xxxxx

    • On a device other than the ZENworks server, enter the command as follows:

      ippman create -uri iprint_printer_uri -conf iprint_printer_configuration file -server ZENworks_server_ip -port port_number -username username -password password

      Example:

      ippman create -uri ipp://10.0.0.0/ipp/Printer1 -conf "c:\\printerdata.xml" -server 10.0.0.0 -port 80 -username Administrator -password xxxxx

Table C-1 Options Used with the Create Command

Option

Description

uri

URI of the iPrint printer to search.

conf

iPrint printer configuration file containing the printer name and the printing preferences.

username and password

Credentials of the ZENworks administrator.

server

IP address of the ZENworks server.

port

Port of the ZENworks server. The default port is 80.

To refer to the online help for the command, enter the following command:

ippman create -help

C.2.2 Cloning an iPrint Printer

To clone the iPrint printer configuration for all policies that match specific printer URI criteria, use the ippman clone command.

This command creates a new iPrinter printer for all the printer policies that have an iPrint printer with the URI specified in the command. The URI of the new iPrint printer is also specified in the command. The cloned printer has the same printing preferences as the original printer.

  • On a ZENworks server, enter the command as follows:

    ippman clone -uri iprint_printer_uri -uri2 iprint_printer_uri_for_clone -default true/false -updatedriver true/false -username username -password password

    Example:

    ippman clone -uri ipp://10.0.0.0/ipp/Printer -uri2 ipp://10.0.0.0/ipp/Printer1 -default true -updatedriver true -username Administrator -password xxxxx

  • On a device other than the ZENworks server, enter the command as follows:

    ippman clone -uri iprint_printer_uri -uri2 iprint_printer_uri_for_clone -default true/false -updatedriver true/false -server ZENworks_server_ip -port port_number -username username -password password

    Example:

    ippman clone -uri ipp://10.0.0.0/ipp/Printer -uri2 ipp://10.0.0.0/ipp/Printer1 -default true -updatedriver true -server 10.0.0.0 -port 80 -username Administrator -password xxxxx

Table C-2 Options Used with the Clone Command

Option

Description

uri

URI of the iPrint printer to search.

uri2

URI of the iPrint printer to clone.

default

Whether this is the default printer. The available options are true or false.

updatedriver

Update the printer driver. The available options are true or false.

username and password

Credentials of the ZENworks administrator.

server

IP address of the ZENworks server.

port

Port of the ZENworks server. The default port is 80.

To refer to the online help for the command, enter the following command:

ippman clone -help

After cloning an iPrint printer, you can choose to delete the original iPrint printer. For more information on deleting the iPrint printer, see Section C.2.5, Deleting an iPrint Printer.

C.2.3 Renaming an iPrint Printer

To rename the iPrint printer configuration for all policies that match specific printer URI criteria, use the ippman rename command.

  • On a ZENworks server, enter the command as follows:

    ippman rename -uri iprint_printer_uri -uri2 renamed_iprint_printer_uri -default true/false -updatedriver true/false -username username -password password

    Example:

    ippman rename -uri ipp://10.0.0.0/ipp/Printer -uri2 ipp://10.0.0.0/ipp/Printer1 -default true -updatedriver true -username Administrator -password xxxxx

  • On a device other than the ZENworks server, enter the command as follows:

    ippman rename -uri iprint_printer_uri -uri2 renamed_iprint_printer_uri -default true/false -updatedriver true/false -server ZENworks_server_ip -port port_number -username username -password password

    Example:

    ippman rename -uri ipp://10.0.0.0/ipp/Printer -uri2 ipp://10.0.0.0/ipp/Printer1 -default true -updatedriver true -server 10.0.0.0 -port 80 -username Administrator -password xxxxx

Table C-3 Options Used with the Rename Command

Option

Description

uri

URI of the iPrint printer to search.

uri2

URI of the iPrint printer to rename.

default

Whether this is the default printer. The available options are true or false.

updatedriver

Update the printer driver. The available options are true or false.

username and password

Credentials of the ZENworks administrator.

server

IP address of the ZENworks server.

port

Port of the ZENworks server. The default port is 80.

To refer to the online help for the command, enter the following command:

ippman rename -help

C.2.4 Modifying an iPrint Printer

To create a new iPrint printer configuration for all policies that match specific printer URI criteria, and modify the default settings:

  1. Create the iPrint printer configuration file.

    For information on creating the iPrint printer configuration file, see Section C.3, Understanding the Format of the iPrint Printer Configuration File.

  2. Use the ippman modify command.

    • On a ZENworks server, enter the command as follows:

      ippman modify -uri iprint_printer_uri -conf iprint_printer_configuration file -username username -password password

      Example:

      ippman modify -uri ipp://10.0.0.0/ipp/Printer1 -conf "c:\\printerdata.xml" -username Administrator -password xxxxx

    • On a device other than the ZENworks server, enter the command as follows:

      ippman modify -uri iprint_printer_uri -conf iprint_printer_configuration file -server ZENworks_server_ip -port port_number -username username -password password

      Example:

      ippman modify -uri ipp://10.0.0.0/ipp/Printer1 -conf "c:\\printerdata.xml" -server 10.0.0.0 -port 80 -username Administrator -password xxxxx

Table C-4 Options Used with the Modify Command

Option

Description

uri

URI of the iPrint printer to search.

conf

iPrint Printer Configuration file containing the printer name and the printing preferences.

username and password

Credentials of the ZENworks administrator.

server

IP address of the ZENworks server.

port

Port of the ZENworks server. The default port is 80.

To refer to the online help for the command, enter the following command:

ippman modify -help

C.2.5 Deleting an iPrint Printer

To delete a new iPrint printer configuration for all policies that match specific printer URI criteria, use the ippman delete command.

  • On a ZENworks server, enter the command as follows:

    ippman delete -uri iprint_printer_uri -username username -password password

    Example:

    ippman delete -uri ipp://10.0.0.0/ipp/Printer1 -username Administrator -password xxxxx

  • On a device other than the ZENworks server, enter the command as follows:

    ippman delete -uri iprint_printer_uri -server ZENworks_server_ip -port port_number -username username -password password

    Example:

    ippman delete -uri ipp://10.0.0.0/ipp/Printer1 -server 10.0.0.0 -port 80 -username Administrator -password xxxxx

Table C-5 Options Used with the Delete Command

Option

Description

uri

URI of the iPrint printer to delete.

username and password

Credentials of the ZENworks administrator.

server

IP address of the ZENworks server.

port

Port of the ZENworks server. The default port is 80.

To refer to the online help for the command, enter the following command:

ippman delete -help

C.2.6 Exporting iPrint Printer

To export the iPrint printer configuration for all policies that match a specific printer URI criteria, use the ippman export command.

  • On a ZENworks server, enter the command as follows:

    ippman export -uri iprint_printer_uri -folder export_folder -username username -password password

    Example:

    ippman export -uri ipp://10.0.0.0/ipp/Printer1 -folder "c:\\export" -username Administrator -password xxxxx

  • On a device other than the ZENworks server, enter the command as follows:

    ippman export -uri iprint_printer_uri -folder export_folder -server ZENworks_server_ip -port port_number -username username -password password

    Example:

    ippman export -uri ipp://10.0.0.0/ipp/Printer1 -folder "c:\\export" -server 10.0.0.0 -port 80 -username Administrator -password xxxxx

Table C-6 Options Used with the Export Command

Option

Description

uri

URI of the iPrint printer to search.

folder

Folder to which the XML files containing the iPrint printer configuration is exported. For every printer policy that matches the search criteria, an XML file is created.

The XML file is named policyname_policyUID.

where policyname is the name of the printer policy and policyUID is the unique ID of the printer policy.

username and password

Credentials of the ZENworks administrator.

server

IP address of the ZENworks server.

port

Port of the ZENworks server. The default port is 80.

To refer to the online help for the command, enter the following command:

ippman export -help

C.2.7 Importing an iPrint Printer

To import the iPrint printer configuration to a printer policy, you must use the XML file that contains the exported iPrint printer configuration information

For information on the format of the file, see Section C.5, iPrint Printer List Import File Format.

  1. (Conditional) Depending on the requirements, modify the XML file created when you export the iPrint printer.

    For more information on exporting the iPrint printer, see Exporting iPrint Printer.

  2. Use the ippman import command to import the iPrint printer configuration to all the printer policies matching a specific iPrint URI or a specific search criteria.

    • On the ZENworks server, enter the command as follows:

      ippman import -uri iprint_printer_uri -folder import_folder -username username -password password

      Example:

      ippman import -uri ipp://10.0.0.0/ipp/Printer1 -folder "c:\\export" -username Administrator -password xxxxx

    • On the device other than the ZENworks server, enter the command as follows:

      ippman import -uri iprint_printer_uri -folder import_folder -server ZENworks_server_ip -port port_number -username username -password password

      Example:

      ippman import -uri ipp://10.0.0.0/ipp/Printer1 -folder "c:\\export" -server 10.0.0.0 -port 80 -username Administrator -password xxxxx

Table C-7 Options Used with the Import Command

Option

Description

uri

URI of the iPrint printer to search.

folder

Folder from which the iPrint printer configuration is imported.

This folder contains the exported iPrint printer configuration saved in an XML file named policyname_policyUID.

where policyname is the name of the printer policy and policyUID is the unique ID of the printer policy.

username and password

Credentials of the ZENworks administrator.

server

IP address of the ZENworks server.

port

Port of the ZENworks server. The default port is 80.

To refer to the online help for the command, enter the following command:

ippman import -help