Out-Printer

Wysyła dane wyjściowe do drukarki.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie Out-Printer cmdlet wysyła dane wyjściowe do drukarki domyślnej lub do drukarki alternatywnej, jeśli jest określona. Ponieważ polecenie cmdlet nie ma możliwości skonfigurowania zadania drukowania, wynikowe zadanie drukowania używa domyślnych ustawień zdefiniowanych dla drukarki.

Uwaga

To polecenie cmdlet zostało ponownie wprowadzone w programie PowerShell 7. To polecenie cmdlet jest dostępne tylko w systemach Windows, które obsługują program Windows Desktop.

Przykłady

Przykład 1 — wysyłanie pliku do wydrukowania na drukarce domyślnej

W tym przykładzie pokazano, jak wydrukować plik, mimo że Out-Printer nie ma parametru Path .

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

Get-ContentPobiera zawartość readme.txt pliku w bieżącym katalogu i potokuje go do Out-Printer, który wysyła go do drukarki domyślnej.

Przykład 2. Drukowanie ciągu do drukarki zdalnej

W tym przykładzie drukarka Prt-6B Color jest drukowana Hello, World na serwerze Server01.

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

Parametr Name wybiera określoną drukarkę, a nie domyślną.

Przykład 3 — drukowanie tematu pomocy do drukarki domyślnej

W tym przykładzie jest drukowana pełna wersja tematu Pomocy dla elementu Get-CimInstance.

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

Get-Help Pobiera pełną wersję tematu Pomocy dla Get-CimInstance zmiennej i zapisuje ją w zmiennej $H . Parametr InputObject przekazuje wartość $H do Out-Printer.

Parametry

-InputObject

Określa obiekty, które mają być wysyłane do drukarki. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Wysyła dane wyjściowe do określonej drukarki. Nazwa parametru jest opcjonalna.

Type:String
Aliases:PrinterName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

PSObject

Do tego polecenia cmdlet można przekazać dowolny obiekt.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach windows.

Polecenia cmdlet zawierające Out czasownik nie formatują obiektów. Po prostu renderują je i wysyłają je do określonego miejsca docelowego wyświetlania. Jeśli wyślesz niesformatowany obiekt do Out polecenia cmdlet, polecenie cmdlet wyśle go do polecenia cmdlet formatowania przed jego renderowaniem.

Out-Printer wysyła dane do drukarki, ale nie emituje żadnych obiektów wyjściowych do potoku. Jeśli przesyłasz dane wyjściowe Out-Printer do Get-Memberelementu , Get-Member raporty, że nie określono żadnych obiektów.