共用方式為

Out-Printer

  • 參考
模組:
Microsoft.PowerShell.Utility

將輸出傳送到印表機。

Syntax

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 Color 印表機。 這個命令使用 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

指定要傳送到印表機的物件。 輸入包含物件的變數，或輸入可取得物件的命令或運算式。

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

輸入

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 即會報告尚未指定任何物件。