Delen via

Out-Printer

Module:
Microsoft.PowerShell.Utility Module

Hiermee wordt uitvoer verzonden naar een printer.

Syntax

Default (Standaard) 

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

Specificeert 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.

Parametereigenschappen

Type:PSObject
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Printernaam

Parametersets

(All)
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.