Sdílet prostřednictvím

Out-Printer

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odešle výstup do tiskárny.

Syntaxe

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Out-Printer odešle výstup do výchozí tiskárny nebo do alternativní tiskárny, pokud je zadána. Vzhledem k tomu, že rutina nemá žádný způsob konfigurace tiskové úlohy, použije výsledná tisková úloha výchozí nastavení definovaná pro tiskárnu.

Poznámka

Tato rutina byla znovu vyvolána v PowerShellu 7. Tato rutina je dostupná jenom v systémech Windows, které podporují Windows Desktop.

Příklady

Příklad 1 – Odeslání souboru, který se má vytisknout na výchozí tiskárně

Tento příklad ukazuje, jak vytisknout soubor, i když Out-Printer nemá parametr Path.

Get-Content -Path ./readme.txt | Out-Printer

Get-Contentzíská obsah souboru readme.txt v aktuálním adresáři a předá ho do Out-Printer, který ho odešle do výchozí tiskárny.

Příklad 2: Tisk řetězce na vzdálenou tiskárnu

Tento příklad vytiskne Hello, World na tiskárnu Prt-6B Color na serveru Server01.

"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Parametr Name vybere místo výchozí tiskárny konkrétní tiskárnu.

Příklad 3 – Tisk tématu nápovědy na výchozí tiskárnu

Tento příklad vytiskne úplnou verzi tématu nápovědy pro Get-CimInstance.

$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H

Get-Help získá úplnou verzi tématu nápovědy pro Get-CimInstance a uloží ji do proměnné $H. Parametr InputObject předá hodnotu $HOut-Printer.

Parametry

-InputObject

Určuje objekty, které se mají odeslat do tiskárny. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá.

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Odešle výstup na zadanou tiskárnu. Název parametru Název je volitelný.

Typ:String
Aliasy:PrinterName
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Do této rutiny můžete převést libovolný objekt.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Tato rutina je dostupná jenom na platformách Windows.

Rutiny, které obsahují příkaz Out, neformátují objekty. Jednoduše je vykreslují a posílají do zadaného cíle zobrazení. Pokud do rutiny Out odešlete neformátovaný objekt, rutina ho před vykreslením odešle do rutiny formátování.

Out-Printer odesílá data do tiskárny, ale nevygeneruje do kanálu žádné výstupní objekty. Pokud předáte výstup Out-Printer do Get-Member, Get-Member sestavy, že nebyly zadány žádné objekty.