Get-Printer

Get-Printer

Retrieves a list of printers installed on a computer.

구문

Parameter Set: Query (cdxml)
Get-Printer [[-Name] <String[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-Full] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

자세한 설명

The Get-Printer cmdlet retrieves a list of printers installed on a computer. You can also use Get-Printer to retrieve the properties of a single printer, and then use that information as input into other cmdlets.

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

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

매개 변수

-AsJob

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-CimSession<CimSession[]>

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

별칭

Session

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ComputerName<String>

Specifies the name of the computer from which to retrieve the printer information.

별칭

CN

필수 여부

false

위치

named

기본값

local machine name

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Full

Specifies all the printer parameters to retrieve including RenderingMode and PermissionSDDL.

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Name<String[]>

Specifies the name of the printer about which to retrieve information.

별칭

없음

필수 여부

false

위치

1

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ThrottleLimit<Int32>

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

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

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

입력

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

  • None

    This cmdlet accepts no input objects.

출력

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

  • Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_Printer

    This cmdlet outputs one or more printer objects.

예제

Example 1: Get a list of printers

This command retrieves a list of printers and printer connections on the local computer.

PS C:\> Get-Printer

Example 2: Get the information for a specific printer

This command retrieves information for one specific printer named "Microsoft XPS Document Writer".

PS C:\> Get-Printer –Name "Microsoft XPS Document Writer"

Example 3: Get the detailed information for a specific printer

This command retrieves detailed information for one specific printer named "Microsoft XPS Document Writer".

PS C:\> Get-Printer –Name "Microsoft XPS Document Writer" | Format-List

Example 4: Get a list of printers on a remote computer

This command retrieves a list of printers from the computer named PrintServer.

PS C:\> Get-Printer -ComputerName PrintServer

Example 5: Get a list of printer objects and then rename the printers

This set of commands retrieves a printer object into a variable ($Printer) and then passes the contents of the variable to Rename-Printer.

PS C:\> $Printer = Get-Printer -Name “Microsoft XPS Document Writer"
PS C:\> Rename-Printer -InputObject $printer "MXDW"

관련 항목

Add-Printer

Set-Printer

Remove-Printer

Rename-Printer