Out-Printer

プリンターに出力を送信します。

構文

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

説明

コマンドレットは Out-Printer 、既定のプリンターまたは代替プリンター (指定されている場合) に出力を送信します。 このコマンドレットには印刷ジョブを構成する方法がないため、結果の印刷ジョブではプリンターに対して定義されている既定の設定が使用されます。

Note

このコマンドレットは、PowerShell 7 で再導入されました。 このコマンドレットは、Windows デスクトップをサポートする Windows システムでのみ使用できます。

例 1 - 既定のプリンターに印刷するファイルを送信する

この例では、Path パラメーターがない場合Out-Printerでも、ファイルを印刷する方法を示します。

Get-Content -Path ./readme.txt | Out-Printer

Get-Contentは、現在のディレクトリ内のファイルの readme.txt 内容を取得し、それを Out-Printerパイプして既定のプリンターに送信します。

例 2: リモート プリンターに文字列を印刷する

次の使用例は、Server01 の Prt-6B カラー プリンターに印刷Hello, Worldします。

"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Name パラメーターは、既定ではなく、特定のプリンターを選択します。

例 3 - ヘルプ トピックを既定のプリンターに印刷する

次の使用例は、ヘルプ トピックの完全なバージョンを出力します Get-CimInstance

$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H

Get-Help は、ヘルプ トピックの完全なバージョンを Get-CimInstance 取得し、変数に $H 格納します。 InputObject パラメーターは、次の値$HOut-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

任意のオブジェクトをこのコマンドレットにパイプできます。

出力

None

このコマンドレットは、出力を返しません。

メモ

Windows PowerShell には、次のエイリアスが Out-Printer含まれています。

  • lp

動詞を含むコマンドレットは、オブジェクトの書式を Out 設定しません。 単にレンダリングし、指定された表示先に送信します。 書式設定されていないオブジェクトをコマンドレットに Out 送信すると、そのオブジェクトをレンダリングする前に、そのオブジェクトが書式設定コマンドレットに送信されます。

Out-Printer はプリンターにデータを送信しますが、パイプラインに出力オブジェクトを出力しません。 出力をOut-PrinterGet-Memberパイプする場合は、Get-Memberオブジェクトが指定されていないことを報告します。