Send-PdfToPrinter #
ÜBERSICHT #
Sendet eine PDF-Datei an einen Drucker über SumatraPDF.exe (wenn vorhanden) oder PdfXTools.exe (standard).
SYNTAX #
Send-PdfToPrinter [-Path] <string> [[-Printer] <string>] [[-Duplex] <string>] [[-Engine] <string>]
[<CommonParameters>]
BESCHREIBUNG #
Diese Funktion prüft zuerst, ob sich im Modul-Unterordner pdf die Datei SumatraPDF.exe befindet. Wenn ja, wird diese bevorzugt verwendet, andernfalls PdfXTools.exe.
Über den Parameter Engine kann explizit gesteuert werden, welche Engine verwendet werden soll.
- “Sumatra”: Verwendet SumatraPDF (Fehler, wenn nicht vorhanden)
- “XTools” : Verwendet PdfXTools (auch wenn Sumatra vorhanden ist)
- kein Wert: Sumatra hat Vorrang, falls vorhanden.
Unterstützt optionale Parameter für Druckername und Duplexdruck. Die Duplexwerte werden intern für die jeweilige Engine (Sumatra oder PdfXTools) angepasst.
Rückgabe ist $true bei Erfolg (ExitCode = 0), $false bei Fehler
PARAMETER #
-Path #
Type: string
Pfad zur PDF-Datei (absolut oder relativ).
-Printer #
Type: string
Optional: Name des Druckers. Wird kein Name angegeben, wird der Standarddrucker verwendet.
-Duplex #
Type: string
Optional: Gibt den Duplexmodus an. Zulässige Werte:
- none (kein Duplex),
- vertical (lange Kante),
- horizontal (kurze Kante) Bei fehlendem Duplex-Parameter wird der Default des Druckers verwendet.
-Engine #
Type: string
Optional: Gibt die zu verwendende Druckengine an.
- “Sumatra”: Nutzt SumatraPDF, wenn vorhanden. Fehler, wenn nicht vorhanden.
- “XTools”: Erzwingt PdfXTools.exe, auch wenn Sumatra vorhanden ist.
- Kein Wert (Standard): Wenn Sumatra vorhanden ist, wird dieser verwendet. Sonst PdfXTools.
AUSGABEN #
bool
$true bei Erfolg, $false bei Fehler (z.B. ungültiger Drucker, fehlende Datei, Druckfehler).
BEISPIELE #
# Druckt auf den Standard-Drucker mit der Vorzugs-Engine. Bei Auslieferung ist die PdfXTools.exe.
Send-PdfToPrinter -Path "C:\temp\file.pdf"
# Nutzt die Engine, die vorhanden ist, vorzugsweise SumatraPDF.
Send-PdfToPrinter -Path ".\file.pdf" -Printer "Canon GX6000 series" -Duplex none
# Nutzt die Engine SumatraPDF.exe, wenn diese durch den Anwender zugefügt wurde, ansonste gibt es eine Fehlermeldung.
Send-PdfToPrinter -Path ".\file.pdf" -Printer "Canon GX6000 series" -Duplex none -Engine Sumatra
HINWEISE #
Als Alternative kann auch SumatraPDF anstelle PDFXtools verwendet werden.
- Download:
https://www.sumatrapdfreader.org/ - Das Programm muss in den Ordner
pdfinnerhalb der Modulstruktur abgelegt werden. Das ist beispielsweise:C:\Users\(BENUTZERNAME)Documents\WindowsPowerShell\Modules\EulandaXtools\1.0.3\pdf. - Das Hineinkopieren ist bei jedem Update des Moduls erneut im dazugehörigen Versions-Ordner (hier 1.0.3) durchzuführen.
- Für Sumatra gibt EULANDA Software in keinem Fall Support, es wird lediglich benutztt wenn es an der vorgesehenen Stelle vorhanden ist.