Out-Printer
Sendet die Ausgabe an einen Drucker.
Syntax
Default (Standard)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Out-Printer sendet die Ausgabe an den Standarddrucker oder an einen alternativen Drucker, sofern angegeben. Da das Cmdlet keine Möglichkeit zum Konfigurieren des Druckauftrags hat, verwendet der resultierende Druckauftrag die für den Drucker definierten Standardeinstellungen.
Hinweis
Dieses Cmdlet wurde in PowerShell 7 erneut eingeführt. Dieses Cmdlet ist nur auf Windows-Systemen verfügbar, die den Windows-Desktop unterstützen.
Beispiele
Beispiel 1 : Senden einer Datei, die auf dem Standarddrucker gedruckt werden soll
In diesem Beispiel wird gezeigt, wie eine Datei gedruckt wird, obwohl Out-Printer keinen Path Parameter enthält.
Get-Content -Path ./readme.txt | Out-Printer
Get-Contentruft den Inhalt der readme.txt Datei im aktuellen Verzeichnis ab und leitet sie an Out-Printerweiter, wodurch sie an den Standarddrucker gesendet wird.
Beispiel 2: Drucken einer Zeichenfolge auf einem Remotedrucker
In diesem Beispiel wird Hello, World auf dem Prt-6B Color Drucker auf Server01 gedruckt.
"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Der parameter Name wählt anstelle der Standardeinstellung einen bestimmten Drucker aus.
Beispiel 3 : Drucken eines Hilfethemas auf den Standarddrucker
In diesem Beispiel wird die Vollversion des Hilfethemas für Get-CimInstancegedruckt.
$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H
Get-Help ruft die Vollversion des Hilfethemas für Get-CimInstance ab und speichert sie in der variablen $H. Der parameter InputObject übergibt den Wert $H an Out-Printer.
Parameter
-InputObject
Gibt die Objekte an, die an den Drucker gesendet werden sollen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte ermittelt.
Parametereigenschaften
| Typ: | PSObject |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Sendet die Ausgabe an den angegebenen Drucker. Der Parametername Name ist optional.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | PrinterName |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
PSObject
Sie können jedes Objekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Out-Printer:
lp
Die Cmdlets, die das verb Out enthalten, formatieren keine Objekte. Sie rendern sie einfach und senden sie an das angegebene Anzeigeziel. Wenn Sie ein unformatiertes Objekt an ein Out-Cmdlet senden, sendet das Cmdlet es an ein Formatierungs-Cmdlet, bevor es gerendert wird.
Out-Printer Sendet Daten an den Drucker, gibt jedoch keine Ausgabeobjekte an die Pipeline aus. Wenn Sie die Ausgabe von Out-Printer an Get-Memberweitergeleitet haben, Get-Member meldet, dass keine Objekte angegeben wurden.
