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 anderen Drucker, sofern ein solcher angegeben ist.
Beispiele
Beispiel 1
Get-Content $pshome\about_signing.help.txt | Out-Printer
Mit diesem Befehl wird der Inhalt des Hilfethemas about_Signing auf den Standarddrucker gedruckt. In diesem Beispiel wird gezeigt, wie Sie eine Datei drucken, obwohl Out-Printer keinen Path-Parameter enthält.
Der Befehl verwendet das Cmdlet Get-Content, um den Inhalt des Hilfethemas abzurufen. Der Pfad enthält $pshome, eine integrierte Variable, die das Installationsverzeichnis für Windows PowerShell speichert. Ein Pipelineoperator (|) übergibt die Ergebnisse an Out-Printer, der sie an den Standarddrucker sendet.
Beispiel 2
"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Mit diesem Befehl wird "Hello, World" auf dem Drucker "Prt-6B Color" auf Server01 ausgegeben. Mit diesem Befehl wird der Parameter Name verwendet, um den alternativen Drucker anzugeben. Da der Parametername optional ist, können Sie ihn weglassen.
Beispiel 3
$h = Get-Help -Full get-wmiobject
Out-Printer -InputObject $h
Diese Befehle drucken die Vollversion des Hilfethemas für Get-WmiObject. Der erste Befehl verwendet das Cmdlet Get-Help, um die Vollversion des Hilfethemas für Get-WmiObject abzurufen und in der Variablen $h zu speichern. Der zweite Befehl sendet den Inhalt an den Standarddrucker. Er verwendet den InputObject-Parameter, um den Wert der Variablen $h an Out-Printer zu übergeben.
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
Gibt den alternativen Drucker an. Der Parametername ("Name") ist optional.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | PrinterName |
Parametersätze
(All)
| Position: | 1 |
| 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 über die Pipeline an Out-Printer übergeben.
Ausgaben
None
Out-Printer gibt keine Objekte zurück.
Hinweise
Sie können sich auch über den integrierten Alias "lp" auf Out-Printer beziehen. Weitere Informationen finden Sie unter about_Aliases.
Die Cmdlets, die das Out-Verb enthalten (die Out-Cmdlets), 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.
Die Cmdlets "Out" verfügen nicht über Parameter für Namen oder Dateipfade. Verwenden Sie zum Senden von Daten an ein Out-Cmdlet einen Pipelineoperator (|), um die Ausgabe eines Windows PowerShell-Befehls an das Cmdlet zu senden. Sie können Daten auch in einer Variablen speichern und den InputObject-Parameter verwenden, um die Daten an das Cmdlet zu übergeben. Weitere Informationen finden Sie in den Beispielen.
Out-Printer sendet Daten, gibt jedoch keine Ausgabeobjekte aus.