Send Telegram Message
Zuletzt geändert: 14.03.2026 05:56

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.