Convert-HtmlToPdf #

ÜBERSICHT #

Konvertiert eine lokale HTML-Datei headless in eine PDF-Datei (Chrome, Edge oder Firefox).

SYNTAX #

Convert-HtmlToPdf [-Path] <string> [[-OutFile] <string>] [[-Engine] <string>] [-PageInfo] [-Show]
    [-PassThru] [<CommonParameters>]

BESCHREIBUNG #

Standard ist Auto-Erkennung in der Reihenfolge Chrome → Edge → Firefox. Mit -Engine kann eine Engine erzwungen werden. Ist die erzwungene Engine nicht vorhanden, erfolgt eine Warnung (mit Dateiname in einfachen Hochkommas) und es wird kein PDF erstellt. Firefox wird intern über Convert-HtmlToPdfWithFirefox angebunden und nutzt ausschließlich den modul-eigenen geckodriver im Ordner ‘pdf'.

PARAMETER #

-Path #

Type: string

Der Pflichtparameter ist der Pfad zur HTML-Datei, die in PDF konvertiert werden soll, welche relativ oder absolut angegeben werden kann.

-OutFile #

Type: string

Optionaler Zielpfad der PDF. Wenn leer, wird .pdf neben der HTML-Datei geschrieben.

-Engine #

Type: string
Default: 'Auto'

Auto (Default), Chrome, Edge oder Firefox.

-PageInfo #

Type: switch

Bei Chrome/Edge: Kopf-/Fußzeile drucken (ohne Switch = keine Header/Footer).

-Show #

Type: switch

Öffnet die erzeugte PDF-Datei nach der Konvertierung automatisch mit dem im Betriebssystem hinterlegten PDF-Viewer.

-PassThru #

Type: switch

Gibt bei Erfolg den PDF-Pfad (string) zurück statt [bool].

AUSGABEN #

bool (Default) oder string (bei -PassThru)

BEISPIELE #

# Konvertiert eine HTML-Datei in PDF und öffnet sie anschließend im PDF-Viewer.
Convert-HtmlToPdf -Path "C:\Reports\report.html" -Show