Out-Printer
プリンターに出力を送信します。
構文
Default (既定)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Out-Printer コマンドレットは、既定のプリンターまたは代替プリンター (指定されている場合) に出力を送信します。 このコマンドレットには印刷ジョブを構成する方法がないため、結果の印刷ジョブではプリンターに対して定義されている既定の設定が使用されます。
Note
このコマンドレットは、PowerShell 7 で再導入されました。 このコマンドレットは、Windows Desktop をサポートするWindows システムでのみ使用できます。
例
例 1 - 既定のプリンターに印刷するファイルを送信する
この例では、Out-Printerに Path パラメーターがない場合でも、ファイルを印刷する方法を示します。
Get-Content -Path ./readme.txt | Out-Printer
Get-Contentは、現在のディレクトリ内の readme.txt ファイルの内容を取得し、それを Out-Printerにパイプして、既定のプリンターに送信します。
例 2: リモート プリンターに文字列を印刷する
次の使用例は、 Hello, World を Server01 の Prt-6B カラー プリンターに印刷します。
"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
プリンターに送信するオブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。
パラメーターのプロパティ
| 型: | PSObject |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
指定したプリンターに出力を送信します。 パラメーター名 Name は省略可能です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| エイリアス: | PrinterName |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。
入力
PSObject
任意のオブジェクトをこのコマンドレットにパイプできます。
出力
None
このコマンドレットは出力を返しません。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Out動詞を含むコマンドレットは、オブジェクトの書式を設定しません。 単にレンダリングし、指定された表示先に送信します。 書式設定されていないオブジェクトを Out コマンドレットに送信すると、そのオブジェクトをレンダリングする前に書式設定コマンドレットに送信されます。
Out-Printer はプリンターにデータを送信しますが、パイプラインに出力オブジェクトを出力しません。
Out-Printerの出力をパイプ処理してGet-Memberすると、オブジェクトが指定されていないことGet-Member報告されます。