Out-Printer
Sendet die Ausgabe an einen Drucker.
Syntax
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das Out-Printer
Cmdlet sendet die Ausgabe an den Standarddrucker oder an einen alternativen Drucker, falls 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
kein Path-Parameter enthalten ist.
Get-Content -Path ./readme.txt | Out-Printer
Get-Content
ruft den Inhalt der readme.txt
Datei im aktuellen Verzeichnis ab und leitet sie an Out-Printer
, die sie an den Standarddrucker sendet.
Beispiel 2: Drucken einer Zeichenfolge auf einem Remotedrucker
In diesem Beispiel wird Hello, World
der Prt-6B-Farbdrucker auf Server01 gedruckt.
"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Der Parameter Name wählt einen bestimmten Drucker anstelle der Standardeinstellung aus.
Beispiel 3 : Drucken eines Hilfethemas auf den Standarddrucker
In diesem Beispiel wird die Vollversion des Hilfethemas für Get-CimInstance
.
$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H
Get-Help
ruft die Vollversion des Hilfethemas ab Get-CimInstance
und speichert es in der $H
Variablen. Der InputObject-Parameter übergibt den Wert von $H
an Out-Printer
.
Parameter
-InputObject
Gibt die an den Drucker zu sendenden Objekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Sendet die Ausgabe an den angegebenen Drucker. Der Parametername ist optional.
Type: | String |
Aliases: | PrinterName |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können jedes Objekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Die Cmdlets, die das Out
Verb 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-Member
< a0/> weitergeleitet haben, Get-Member
wird berichtet, dass keine Objekte angegeben wurden.