Out-Printer
將輸出傳送到印表機。
語法
Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]
描述
Out-Printer Cmdlet 會將輸出傳送到預設印表機或備用印表機 (如果有指定)。
參數
-InputObject <psobject>
指定要傳送至印表機的物件。請輸入包含物件的變數，或輸入可取得物件的命令或運算式。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
true (ByValue) |
接受萬用字元? |
false |
-Name <string>
指定備用印表機。參數名稱 ("Name") 為選擇項。
必要? |
false |
位置? |
1 |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
System.Management.Automation.PSObject 您可經由管道將任何物件輸出至 Out-Printer。 |
輸出 |
無 Out-Printer 不會傳回任何物件。 |
附註
您也可以利用內建的別名 "lp" 來參照 Out-Printer。如需詳細資訊，請參閱 about_Aliases。
包含 Out 動詞的 Cmdlet (Out Cmdlet) 不會將物件格式化，而是單僅轉譯物件再傳送到指定的顯示目的地。若將尚未格式化的物件傳送給 Out cmdlet，cmdlet 便會在轉譯前先將物件傳送給格式化 cmdlet。
Out cmdlet 沒有名稱參數或檔案路徑參數。若要傳送資料給 Out Cmdlet，請使用管線運算子 (|) 將 Windows PowerShell 命令的輸出傳送給 Cmdlet。您也可以將資料儲存至變數，再使用 InputObject 參數將資料傳遞給 cmdlet。如需詳細資訊，請參閱範例。
Out-Printer 會傳送資料，但是不會發出任何輸出物件。如果您經由管道將 Out-Printer 的輸出輸出至 Get-Member，Get-Member 就會報告尚未指定物件的狀況。
範例 1
C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer
描述
-----------
這個命令會將 about_Signing 說明主題的內容列印到預設印表機。這個範例告訴您如何列印檔案 (即使 Out-Printer 沒有 Path 參數)。
這個命令會使用 Get-Content Cmdlet 取得說明主題的內容。路徑包含 $pshome，這是儲存 Windows PowerShell 安裝目錄的內建變數。管線運算子 (|) 會將結果傳遞給 Out-Printer，後者再將它傳送至預設印表機。
範例 2
C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"
描述
-----------
這個命令將 "Hello, World" 列印到 Server01 上的 "Prt-6B Color" 印表機。這個命令使用 Name 參數來指定備用印表機。因為參數名稱為選擇性，您可以省略。
範例 3
C:\PS>$h = get-help -full get-wmiobject
C:\PS> out-printer -inputobject $h
描述
-----------
這些命令會列印 Get-WmiObject 說明主題的完整版本。第一個命令會使用 Get-Help Cmdlet 來取得 Get-WmiObject 說明主題的完整版本，並將它儲存在 $h 變數中。第二個命令將內容傳送到預設印表機。它會使用 InputObject 參數，將 $h 變數的值傳遞給 Out-Printer。