Out-Printer
將輸出傳送到印表機。
語法
Default (預設值)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
此 Cmdlet 只能在 Windows 平臺上使用。
Out-Printer指令長會將輸出傳送到預設印表機,或若指定其他印表機,則傳送至其他印表機。 由於 cmdlet 無法設定列印工作,因此產生的列印工作會使用印表機預設的設定。
Note
此 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 彩色 印表機。
"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
名稱參數選擇特定的印表機,而非預設值。
範例 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 會報告尚未指定物件。