Delen via

Out-Printer

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee wordt uitvoer verzonden naar een printer.

Syntaxis

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

De out-printer cmdlet verzendt uitvoer naar de standaardprinter of naar een alternatieve printer, indien opgegeven.

Voorbeelden

Voorbeeld 1: De inhoud van een Help-onderwerp afdrukken naar de standaardprinter

PS C:\> Get-Content $pshome\about_signing.help.txt | Out-Printer

Met deze opdracht wordt de inhoud van het help-onderwerp about_Signing afgedrukt naar de standaardprinter. In dit voorbeeld ziet u hoe u een bestand afdrukt, ook al heeft out-printer- geen parameter Path.

De opdracht maakt gebruik van de Get-Content cmdlet om de inhoud van het Help-onderwerp op te halen. Het pad bevat $pshome, een ingebouwde variabele waarin de installatiemap voor Windows PowerShell wordt opgeslagen. Een pijplijnoperator (|) geeft de resultaten door aan out-printer, waardoor deze naar de standaardprinter wordt verzonden.

Voorbeeld 2: Tekst afdrukken naar een alternatieve printer

PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Met deze opdracht drukt u Hello, World af op de Printer Prt-6B Color op Server01. Met deze opdracht wordt de parameter Name gebruikt om de alternatieve printer op te geven. Omdat de parameternaam optioneel is, kunt u deze weglaten.

Voorbeeld 3: de volledige versie van een Help-onderwerp afdrukken op de standaardprinter

PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> Out-Printer -InputObject $H

Met deze opdrachten wordt de volledige versie van het Help-onderwerp voor Get-WmiObject afgedrukt. De eerste opdracht maakt gebruik van de cmdlet Get-Help om de volledige versie van het Help-onderwerp voor Get-WmiObject op te halen en op te slaan in de variabele $H. Met de tweede opdracht wordt de inhoud naar de standaardprinter verzonden. De parameter InputObject wordt gebruikt om de waarde van de variabele $H door te geven aan out-printer-.

Parameters

-InputObject

Hiermee geeft u de objecten die naar de printer moeten worden verzonden. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

Type:PSObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de alternatieve printer. De parameternaam Name is optioneel.

Type:String
Aliassen:PrinterName
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar out-printer.

Uitvoerwaarden

None

out-printer geen objecten retourneert.

Notities

  • U kunt ook verwijzen naar out-printer door de ingebouwde alias, lp. Zie about_Aliases voor meer informatie.

    De cmdlets die de Out-werkwoord bevatten, formatteren geen objecten; ze geven ze gewoon weer en verzenden ze naar de opgegeven weergavebestemming. Als u een niet-opgemaakt object naar een Out-cmdlet verzendt, verzendt de cmdlet het naar een opmaak-cmdlet voordat u het weergeeft.

    De Out-cmdlets hebben geen parameters voor namen of bestandspaden. Als u gegevens naar een Out-cmdlet wilt verzenden, gebruikt u een pijplijnoperator (|) om de uitvoer van een Windows PowerShell-opdracht naar de cmdlet te verzenden. U kunt ook gegevens opslaan in een variabele en de parameter InputObject gebruiken om de gegevens door te geven aan de cmdlet. Zie de voorbeelden voor meer informatie.

    out-printer gegevens verzendt, maar er worden geen uitvoerobjecten verzonden. Als u de uitvoer van Out-Printer- doorsluist naar Get-Member, Get-Member rapporteert dat er geen objecten zijn opgegeven.