Send-TelegramMessage

ÜBERSICHT

Sendet eine Nachricht über die Telegram Bot API an einen bestimmten Chat.

SYNTAX

Send-TelegramMessage [[-PlainToken] <string>] [[-Token] <securestring>] [[-PathToToken] <string>]
    [-TextMode] <ValidateSet('html', 'markdown')][string> [-Silent] [<CommonParameters>]

BESCHREIBUNG

Die Funktion unterstützt drei Wege zur Übergabe des Telegram-Bot-Tokens:

Klartext per -PlainToken (nur für Tests)
Sicherer SecureString per -Token
Datei mit verschlüsseltem Token (Clixml) per -PathToToken

Wird keiner der Parameter übergeben, wird automatisch versucht, die Datei "$HOME\.eulandaconnect\SecureTelegramToken.xml" zu laden.

Die Funktion gibt `$true` zurück, wenn die Nachricht erfolgreich versendet wurde, andernfalls `$false`. Fehler führen nicht zum Abbruch, sondern erzeugen lediglich eine Warnung (`Write-Warning`).

Die Ausgabe kann mit `-WarningAction SilentlyContinue` unterdrückt werden.

PARAMETER

-PlainToken

Type: string

Das Token als Klartext (nur zu Testzwecken).

-Token

Type: securestring

Ein sicheres SecureString-Token, z. B. aus SecretStore oder anderen sicheren Quellen.

-PathToToken

Type: string

Pfad zu einer Clixml-Datei, die ein SecureString-Token enthält. Diese Datei kann z. B. mit der Funktion `New-SecureProfile` erzeugt werden. Standardmäßig wird dabei der Pfad "$HOME\.eulandaconnect\SecureTelegramToken.xml" verwendet, wenn werde Token noch PlainToken übergeben wurden.

-ChatId

Die Telegram-Chat-ID, an die die Nachricht gesendet werden soll. Z. B. "-123456789".

-Message

Die Nachricht, die gesendet werden soll. Unterstützt Markdown oder HTML-Formatierung.

-TextMode

Type: ValidateSet('html', 'markdown')][string
Default: 'html'

Das Textformat: "html" oder "markdown". Standard ist "html".

-Silent

Type: switch

Wenn gesetzt, wird die Nachricht stumm (ohne Push-Ton) versendet.

AUSGABEN

bool

Die Funktion gibt `$true` zurück, wenn die Nachricht erfolgreich versendet wurde, andernfalls `$false`.

BEISPIELE

# Verwendet automatisch $HOME\.eulandaconnect\SecureTelegramToken.xml
Send-TelegramMessage -ChatId "-123456789" -Message "Test"

# Versendet eine Nachricht mit einem explizit erzeugten SecureString-Token.
$sec = ConvertTo-SecureString "123456:ABC" -AsPlainText -Force
Send-TelegramMessage -Token $sec -ChatId "-123456789" -Message "Hallo"

# Versendet die Message als HTML
Send-TelegramMessage -PlainToken "123456:ABC" -ChatId "-123456789" -Message "<b>Hallo</b>" -TextMode html

# Fehlerausgabe unterdrücken
$ok = Send-TelegramMessage -ChatId "-123456789" -Message "Test" -WarningAction SilentlyContinue
if (-not $ok) { Write-Host "Telegram konnte nicht gesendet werden." }

HINWEISE

Für Skripte geeignet, die nicht unterbrochen werden sollen.

Send-TelegramMessage