PowerShell Logo Small

Add-Printer



This is the built-in help made by Microsoft for the command 'Add-Printer', in PowerShell version 4 - as retrieved from Windows version 'Microsoft Windows 8.1 Enterprise' 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 [-ConnectionName] <String> [-AsJob] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
Add-Printer [-Name] <String> [-DriverName] <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>] -PortName <String> [-Confirm] [-WhatIf] [<CommonParameters>]
Add-Printer [-Name] <String> [-AsJob] [-BranchOfficeOfflineLogSizeMB <UInt32>] [-CimSession <CimSession[]>] [-Comment <String>] [-ComputerName <String>] [-Datatype <S
tring>] [-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>]



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

Online Version: http://go.microsoft.com/fwlink/?LinkId=289207
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.