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.