Out-Printer
將輸出傳送至印表機。
語法
Default (預設值)
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 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
將輸出傳送至指定的印表機。 參數名稱 Name 為選擇性。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | PrinterName |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
PSObject
您可以將任何物件通過管道傳遞至此命令工具。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 僅適用於 Windows 平臺。
包含 Out 動詞命令的 Cmdlet 不會格式化物件。 它們只會轉譯它們，並將其傳送至指定的顯示目的地。 如果您將未格式化的物件傳送到 Out Cmdlet，該 Cmdlet 會在轉譯之前將其傳送到格式化 Cmdlet。
Out-Printer 將數據傳送至印表機，但不會將任何輸出對象發出至管線。 如果您使用管線將 Out-Printer 的輸出傳送至 Get-Member，Get-Member 會報告尚未指定任何物件。