Udostępnij za pośrednictwem

Out-Printer

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

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

Nuta

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 Ścieżka.

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

Get-Contentpobiera zawartość pliku readme.txt 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 Hello, World drukarki Prt-6B Color na serwerze Server01.

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

Parametr Nazwa 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 Get-CimInstance.

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

Get-Help pobiera pełną wersję tematu Pomocy dla Get-CimInstance i zapisuje go 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.

Typ:PSObject
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String
Aliasy:PrinterName
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 czasownik Out nie formatują obiektów. Po prostu renderują je i wysyłają je do określonego miejsca docelowego wyświetlania. Jeśli wysyłasz niesformatowany obiekt do polecenia cmdlet Out, polecenie cmdlet wysyła je do polecenia cmdlet formatowania przed jego renderowaniem.

Out-Printer wysyła dane do drukarki, ale nie emituje żadnych obiektów wyjściowych do potoku. W przypadku potoku danych wyjściowych Out-Printer do Get-MemberGet-Member raportów, że nie określono żadnych obiektów.