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로 전달합니다.