Out-Printer (Microsoft.PowerShell.Utility)

Out-Printer

将输出发送到打印机。

句法

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

Out-Printer cmdlet 将输出发送到默认打印机或备用打印机（如果指定）。由于 cmdlet 无法配置打印作业，因此生成的打印作业将使用为打印机定义的默认设置。

笔记

此 cmdlet 在 PowerShell 7 中重新引入。此 cmdlet 仅在支持 Windows 桌面的 Windows 系统上可用。

示例

示例 1 - 发送要在默认打印机上打印的文件

此示例演示如何打印文件，即使 Out-Printer 没有 Path 参数。

Get-Content -Path ./readme.txt | Out-Printer

Get-Content 获取当前目录中 readme.txt 文件的内容，并将其通过管道传输到 Out-Printer，后者将其发送到默认打印机。

示例 2：将字符串打印到远程打印机

此示例将 Hello, World 打印到 Server01 上的 Prt-6B Color 打印机。

"Hello, World" | Out-Printer -Name "\Server01\Prt-6B Color"

名称参数选择特定打印机，而不是默认打印机。

示例 3 - 将帮助主题打印到默认打印机

此示例打印 Get-CimInstance 帮助主题的完整版本。

$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H

Get-Help 获取 Get-CimInstance 帮助主题的完整版本并将其存储在 $H 变量中。 InputObject 参数将 $H 的值传递给 Out-Printer。

参数

-InputObject

指定要发送到打印机的对象。输入包含对象的变量，或键入获取对象的命令或表达式。

PS对象

命名

None

False

True

False

-Name

将输出发送到指定的打印机。参数名称 Name 是可选的。

String

PrinterName

0

None

False

False

False

输入

PSObject

您可以通过管道将任何对象传递给此 cmdlet。

输出

无

此 cmdlet 不返回任何输出。

笔记

此 cmdlet 仅在 Windows 平台上可用。

包含 Out 动词的 cmdlet 不会格式化对象。他们只是渲染它们并将它们发送到指定的显示目的地。如果将未格式化的对象发送到 Out cmdlet，该 cmdlet 会在呈现它之前将其发送到格式化 cmdlet。

Out-Printer 将数据发送到打印机，但不向管道发出任何输出对象。如果将 Out-Printer 的输出通过管道传输到 Get-Member，Get-Member 会报告未指定任何对象。