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-Content
Pobiera 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
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-Member
elementu , Get-Member
raporty, że nie określono żadnych obiektów.