将输出发送到打印机。
语法
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。 |
|
输出 |
None 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。
另请参阅