Get-MultipartFile

Ü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.