PowerShell Logo Small

Add-Printer



This is the built-in help made by Microsoft for the command 'Add-Printer', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Adds a printer to the specified computer.

SYNTAX


Add-Printer [-Name] <String> [-DriverName] <String> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-Comment <String>] [-ComputerName
<String>] [-Datatype <String>] [-KeepPrintedJobs [<SwitchParameter>]] [-Location <String>] [-PermissionSDDL <String>] [-PrintProcessor
<String>] [-Priority <UInt32>] [-Published [<SwitchParameter>]] [-RenderingMode <RenderingModeEnum>] [-SeparatorPageFile <String>] [-Shared
[<SwitchParameter>]] [-ShareName <String>] [-StartTime <UInt32>] [-ThrottleLimit <Int32>] [-UntilTime <UInt32>] -PortName <String> [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Add-Printer [-ConnectionName] <String> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-ThrottleLimit <Int32>] [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Add-Printer [-Name] <String> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession>] [-Comment <String>] [-ComputerName <String>] [-Datatype
<String>] [-DeviceURL <String>] [-DeviceUUID <String>] [-KeepPrintedJobs [<SwitchParameter>]] [-Location <String>] [-PermissionSDDL <String>]
[-PrintProcessor <String>] [-Priority <UInt32>] [-Published [<SwitchParameter>]] [-RenderingMode <RenderingModeEnum>] [-SeparatorPageFile
<String>] [-Shared [<SwitchParameter>]] [-ShareName <String>] [-StartTime <UInt32>] [-ThrottleLimit <Int32>] [-UntilTime <UInt32>] [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


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.



<

RELATED LINKS

Get-Printer
Set-Printer
Remove-Printer
Rename-Printer

REMARKS

<

Examples


Example 1: Add a printer to a local computer

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



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.




Example 2: Add a new network printer connection

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



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