다음을 통해 공유


Out-Printer

출력을 프린터로 보냅니다.

구문

Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]

설명

Out-Printer cmdlet은 출력을 기본 프린터로 보내거나 다른 프린터가 지정된 경우 다른 프린터로 보냅니다.

매개 변수

-InputObject <psobject>

프린터로 보낼 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

true (ByValue)

와일드카드 문자 적용 여부

false

-Name <string>

대체 프린터를 지정합니다. 매개 변수 이름("Name")은 선택 사항입니다.

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSObject

임의의 개체를 Out-Printer로 파이프할 수 있습니다.

출력

없음

Out-Printer는 어떠한 개체도 반환하지 않습니다.

참고

또한 해당 기본 제공 별칭("lp")으로 Out-Printer를 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.

Out 동사를 포함하는 cmdlet(Out cmdlet)은 개체의 형식을 지정하지 않고 렌더링만 한 후 지정된 표시 대상으로 보냅니다. 형식을 지정하지 않은 개체를 Out cmdlet에 보내면 이 cmdlet이 형식 지정 cmdlet으로 보낸 후 렌더링합니다.

Out cmdlet에는 이름이나 파일 경로에 대한 매개 변수가 없습니다. 데이터를 Out cmdlet으로 보내려면 파이프라인 연산자(|)를 사용하여 Windows PowerShell 명령의 출력을 cmdlet으로 보내십시오. 데이터를 변수에 저장하고 InputObject 매개 변수를 사용하여 cmdlet에 데이터를 전달할 수도 있습니다. 자세한 내용은 예를 참조하십시오.

Out-Printer는 데이터를 보내지만 출력 개체를 내보내지는 않습니다. Out-Printer의 출력을 Get-Member로 파이프하면 Get-Member에서 지정된 개체가 없음을 보고합니다.

예 1

C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer

설명
-----------
이 명령은 about_Signing 도움말 파일의 내용을 기본 프린터로 인쇄합니다. 이 예에서는 Out-Printer에 Path 매개 변수가 없는 경우에도 파일을 인쇄하는 방법을 보여 줍니다.

이 명령은 Get-Content cmdlet을 사용하여 도움말 항목의 내용을 가져옵니다. 경로에는 Windows PowerShell의 설치 디렉터리를 저장하는 기본 제공 변수 $pshome이 포함됩니다. 파이프라인 연산자(|)는 Out-Printer로 결과를 전달하고 Out-Printer는 이를 기본 프린터로 보냅니다.





예 2

C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"

설명
-----------
이 명령은 Server01의 "Prt-6B Color" 프린터에 "Hello, World"를 출력합니다. 이때 Name 매개 변수를 사용하여 대체 프린터를 지정합니다. 매개 변수 이름은 선택 사항이므로 생략할 수 있습니다.





예 3

C:\PS>$h = get-help -full get-wmiobject

C:\PS> out-printer -inputobject $h

설명
-----------
이들 명령은 Get-WmiObject의 정식 버전 도움말 항목을 인쇄합니다. 첫 번째 명령은 Get-Help cmdlet을 사용하여 Get-WmiObject의 정식 버전 도움말 항목을 가져와 이를 $h 변수에 저장합니다. 두 번째 명령은 그 내용을 기본 프린터로 보냅니다. 이 명령은 InputObject 매개 변수를 사용하여 $h 변수 값을 Out-Printer로 전달합니다.





참고 항목

개념

Out-Host
Out-Null
Out-String
Out-File
Out-Default