Out-Printer
プリンターに出力を送信します。
構文
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Out-Printer
コマンドレットは、既定のプリンターまたは代替プリンター (指定されている場合) に出力を送信します。 このコマンドレットには印刷ジョブを構成する方法がないため、結果の印刷ジョブではプリンターに対して定義されている既定の設定が使用されます。
手記
このコマンドレットは、PowerShell 7 で再導入されました。 このコマンドレットは、Windows デスクトップをサポートする Windows システムでのみ使用できます。
例
例 1 - 既定のプリンターに印刷するファイルを送信する
この例では、Out-Printer
に Path パラメーターがない場合でも、ファイルを印刷する方法を示します。
Get-Content -Path ./readme.txt | Out-Printer
Get-Content
現在のディレクトリ内の readme.txt
ファイルの内容を取得し、それを Out-Printer
にパイプして、既定のプリンターに送信します。
例 2: リモート プリンターに文字列を印刷する
次の使用例は、Hello, World
を Server01 の Prt-6B Color プリンターに印刷します。
"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
名 パラメーターは、既定ではなく、特定のプリンターを選択します。
例 3 - ヘルプ トピックを既定のプリンターに印刷する
次の使用例は、Get-CimInstance
のヘルプ トピックの完全なバージョンを出力します。
$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H
Get-Help
は、Get-CimInstance
のヘルプ トピックの完全なバージョンを取得し、$H
変数に格納します。
InputObject パラメーターは、$H
の値を Out-Printer
に渡します。
パラメーター
-InputObject
プリンターに送信するオブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。
型: | PSObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
指定したプリンターに出力を送信します。 パラメーター名 名前 は省略可能です。
型: | String |
Aliases: | PrinterName |
配置: | 0 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
任意のオブジェクトをこのコマンドレットにパイプできます。
出力
None
このコマンドレットは出力を返しません。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Out
動詞を含むコマンドレットは、オブジェクトの書式を設定しません。 単にレンダリングし、指定された表示先に送信します。 書式設定されていないオブジェクトを Out
コマンドレットに送信すると、そのオブジェクトをレンダリングする前に、そのオブジェクトが書式設定コマンドレットに送信されます。
Out-Printer
はプリンターにデータを送信しますが、パイプラインに出力オブジェクトを出力しません。
Out-Printer
の出力をパイプ処理して Get-Member
すると、オブジェクトが指定されていないことを報告 Get-Member
。
関連リンク
PowerShell