Add-Printer

Add-Printer

Adds a printer to the specified computer.

구문

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>]

자세한 설명

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.

매개 변수

-AsJob

-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.

-CimSession<CimSession[]>

원격 세션에서 또는 원격 컴퓨터에서 cmdlet을 실행합니다. New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 컴퓨터 이름이나 세션 개체를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.

-Comment<String>

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

-ComputerName<String>

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

-ConnectionName<String>

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

-Datatype<String>

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

-DeviceURL<String>

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

-DeviceUUID<String>

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

-DisableBranchOfficeLogging

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

-DriverName<String>

Specifies the name of the printer driver for the printer.

-KeepPrintedJobs

Specifies whether the print jobs in the queue are kept.

-Location<String>

Specifies the location of the printer.

-Name<String>

Specifies the name of the printer to add.

-PermissionSDDL<String>

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

-PortName<String>

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

-PrintProcessor<String>

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

-Priority<UInt32>

Specifies the relative queue priority.

-Published

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

-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

-SeparatorPageFile<String>

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

-ShareName<String>

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

-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.

-StartTime<UInt32>

Specifies the starting time of printer availability.

-ThrottleLimit<Int32>

이 cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수가 생략되거나 값 0이 입력되면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 제한 한도를 계산합니다. 제한 한도는 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.

-UntilTime<UInt32>

Specifies the ending time of printer availability.

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

• This cmdlet takes no input objects.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

• This cmdlet produces no output.

예제

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

관련 항목

Get-Printer

Set-Printer

Remove-Printer

Rename-Printer