Sends output to a printer. (Out-Printer)



Sends output to a printer.

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

The Out-Printer cmdlet sends output to the default printer or to an alternate printer, if one is specified.

-InputObject <psobject>
Specifies the objects to be sent to the printer. Enter a variable that contains the objects, or type a command or expression that gets the objects.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false

-Name <string>
Specifies the alternate printer. The parameter name ("Name") is optional.

Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false

This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

You can pipe any object to Out-Printer.

Out-Printer does not return any objects.


You can also refer to Out-Printer by its built-in alias, "lp". For more information, see about_Aliases.

The cmdlets that contain the Out verb (the Out cmdlets) do not format objects; they just render them and send them to the specified display destination. If you send an unformatted object to an Out cmdlet, the cmdlet sends it to a formatting cmdlet before rendering it.

The Out cmdlets do not have parameters for names or file paths. To send data to an Out cmdlet, use a pipeline operator (|) to send the output of a Windows PowerShell command to the cmdlet. You can also store data in a variable and use the InputObject parameter to pass the data to the cmdlet. For more information, see the examples.

Out-Printer sends data, but it does not emit any output objects. If you pipe the output of Out-Printer to Get-Member, Get-Member reports that no objects have been specified.


C:\PS>get-content $pshome\ | Out-Printer

# Description
This command prints the content of the about_Signing Help topic to the default printer. This example shows you how to print a file, even though Out-Printer does not have a Path parameter.

The command uses the Get-Content cmdlet to get the contents of the Help topic. The path includes $pshome, a built-in variable that stores the installation directory for Windows PowerShell. A pipeline operator (|) passes the results to Out-Printer, which sends it to the default printer.


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

# Description
This command prints "Hello, World" to the "Prt-6B Color" printer on Server01. This command uses the Name parameter to specify the alternate printer. Because the parameter name is optional, you can omit it.


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

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

# Description
These commands print the full version of the Help topic for Get-WmiObject. The first command uses the Get-Help cmdlet to get the full version of the Help topic for Get-WmiObject and stores it in the $h variable. The second command sends the content to the default printer. It uses the InputObject parameter to pass the value of the $h variable to Out-Printer.

Online version:

C:\Windows>powershell get-help Out-String -full

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.

OS: Windows 10, 8.1, 8, 7, Vista / Windows Server 2016, 2012, 2008
»»»» ColorConsole

... Home  
... Impressum
... ColorConsole

... CMD
... Netsh-XP
... Netsh-7
... Netsh-Vista
... Powershell
... FAQ
HTTP: ... PS_Windows/en/Out-Printer.htm


How to create recovery drive for Windows-8/10 (8.1, start-disk, boot-CD)?


What does the number of pings per host in TraceRouteOK ?


Recycle Bin on the Desktop Taskbar in Windows 8.1 / 10 for drag and drop to trash, how to?


How to add to Explorer context menu (Windows 7, 8.1, 10)?


Install Windows eight and 8.1 without Windows Live ID and Microsoft account!


Restart the MS Explorer in Windows 8.1 / 10 (Reset, Filemanager)!


Install Windows 10 without Product Key, can I do this?


Passworteingabe ohne Tastatur bei der Anmeldung (Login) in Windows 7, bzw. mit der Bildschirm-Tastatur?