Out-Printer
將輸出傳送至印表機。
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 |
輸入
您可以使用管線將任何物件傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 僅適用於 Windows 平臺。
包含動詞的 Out
Cmdlet 不會格式化物件。 它們只會轉譯它們,並將其傳送至指定的顯示目的地。 如果您將未格式化的對象傳送至 Out
Cmdlet,Cmdlet 會在轉譯之前先將它傳送至格式化 Cmdlet。
Out-Printer
會將數據傳送至印表機,但不會將任何輸出對象發出至管線。 如果您使用管線將的 Out-Printer
輸出傳送至 Get-Member
, Get-Member
則報告尚未指定任何物件。