Share via

Out-Printer

  • 参考
模块:
Microsoft.PowerShell.Utility

将输出发送到打印机。

语法

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

说明

此 cmdlet 仅在 Windows 平台上可用。

cmdlet Out-Printer 将输出发送到默认打印机或备用打印机（如果指定）。

注意

此 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

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

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

可以通过管道将任何对象传递给 Out-Printer。

输出

None

Out-Printer 不返回任何对象。

备注

此 cmdlet 仅在 Windows 平台上可用。

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

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