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

"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

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

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

将输出发送到指定的打印机。 参数名 (Name) 为可选项。

Type:String
Aliases:PrinterName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PSObject

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

输出

None

此 cmdlet 不返回任何输出。

备注

此 cmdlet 仅在 Windows 平台上可用。

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

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