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"

VERWANDTE LINKS

Send-TelegramMessage

HINWEISE

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