Home > Commands N-Z > Commands P

PRNCNFG


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Configures or displays configuration information about a printer.


Syntax

CSCRIPT PRNCNFG[.VBS] /?

CSCRIPT PRNCNFG[.VBS] -g -p printer_name [-s [remote_computer]] [-u user_name -w password]

CSCRIPT PRNCNFG[.VBS] -x -p printer_name [-s [remote_computer]] [-u user_name -w password] -z new_printer_name

CSCRIPT PRNCNFG[.VBS] -t [-f separator_text] [-h share_name] [-i default_priority] [-l location] [-m comment] [-o priority] -p printer_name [-r port_name] [-s [remote_computer]] [-st start_time] [-u user_name -w password] [-ut end_time] [-y data_type] [{+ | -}direct] [{+ | -}docompletefirst] [{+ | -}enablebidi] [{+ | -}enabledevq] [{+ | -}hidden] [{+ | -}keepprintedjobs] [{+ | -}published] [{+ | -}queued] [{+ | -}rawonly] [{+ | -}shared] [{+ | -}workoffline]

Displays command-line help:

CSCRIPT PRNCNFG[.VBS]


Parameters
{+ | -}direct (NTXP)
Specifies whether the document should be sent directly to the printer without being spooled.
{+ | -}docompletefirst (NTXP)
Specifies whether the spooler should send to the appropriate queue print jobs with a lower priority that have completed spooling before sending to the same queue print jobs with a higher priority that have not completed spooling. If this option is enabled and no documents have completed spooling, the spooler will send larger documents before smaller ones. You should enable this option if you want to maximize printer efficiency at the cost of job priority. If this option is disabled, the spooler always sends higher priority jobs to their respective queues first.
{+ | -}enablebidi (NTXP)
Specifies whether the printer sends status information to the spooler.
{+ | -}enabledevq (NTXP)
Specifies whether print jobs that do not match the printer setup (for example, PostScript files spooled to non-PostScript printers) should be held in the queue rather than being printed.
{+ | -}hidden (NTXP)
Reserved function.
{+ | -}keepprintedjobs (NTXP)
Specifies whether the spooler should retain documents after they are printed. Enabling this option allows a user to resubmit a document to the printer from the print queue instead of from the printing program.
{+ | -}published (NTXP)
Specifies whether this printer should be published in Active Directory. If you publish the printer, other users can search for it based on its location and capabilities, such as color printing and stapling.
{+ | -}queued (NTXP)
Specifies that the printer should not begin to print until after the last page of the document is spooled. The printing program is unavailable until the document has finished printing. However, using this option ensures that the whole document is available to the printer.
{+ | -}rawonly (NTXP)
Specifies whether only raw data print jobs can be spooled on this queue.
{+ | -}shared (NTXP)
Specifies whether this printer is shared on the network.
{+ | -}workoffline (NTXP)
Specifies whether you should be able to send print jobs to the print queue even if your computer is not connected to the network.

Switches
/? (NTXP)
Displays help.
-f separator_text (NTXP)
Specifies a file that contains the text that appears on the separator page.
-g (NTXP)
Specifies that you want to display configuration information about a printer.
-h share_name (NTXP)
Specifies the share name.
-i default_priority (NTXP)
Specifies the default priority assigned to each print job.
-l location (NTXP)
Specifies the printer location.
-m comment (NTXP)
Specifies the comment string.
-o priority (NTXP)
Specifies a priority that the spooler uses to route print jobs. A print queue with a higher priority receives all its jobs before any queue with a lower priority.
-p printer_name (NTXP)
Specifies, by name, the printer about which you want to display information.
-r port_name (NTXP)
Specifies the port to which the printer is connected. If this is a parallel or a serial port, then use the ID of the port (for example, LPT1 or COM1). If this is a TCP/IP port, then use the port name that was specified when the port was added.
-s [remote_computer] (NTXP)
Specifies, by name, the remote computer that manages the printer about which you want to display information. If you do not specify a computer, the local computer is used.
-st start_time (NTXP)
Configures the printer for limited availability. Specifies the time of day after which the printer is available. If you send a document to a printer when it is unavailable, the document is held (spooled) until the printer becomes available. You must specify time as a 24-hour clock.
-t (NTXP)
Specifies that you want to configure a printer.
-u user_name -w password (NTXP)
Specifies an account with permissions to connect by using Windows Management Instrumentation (WMI) services to the computer that hosts the printer about which you want to display information. All members of the Administrators group for that computer have these permissions, but the permissions can also be granted to other users. If you do not specify an account, you must be logged on under an account with these permissions for the command to work.
-ut end_time (NTXP)
Configures the printer for limited availability. Specifies the time of day after which the printer is no longer available. If you send a document to a printer when it is unavailable, the document is held (spooled) until the printer becomes available. You must specify time as a 24-hour clock.
-x (NTXP)
Specifies that you want to change the name of a printer.
-y data_type (NTXP)
Specifies the data types that the printer can accept.
-z new_printer_name (NTXP)
Specifies the new printer name.

Related

none.


Notes

none.


Examples

none.


Errorlevels

none.


Availability
External
DOS
none
Windows
none
Windows NT
NTXP NT2003

Last Updated: 2003/07/28
Direct corrections or suggestions to: Rick Lively