Out-Printer

Sendet die Ausgabe an einen Drucker.

Syntax

Default (Standard)

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.

Note

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-Contentruft 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 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 ist optional.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:"Druckername"

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

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 an < a0/> weitergeleitet haben, wird berichtet, dass keine Objekte angegeben wurden.