Get Multipart File
Zuletzt geändert: 14.03.2026 05:56

Get-MultipartFile #

Intern – Diese Funktion ist nicht exportiert und nur modulintern verfügbar.

ÜBERSICHT #

Extrahiert Dateien aus HTTP-Multipart-Requests, wie sie beispielsweise beim Hochladen per Webformular übertragen werden.

SYNTAX #

Get-MultipartFile [[-BodyBytes] <byte[]>] [[-ContentType] <string>] [[-FieldName] <string>]
    [<CommonParameters>]

BESCHREIBUNG #

Get-MultipartFile verarbeitet den Byte-Stream eines HTTP-Request-Bodys im Multipart-Format. Sie extrahiert dabei eine spezifische Datei, die im Request-Body enthalten ist, anhand des angegebenen Feldnamens (z. B. „file“).

Unterstützte Features:

  • Extrahieren des Dateiinhalts als Byte-Array.
  • Automatische Erkennung von Text-Encodings (UTF-8, Windows-1252 u.a.).
  • Unterstützung sowohl für Text- als auch Binärdaten.
  • Extrahieren des ursprünglichen Dateinamens (optional).

PARAMETER #

-BodyBytes #

Type: byte[]

Byte-Array des vollständigen HTTP-Multipart-Request-Bodys.

-ContentType #

Type: string

HTTP-Content-Type-Header des Requests. Typischerweise im Format: ‘multipart/form-data; boundary=XYZ’

-FieldName #

Type: string
Default: 'file'

Der Name des Feldes im Multipart-Request, welches die zu extrahierende Datei enthält. Standard ist ‘file’.

AUSGABEN #

hashtable
  • FileName: Originalname der hochgeladenen Datei (falls angegeben) - Content: Byte-Array der Datei-Inhalte (UTF-8 bei Text-Daten)

BEISPIELE #

$uploadData = Get-MultipartFile -BodyBytes $reqBodyBytes `
                                -ContentType $req.ContentType `
                                -FieldName 'uploadedFile'

Verarbeitet den Request-Body und extrahiert die Datei aus dem Feld 'uploadedFile'.

HINWEISE #

  • Die Funktion wirft eine Ausnahme, falls keine gültige Datei unter dem angegebenen Feldnamen gefunden wird.
  • Geeignet zur Verarbeitung von Datei-Uploads in selbstgebauten HTTP-Listenern oder Mini-Webservern in PowerShell.