Out-Printer
將輸出傳送至印表機。
語法
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]Description
此 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
指定要傳送至印表機的物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。
| 類型: | PSObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
將輸出傳送至指定的印表機。 參數名稱 Name 為選擇性。
| 類型: | String |
| 別名: | PrinterName |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
您可以使用管線將任何物件傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 僅適用於 Windows 平臺。
包含 Out 動詞命令的 Cmdlet 不會格式化物件。 它們只會轉譯它們，並將其傳送至指定的顯示目的地。 如果您將未格式化的對象傳送至 Out Cmdlet，Cmdlet 會在轉譯之前先將它傳送至格式化 Cmdlet。
Out-Printer 將數據傳送至印表機，但不會將任何輸出對象發出至管線。 如果您使用管線將 Out-Printer 的輸出傳送至 Get-Member，Get-Member 會報告尚未指定任何物件。
