Out-Printer

  • 參考
模組:
Microsoft.PowerShell.Utility

將輸出傳送至印表機。

Syntax

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

Description

此 Cmdlet 僅適用於 Windows 平臺。

如果指定輸出，Cmdlet 會將 Out-Printer 輸出傳送至預設印表機或替代印表機。 由於 Cmdlet 沒有任何方法可設定列印作業，因此產生的列印作業會使用為印表機定義的預設設定。

注意

此 Cmdlet 已在 PowerShell 7 中重新引入。 此 Cmdlet 僅適用於支援 Windows 桌面的 Windows 系統上。

範例

範例 1 - 傳送要列印在預設印表機上的檔案

此範例示範如何列印檔案，即使沒有Path參數也一樣Out-Printer。

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

您可以使用管線將任何物件傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

此 Cmdlet 僅適用於 Windows 平臺。

包含動詞的 Out Cmdlet 不會格式化物件。 它們只會轉譯它們，並將其傳送至指定的顯示目的地。 如果您將未格式化的對象傳送至 Out Cmdlet，Cmdlet 會在轉譯之前先將它傳送至格式化 Cmdlet。

Out-Printer 會將數據傳送至印表機，但不會將任何輸出對象發出至管線。 如果您使用管線將的 Out-Printer 輸出傳送至 Get-Member， Get-Member 則報告尚未指定任何物件。