將輸出傳送到印表機。

語法

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。






請參閱




目錄