Add-Printer

Add-Printer

Adds a printer to the specified computer.

Sintaxis

Parameter Set: connection
Add-Printer [-ConnectionName] <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: port
Add-Printer [-Name] <String> [-DriverName] <String> -PortName <String> [-AsJob] [-BranchOfficeOfflineLogSizeMB <UInt32> ] [-CimSession <CimSession[]> ] [-Comment <String> ] [-ComputerName <String> ] [-Datatype <String> ] [-DisableBranchOfficeLogging] [-KeepPrintedJobs] [-Location <String> ] [-PermissionSDDL <String> ] [-PrintProcessor <String> ] [-Priority <UInt32> ] [-Published] [-RenderingMode <RenderingModeEnum> ] [-SeparatorPageFile <String> ] [-Shared] [-ShareName <String> ] [-StartTime <UInt32> ] [-ThrottleLimit <Int32> ] [-UntilTime <UInt32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: wsd
Add-Printer [-Name] <String> [-AsJob] [-BranchOfficeOfflineLogSizeMB <UInt32> ] [-CimSession <CimSession[]> ] [-Comment <String> ] [-ComputerName <String> ] [-Datatype <String> ] [-DeviceURL <String> ] [-DeviceUUID <String> ] [-DisableBranchOfficeLogging] [-KeepPrintedJobs] [-Location <String> ] [-PermissionSDDL <String> ] [-PrintProcessor <String> ] [-Priority <UInt32> ] [-Published] [-RenderingMode <RenderingModeEnum> ] [-SeparatorPageFile <String> ] [-Shared] [-ShareName <String> ] [-StartTime <UInt32> ] [-ThrottleLimit <Int32> ] [-UntilTime <UInt32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Add-Printer cmdlet adds a printer to a specified computer. You can add both local printers and connections to network-based printers.

You cannot use wildcard characters with Add-Printer. You can use Add-Printer in a Windows PowerShell remoting session.

You do not need administrator privileges to use Add-Printer.

Parámetros

-AsJob

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-BranchOfficeOfflineLogSizeMB<UInt32>

Specifies the maximum size, in megabytes, of the branch office remote offline log file for this printer. You cannot specify this parameter for unshared queues or queues that do not have branch office enabled.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Alias	Session
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Comment<String>

Specifies the text to add to the Comment field for the specified printer.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-ComputerName<String>

Specifies the name of the computer to which to add the printer.

Alias	CN
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-ConnectionName<String>

Specifies the name of a shared printer to which to connect. This parameter is required.

Alias	ninguno
¿Requerido?	true
¿Posición?	1
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Datatype<String>

Specifies the data type the printer uses to record print jobs.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-DeviceURL<String>

Adds a WSD (Web Services on Devices) printer to the specified computer. The URL is used for directed discovery.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-DeviceUUID<String>

Specifies the multicast UUID for device detection for the WSD port.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-DisableBranchOfficeLogging

Indicates that branch office remote logging is disabled. You cannot specify this parameter for unshared queues.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-DriverName<String>

Specifies the name of the printer driver for the printer.

Alias	ninguno
¿Requerido?	true
¿Posición?	2
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-KeepPrintedJobs

Specifies whether the print jobs in the queue are kept.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	False
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Location<String>

Specifies the location of the printer.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Name<String>

Specifies the name of the printer to add.

Alias	ninguno
¿Requerido?	true
¿Posición?	1
Valor predeterminado	ninguno
¿Aceptar canalización?	True (ByValue, ByPropertyName)
¿Aceptar caracteres comodín?	false

-PermissionSDDL<String>

Specifies the permissions for the printer as an SDDL (Security Descriptor Definition Language) string.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-PortName<String>

Specifies the name of the port used or created for the printer.

Alias	ninguno
¿Requerido?	true
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-PrintProcessor<String>

Specifies the name of the print processor used by the printer.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Priority<UInt32>

Specifies the relative queue priority.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Published

Specifies whether or not the printer is published in the network directory service.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-RenderingMode<RenderingModeEnum>

Specifies the rendering mode for the printer. You can specify one of the following three rendering modes: SSR (Service Side Rendering), CSR (Client Side Rendering), or Branch Office

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	0
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-SeparatorPageFile<String>

Specifies the path to and name of the separator page to be used by the printer.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-ShareName<String>

Specifies the name by which to share the printer on the network. To share a printer, specify the Shared parameter.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Shared

Indicates whether to share the printer on the network. You can determine the name by which the printer is shared by specifying ShareName. If ShareName is not specified, the name of the printer is used as the share name.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-StartTime<UInt32>

Specifies the starting time of printer availability.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o es especifica un valor de 0, Windows PowerShell ® calcula un límite óptimo para el cmdlet en función del número de cmdlets de CIM que se estén ejecutando en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-UntilTime<UInt32>

Specifies the ending time of printer availability.

Alias	ninguno
¿Requerido?	false
¿Posición?	named
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	falso
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	falso
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

• This cmdlet takes no input objects.

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

• This cmdlet produces no output.

Ejemplos

Example 1: Add a printer to a local computer

This command adds a printer with name "mxdw2" to the local computer. The "mxdw" printer uses the "Microsoft XPS Document Writer v4" driver and the "portprompt:" port.

The “portprompt:” port prompts for a file name to save the XPS document when printing to the XPS printer.

PS C:\> Add-Printer -Name "mxdw 2" -DriverName "Microsoft XPS Document Writer v4" -PortName "portprompt:"

Example 2: Add a new network printer connection

This command adds a new printer by specifying the name of a print server and a shared printer on that server.

PS C:\> Add-Printer -ConnectionName \\printServer\printerName

Temas relacionados

Get-Printer

Set-Printer

Remove-Printer

Rename-Printer