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 パラメーターは、次の値$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 |
入力
任意のオブジェクトをこのコマンドレットにパイプできます。
出力
None
このコマンドレットは、出力を返しません。
メモ
Windows PowerShell には、次のエイリアスが Out-Printer
含まれています。
lp
動詞を含むコマンドレットは、オブジェクトの書式を Out
設定しません。 単にレンダリングし、指定された表示先に送信します。 書式設定されていないオブジェクトをコマンドレットに Out
送信すると、そのオブジェクトをレンダリングする前に、そのオブジェクトが書式設定コマンドレットに送信されます。
Out-Printer
はプリンターにデータを送信しますが、パイプラインに出力オブジェクトを出力しません。 出力をOut-Printer
Get-Member
パイプする場合は、Get-Member
オブジェクトが指定されていないことを報告します。
関連リンク
PowerShell