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