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 `pdf` innerhalb 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.