Send-TelegramPhoto #

ÜBERSICHT #

Sendet ein Foto über die Telegram Bot API an einen bestimmten Chat.

SYNTAX #

Send-TelegramPhoto [[-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.

PhotoUrl kann eine HTTP(S)-URL oder ein lokaler Dateipfad sein. Bei lokalen Dateien wird unter PS 5.1 automatisch Multipart-Encoding über Convert-FormToBody durchgeführt; PS 7+ nutzt Invoke-RestMethod -Form.

Die Funktion gibt $true zurück, wenn das Foto 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 der Pfad “$HOME.eulandaconnect\SecureTelegramToken.xml” verwendet, wenn weder Token noch PlainToken übergeben wurden.

-ChatId #

Die Telegram-Chat-ID, an die das Foto gesendet werden soll. Z. B. “-123456789”.

-Caption #

Die Bildunterschrift. Unterstützt HTML oder Markdown-Formatierung.

-PhotoUrl #

URL oder lokaler Dateipfad zum Foto.

-TextMode #

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

Das Textformat: “html” oder “markdown”. Standard ist “html”.

-Silent #

Type: switch

Wenn gesetzt, wird das Foto stumm (ohne Push-Ton) versendet.

AUSGABEN #

bool

Die Funktion gibt $true zurück, wenn das Foto erfolgreich versendet wurde, andernfalls $false.

BEISPIELE #

# Verwendet automatisch $HOME\.eulandaconnect\SecureTelegramToken.xml
Send-TelegramPhoto -ChatId "-123456789" -Caption "Neues Release" -PhotoUrl "https://example.com/bild.jpg"

# Versendet ein lokales Bild mit einem Klartext-Token.
Send-TelegramPhoto -PlainToken "123456:ABC" -ChatId "-123456789" -Caption "Screenshot" -PhotoUrl "C:\Bilder\screenshot.png"

HINWEISE #

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