Out-Printer

参考

模块:: Microsoft.PowerShell.Utility

将输出发送到打印机。

语法

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 颜色 打印机。

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

Name 参数选择特定的打印机，而不是默认值。

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

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

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

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

参数

-InputObject

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

类型:	PSObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Name

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

类型:	String
别名:	PrinterName
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

PSObject

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

输出

None

此 cmdlet 不返回任何输出。

备注

此 cmdlet 仅在 Windows 平台上可用。

包含 Out 谓词的 cmdlet 不会设置对象的格式。它们只是呈现它们并将其发送到指定的显示目标。如果将未格式化的对象发送到 Out cmdlet，则 cmdlet 会在呈现之前将其发送到格式化 cmdlet。

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

通过