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.
Beispiele
Beispiel 1: Drucken des Inhalts eines Hilfethemas auf den Standarddrucker
PS C:\> 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, auch wenn 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: Drucken von Text auf einem alternativen Drucker
PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Mit diesem Befehl wird "Hello, World" auf dem Prt-6B-Farbdrucker auf Server01 gedruckt. Dieser Befehl verwendet den parameter Name, um den alternativen Drucker anzugeben. Da der Parametername optional ist, können Sie ihn weglassen.
Beispiel 3: Drucken der Vollversion eines Hilfethemas auf den Standarddrucker
PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> 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: | 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 Out-Printer-pfeifen.
Ausgaben
None
Out-Printer- gibt keine Objekte zurück.
Hinweise
Sie können auch auf Out-Printer durch den integrierten Alias lpverweisen. Weitere Informationen finden Sie unter about_Aliases.
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.
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 parameter InputObject 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. Wenn Sie die Ausgabe von Out-Printer an "Get-Member" senden, "Get-Member"- Berichte, dass keine Objekte angegeben wurden.