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 Reference
.
Review the following sections for more information on using the IPPman commands:
To create a new iPrint printer configuration for all the policies that match specific printer URI criteria:
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.
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 7443 -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 7443. |
To refer to the online help for the command, enter the following command:
ippman create -help
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 7443 -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 7443. |
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.
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 7443 -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 7443. |
To refer to the online help for the command, enter the following command:
ippman rename -help
To create a new iPrint printer configuration for all policies that match specific printer URI criteria, and modify the default settings:
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.
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 7443 -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 7443. |
To refer to the online help for the command, enter the following command:
ippman modify -help
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 7443 -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 7443. |
To refer to the online help for the command, enter the following command:
ippman delete -help
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 7443 -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 7443. |
To refer to the online help for the command, enter the following command:
ippman export -help
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.
(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.
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 7443 -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 7443. |
To refer to the online help for the command, enter the following command:
ippman import -help