Out-Printer
將輸出傳送至印表機。
語法
Default (預設值)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
Out-Printer cmdlet 將輸出發送到預設印表機或備用印表機（如果指定了）。
範例
範例 1：將説明主題的內容列印到預設印表機
PS C:\> Get-Content $pshome\about_signing.help.txt | Out-Printer
此命令會將about_Signing說明主題的內容列印至預設印表機。 此示例顯示如何列印檔，即使 Out-Printer 沒有 Path 參數。
命令會使用 Get-Content Cmdlet 來取得說明主題的內容。 路徑包含$pshome，這是儲存 Windows PowerShell 安裝目錄的內建變數。 管道運算子 （|） 將結果傳遞給 Out-Printer，後者將其發送到預設印表機。
範例 2：將文本列印到備用印表機
PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
此命令將 Hello， World 印出 Server01 上的 Prt-6B 彩色印表機。 此命令使用 Name 參數指定備用印表機。 因為參數名稱是選擇性的，所以您可以省略它。
範例 3：將幫助主題的完整版本列印到預設印表機
PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> Out-Printer -InputObject $H
這些命令會列印 Get-WmiObject 說明主題的完整版本。 第一個命令使用 Get-Help cmdlet 獲取 Get-WmiObject 的幫助主題的完整版本，並將其存儲在 $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
您可以通過管道將任何物件傳輸到 Out-Printer。
輸出
None
Out-Printer 不返回任何物件。
備註
您還可以通過其內置別名 lp 來引用 Out-Printer。 如需詳細資訊，請參閱about_Aliases。
包含 Out 謂詞的 cmdlet 不會設定物件的格式;它們只是渲染它們並將其發送到指定的顯示目標。 如果您將未格式化的對象傳送至 Out Cmdlet，Cmdlet 會在轉譯之前，先將它傳送至格式化 Cmdlet。
Out Cmdlet 沒有名稱或檔案路徑的參數。 若要將數據傳送至 Out Cmdlet，請使用管線運算子 （|） 將 Windows PowerShell 命令的輸出傳送至 Cmdlet。 您也可以將數據儲存在變數中，並使用 InputObject 參數將數據傳遞至 Cmdlet。 如需詳細資訊，請參閱範例。
Out-Printer 發送數據，但它不會發出任何輸出物件。 如果通過管道將 Out-Printer 的輸出傳遞給 Get-Member， 則 Get-Member 會報告未指定任何物件。