Out-Printer
将输出发送到打印机。
语法
Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]
说明
Out-Printer cmdlet 将输出发送到默认打印机或备用打印机(如果指定)。
参数
-InputObject <psobject>
指定要发送到打印机的对象。输入一个包含对象的变量,或键入可获取对象的命令或表达式。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
true (ByValue) |
是否接受通配符? |
false |
-Name <string>
指定备用打印机。参数名(“Name”)为可选项。
是否为必需? |
false |
位置? |
1 |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
System.Management.Automation.PSObject 可以通过管道将任何对象传递给 Out-Printer。 |
输出 |
无 Out-Printer 不返回任何对象。 |
说明
还可以使用 Out-Printer 的内置别名“lp”来对其进行引用。有关详细信息,请参阅 about_Aliases。
包含 Out 动词的 cmdlet(输出 cmdlet)不格式化对象;它们只呈现对象,并将对象发送到指定的显示目标。如果将未格式化的对象发送给输出 cmdlet,该 cmdlet 会为它生成显示信息,然后将它发送给格式化 cmdlet。
输出 cmdlet 没有用于提供名称和文件路径的参数。若要向某个输出 cmdlet 发送数据,请使用管道运算符 (|) 将 Windows PowerShell 命令的输出发送到该 cmdlet。还可以将数据存储在变量中,并使用 InputObject 参数将数据传递给 cmdlet。有关详细信息,请参阅示例。
Out-Printer 发送数据,但不发出任何输出对象。如果将 Out-Printer 的输出通过管道传递给 Get-Member,则 Get-Member 将报告尚未指定对象。
示例 1
C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer
说明
-----------
此命令将 about_Signing 帮助主题的内容打印到默认打印机。此示例演示如何在 Out-Printer 没有 Path 参数的情况下打印文件。
该命令使用 Get-Content cmdlet 获取帮助主题的内容。路径包括 $pshome,这是一个内置变量,用于存储 Windows PowerShell 的安装目录。管道运算符 (|) 将结果传递给 Out-Printer,后者将它发送到默认打印机。
示例 2
C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"
说明
-----------
此命令用 Server01 上的“Prt-6B Color”打印机打印“Hello, World”。此命令使用 Name 参数指定备用打印机。因为参数名称可选,所以可以省略该参数。
示例 3
C:\PS>$h = get-help -full get-wmiobject
C:\PS> out-printer -inputobject $h
说明
-----------
这些命令打印 Get-WmiObject 的完整版本的帮助主题。第一个命令使用 Get-Help cmdlet 获取 Get-WmiObject 的完整版本的帮助主题,并将它存储在 $h 变量中。第二个命令将内容发送到默认打印机。它使用 InputObject 参数将 $h 变量的值传递给 Out-Printer。