Out-Printer
プリンターに出力を送信します。
構文
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
コマンドレットは Out-Printer
、既定のプリンターまたは代替プリンター (指定されている場合) に出力を送信します。
注意
このコマンドレットは、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 |
入力
任意のオブジェクトを に Out-Printer
パイプできます。
出力
None
Out-Printer
はオブジェクトを返しません。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
動詞を含むコマンドレットは、オブジェクトの Out
書式を設定しません。 レンダリングして、指定した表示先に送信するだけです。 書式設定されていないオブジェクトをコマンドレットに Out
送信すると、そのオブジェクトをレンダリングする前に、そのオブジェクトが書式設定コマンドレットに送信されます。
Out-Printer
はプリンターにデータを送信しますが、パイプラインに出力オブジェクトを出力しません。 のOut-Printer
出力を にGet-Member
Get-Member
パイプすると、オブジェクトが指定されていないことが報告されます。