Send-TextResponse #

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

ÜBERSICHT #

Sendet eine Textantwort mit einem HTTP-Statuscode über einen HttpListener.

SYNTAX #

Send-TextResponse [[-Response] <System.Net.HttpListenerResponse>] [[-StatusCode] <int>] [[-Text]
    <string>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion vereinfacht die Ausgabe einer Textnachricht als HTTP-Response mit frei wählbarem Statuscode und UTF-8-Codierung. Typische Einsatzbereiche sind einfache Statusmeldungen oder Fehlermeldungen im Rahmen eines PowerShell-Mini-Webservers.

PARAMETER #

-Response #

Type: System.Net.HttpListenerResponse

Das HttpListenerResponse-Objekt, über das die Antwort gesendet wird.

-StatusCode #

Type: int

Der HTTP-Statuscode, z. B. 200 (OK), 400 (Bad Request), oder 500 (Internal Server Error).

-Text #

Type: string

Die Nachricht, die an den Client zurückgegeben wird (UTF-8).

AUSGABEN #

void

Sendet die Antwort direkt an den Client; kein Rückgabewert.

BEISPIELE #

Send-TextResponse -Response $response -StatusCode 200 -Text "Operation erfolgreich."

HINWEISE #

• Ideal für schnelle und einfache HTTP-Rückmeldungen in einem Mini-Webserver.
• Schließt automatisch den Stream und die Response.