Delen via


Out-Printer

Hiermee wordt uitvoer verzonden naar een printer.

Syntaxis

Default (Standaard)

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Out-Printer cmdlet verzendt uitvoer naar de standaardprinter of naar een alternatieve printer, als er een is opgegeven. Omdat de cmdlet geen manier heeft om de afdruktaak te configureren, gebruikt de resulterende afdruktaak de standaardinstellingen die voor de printer zijn gedefinieerd.

Opmerking

Deze cmdlet is opnieuw geïntroduceerd in PowerShell 7. Deze cmdlet is alleen beschikbaar op Windows-systemen die ondersteuning bieden voor het Windows-bureaublad.

Voorbeelden

Voorbeeld 1: Een bestand verzenden dat moet worden afgedrukt op de standaardprinter

In dit voorbeeld ziet u hoe u een bestand afdrukt, ook al heeft Out-Printer geen pad parameter.

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

Get-Contentde inhoud van het readme.txt-bestand in de huidige map ophaalt en doorstuurt naar Out-Printer, waardoor het naar de standaardprinter wordt verzonden.

Voorbeeld 2: Een tekenreeks afdrukken naar een externe printer

In dit voorbeeld wordt Hello, World afgedrukt op de Prt-6B Color printer op Server01.

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

De parameter Name selecteert een specifieke printer in plaats van de standaardwaarde.

Voorbeeld 3: Een Help-onderwerp afdrukken naar de standaardprinter

In dit voorbeeld wordt de volledige versie van het Help-onderwerp voor Get-CimInstanceafgedrukt.

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

Get-Help krijgt de volledige versie van het Help-onderwerp voor Get-CimInstance en slaat deze op in de variabele $H. De parameter InputObject geeft de waarde van $H door 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 wordt de uitvoer verzonden naar de opgegeven 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 deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

De cmdlets die het werkwoord Out bevatten, maken geen objecten op. 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.

Out-Printer gegevens naar de printer verzendt, maar geen uitvoerobjecten naar de pijplijn verzendt. Als u de uitvoer van Out-Printer doorgeeft aan Get-Member, Get-Member rapporteert dat er geen objecten zijn opgegeven.