プリンターに出力を送ります。
構文
Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]
説明
Out-Printer コマンドレットは、既定のプリンター、または代替プリンターが指定されている場合にはその代替プリンターに出力を送ります。
パラメーター
-InputObject <psobject>
プリンターに送るオブジェクトを指定します。オブジェクトが格納されている変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。
|
必須 |
false |
|
位置 |
named |
|
既定値 |
|
|
パイプライン入力を許可する |
true (ByValue) |
|
ワイルドカード文字を許可する |
false |
-Name <string>
代替プリンターを指定します。パラメーター名 ("Name") は省略可能です。
|
必須 |
false |
|
位置 |
1 |
|
既定値 |
|
|
パイプライン入力を許可する |
false |
|
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.
入力と出力
入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。
|
入力 |
System.Management.Automation.PSObject パイプを使用して、あらゆるオブジェクトを Out-Printer に渡すことができます。 |
|
出力 |
なし Out-Printer はオブジェクトを返しません。 |
注
Out-Printer は、その組み込みエイリアスである "lp" で参照することもできます。詳細については、「about_Aliases」を参照してください。
Out という動詞を含むコマンドレット (Out コマンドレット) はオブジェクトを書式設定しません。オブジェクトをレンダリングし、指定された表示先に送るだけです。書式設定されていないオブジェクトを Out コマンドレットに送ると、Out コマンドレットはこのオブジェクトをレンダリングする前に書式設定用コマンドレットに送ります。
Out コマンドレットには、名前またはファイル パス用のパラメーターがありません。Out コマンドレットにデータを送るには、Windows PowerShell コマンドの出力をコマンドレットに送るパイプライン演算子 (|) を使用します。InputObject パラメーターを使用すると、変数に保存したデータをコマンドレットに渡すこともできます。詳細については、例を参照してください。
Out-Printer はデータを送りますが、出力オブジェクトは作成しません。パイプを使用して Out-Printer の出力を Get-Member に渡すと、Get-Member はオブジェクトが指定されていないと報告します。
例 1
C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer 説明 ----------- このコマンドは、「about_Signing」 のヘルプ トピックの内容を既定のプリンターで印刷します。この例は、Path パラメーターがない Out-Printer でファイルを印刷する方法を示しています。 このコマンドは、Get-Content コマンドレットを使用してヘルプ トピックの内容を取得します。パスには、Windows PowerShell のインストール ディレクトリを保存している $pshome 組み込み変数が使用されています。結果はパイプライン演算子 (|) によって Out-Printer に渡され、既定のプリンターに送られます。
例 2
C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color" 説明 ----------- このコマンドにより、Server01 の "Prt-6B Color" プリンターで "Hello, World" と印刷されます。このコマンドは、Name パラメーターを使用して代替プリンターを指定します。パラメーター名はオプションであるため、省略できます。
例 3
C:\PS>$h = get-help -full get-wmiobject C:\PS> out-printer -inputobject $h 説明 ----------- これらのコマンドは、Get-WmiObject の完全版ヘルプ トピックを印刷します。最初のコマンドは、Get-Help コマンドレットを使用して Get-WmiObject の完全版ヘルプ トピックを取得し、$h 変数に保存します。2 番目のコマンドは、$h 変数の内容を既定のプリンターに送ります。InputObject パラメーターを使用して Out-Printer に $h 変数の内容を渡します。
関連項目