Freigeben über

Out-Printer

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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, sofern angegeben. Da das Cmdlet keine Möglichkeit hat, den Druckauftrag zu konfigurieren, verwendet der resultierende Druckauftrag die für den Drucker definierten Standardeinstellungen.

Hinweis

Dieses Cmdlet wurde in PowerShell 7 wieder 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 vorhanden ist.

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

Get-Contentruft den Inhalt der readme.txt Datei im aktuellen Verzeichnis ab und leitet ihn an weiter, Out-Printerwodurch er an den Standarddrucker gesendet wird.

Beispiel 2: Drucken einer Zeichenfolge auf einem Remotedrucker

In diesem Beispiel wird Hello, World auf dem Drucker Prt-6B Color auf Server01 gedruckt.

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

Der Parameter Name wählt einen bestimmten Drucker anstelle des Standardwerts aus.

Beispiel 3: Drucken eines Hilfethemas auf dem Standarddrucker

In diesem Beispiel wird die Vollversion des Hilfethemas für Get-CimInstanceausgegeben.

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

Get-Help ruft die Vollversion des Hilfethemas für Get-CimInstance ab 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 Name ist optional.

Type:String
Aliases:PrinterName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSObject

Sie können jedes Objekt an dieses Cmdlet übergeben.

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 es das Cmdlet vor dem Rendern an ein Formatierungs-Cmdlet.

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übergeben, meldet, Get-Member dass keine -Objekte angegeben wurden.