en-US/PoshGram-help.xml
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-TelegramStickerPackInfo</command:name> <command:verb>Get</command:verb> <command:noun>TelegramStickerPackInfo</command:noun> <maml:description> <maml:para>Get information for specified Telegram sticker pack.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to retrieve Telegram sticker pack information. Displays emoji,emoji code, emoji shortcode, bytes, and file_id, and file information for each sticker in the sticker pack.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-TelegramStickerPackInfo</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>StickerSetName</maml:name> <maml:Description> <maml:para>Name of the sticker set</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>StickerSetName</maml:name> <maml:Description> <maml:para>Name of the sticker set</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> <maml:para>Some sticker authors use the same emoji for several of their stickers.</maml:para> <maml:para>width : 512 height : 512 emoji : 🙂 set_name : STPicard is_animated : False thumb : @{file_id=AAQCAAMMAAPdcBMXl0FGgL2-fdo_kOMNAAQBAAdtAAPeLQACFgQ; file_size=3810; width=128; height=128} file_id : CAADAgADDAAD3XATF5dBRoC9vn3aFgQ file_size : 18356 Bytes : {61, 216, 66, 222} Code : U+1F642 Shortcode : :slightly_smiling_face:</maml:para> <maml:para>To find the name of a sticker pack use the telegram app to share the sticker pack. This will provide a link which contains the sticker pack name.</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>Get-TelegramStickerPackInfo -BotToken $token -StickerSetName STPicard</dev:code> <dev:remarks> <maml:para>Sends contact via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Get-TelegramStickerPackInfo.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Get-TelegramStickerPackInfo.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#getstickerset</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#getstickerset</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sticker</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sticker</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramContact</command:name> <command:verb>Send</command:verb> <command:noun>TelegramContact</command:noun> <maml:description> <maml:para>Sends Telegram phone contact message via BOT API.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send contact information to specified Telegram chat.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramContact</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>PhoneNumber</maml:name> <maml:Description> <maml:para>Contact phone number</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>FirstName</maml:name> <maml:Description> <maml:para>Contact first name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>LastName</maml:name> <maml:Description> <maml:para>Contact last name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>PhoneNumber</maml:name> <maml:Description> <maml:para>Contact phone number</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>FirstName</maml:name> <maml:Description> <maml:para>Contact first name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>LastName</maml:name> <maml:Description> <maml:para>Contact last name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $phone = '1-222-222-2222' $firstName = 'Jean-Luc' Send-TelegramContact -BotToken $botToken -ChatID $chat -PhoneNumber $phone -FirstName $firstName</dev:code> <dev:remarks> <maml:para>Sends contact via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $phone = '1-222-222-2222' $firstName = 'Jean-Luc' $lastName = 'Picard' $sendTelegramContactSplat = @{ BotToken = $botToken ChatID = $chat PhoneNumber = $phone FirstName = $firstName LastName = $lastName DisableNotification = $true Verbose = $true } Send-TelegramContact @sendTelegramContactSplat</dev:code> <dev:remarks> <maml:para>Sends contact via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramContact.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramContact.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendcontact</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendcontact</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramDice</command:name> <command:verb>Send</command:verb> <command:noun>TelegramDice</command:noun> <maml:description> <maml:para>Sends Telegram animated emoji that will display a random value.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send animated emoji that will display a random value to specified Telegram chat.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramDice</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Emoji</maml:name> <maml:Description> <maml:para>Emoji on which the dice throw animation is based.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Emoji</maml:name> <maml:Description> <maml:para>Emoji on which the dice throw animation is based.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $emoji = 'basketball' Send-TelegramDice -BotToken $botToken -ChatID $chat -Emoji $emoji</dev:code> <dev:remarks> <maml:para>Sends animated basketball emoji that displays a random value via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $emoji = 'dice' $sendTelegramDiceSplat = @{ BotToken = $botToken ChatID = $chat DisableNotification = $true Verbose = $true Emoji = $emoji } Send-TelegramDice @sendTelegramDiceSplat</dev:code> <dev:remarks> <maml:para>Sends animated dice emoji that displays a random value via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramDice.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramDice.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#senddice</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#senddice</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramLocalAnimation</command:name> <command:verb>Send</command:verb> <command:noun>TelegramLocalAnimation</command:noun> <maml:description> <maml:para>Sends Telegram animation message via Bot API from locally sourced animation</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send animation message to specified Telegram chat. The animation will be sourced from the local device and uploaded to telegram. Several options can be specified to adjust message parameters.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramLocalAnimation</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>AnimationPath</maml:name> <maml:Description> <maml:para>File path to local image</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>AnimationPath</maml:name> <maml:Description> <maml:para>File path to local image</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>The following animation types are supported: GIF</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> <maml:para>Get creative by sending Gifs with your bot!</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $animation = "C:\animation\animation.gif" Send-TelegramLocalAnimation -BotToken $botToken -ChatID $chat -AnimationPath $animation</dev:code> <dev:remarks> <maml:para>Sends AnimationPath message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $animation = "C:\animation\animation.gif" $sendTelegramLocalAnimationSplat = @{ BotToken = $botToken ChatID = $chat AnimationPath = $animation Caption = "Check out this animation" ParseMode = 'MarkdownV2' DisableNotification = $true Verbose = $true } Send-TelegramLocalAnimation @sendTelegramLocalAnimationSplat</dev:code> <dev:remarks> <maml:para>Sends animation message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $animation = "C:\animation\animation.gif" $sendTelegramLocalAnimationSplat = @{ BotToken = $botToken ChatID = $chat AnimationPath = $animation Caption = "Check out this __awesome__ animation\." ParseMode = 'MarkdownV2' } Send-TelegramLocalAnimation @sendTelegramLocalAnimationSplat</dev:code> <dev:remarks> <maml:para>Sends animation message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalAnimation.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalAnimation.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendanimation</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendanimation</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramLocalAudio</command:name> <command:verb>Send</command:verb> <command:noun>TelegramLocalAudio</command:noun> <maml:description> <maml:para>Sends Telegram audio message via Bot API from locally sourced file</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send audio message to specified Telegram chat. The audio will be sourced from the local device and uploaded to telegram. Several options can be specified to adjust message parameters. Telegram only supports mp3 audio.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramLocalAudio</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Audio</maml:name> <maml:Description> <maml:para>Local path to audio file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of the audio in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Performer</maml:name> <maml:Description> <maml:para>Performer</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>Title</maml:name> <maml:Description> <maml:para>Track Name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Audio</maml:name> <maml:Description> <maml:para>Local path to audio file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of the audio in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Performer</maml:name> <maml:Description> <maml:para>Performer</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>Title</maml:name> <maml:Description> <maml:para>Track Name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>Your audio must be in the .mp3 format. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future.</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $audio = "C:\audio\halo_on_fire.mp3" Send-TelegramLocalAudio -BotToken $botToken -ChatID $chat -Audio $audio</dev:code> <dev:remarks> <maml:para>Sends audio message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $audio = "C:\audio\halo_on_fire.mp3" $sendTelegramLocalAudioSplat = @{ BotToken = $botToken ChatID = $chat Audio = $audio Caption = "Check out this audio track" ParseMode = 'MarkdownV2' Duration = 495 Performer = "Metallica" Title = "Halo On Fire" DisableNotification = $true Verbose = $true } Send-TelegramLocalAudio @sendTelegramLocalAudioSplat</dev:code> <dev:remarks> <maml:para>Sends audio message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $audio = "C:\audio\halo_on_fire.mp3" $sendTelegramLocalAudioSplat = @{ BotToken = $botToken ChatID = $chat Audio = $audio Title = "Halo On Fire" Performer = "Metallica" Caption = "Check out this __awesome__ audio track\." ParseMode = 'MarkdownV2' } Send-TelegramLocalAudio @sendTelegramLocalAudioSplat</dev:code> <dev:remarks> <maml:para>Sends audio message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalAudio.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalAudio.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendaudio</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendaudio</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramLocalDocument</command:name> <command:verb>Send</command:verb> <command:noun>TelegramLocalDocument</command:noun> <maml:description> <maml:para>Sends Telegram document message via Bot API from locally sourced file</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send document message to specified Telegram chat. The document will be sourced from the local device and uploaded to Telegram. Several options can be specified to adjust message parameters.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramLocalDocument</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>File</maml:name> <maml:Description> <maml:para>Local path to file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>File</maml:name> <maml:Description> <maml:para>Local path to file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>Bots can currently send files of up to 50 MB in size, this limit may be changed in the future.</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $file = "C:\Logs\Log1.txt" Send-TelegramLocalDocument -BotToken $botToken -ChatID $chat -File $file</dev:code> <dev:remarks> <maml:para>Sends document message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $file = "C:\Logs\Log1.txt" $sendTelegramLocalDocumentSplat = @{ BotToken = $botToken ChatID = $chat File = $file Caption = "Check out this file" ParseMode = 'MarkdownV2' DisableNotification = $true Verbose = $true } Send-TelegramLocalDocument @sendTelegramLocalDocumentSplat</dev:code> <dev:remarks> <maml:para>Sends document message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $file = "C:\Logs\Log1.txt" $sendTelegramLocalDocumentSplat = @{ BotToken = $botToken ChatID = $chat File = $file Caption = "Check out this __important__ file\." ParseMode = 'MarkdownV2' } Send-TelegramLocalDocument @sendTelegramLocalDocumentSplat</dev:code> <dev:remarks> <maml:para>Sends document message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalDocument.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalDocument.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#senddocument</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#senddocument</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramLocalPhoto</command:name> <command:verb>Send</command:verb> <command:noun>TelegramLocalPhoto</command:noun> <maml:description> <maml:para>Sends Telegram photo message via Bot API from locally sourced photo image</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send photo message to specified Telegram chat. The photo will be sourced from the local device and uploaded to telegram. Several options can be specified to adjust message parameters.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramLocalPhoto</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>PhotoPath</maml:name> <maml:Description> <maml:para>File path to local image</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>PhotoPath</maml:name> <maml:Description> <maml:para>File path to local image</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>The following photo types are supported: JPG, JPEG, PNG, GIF, BMP, WEBP, SVG, TIFF</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $photo = "C:\photos\aphoto.jpg" Send-TelegramLocalPhoto -BotToken $botToken -ChatID $chat -PhotoPath $photo</dev:code> <dev:remarks> <maml:para>Sends photo message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $photo = "C:\photos\aphoto.jpg" $sendTelegramLocalPhotoSplat = @{ BotToken = $botToken ChatID = $chat PhotoPath = $photo Caption = "Check out this photo" ParseMode = 'MarkdownV2' DisableNotification = $true Verbose = $true } Send-TelegramLocalPhoto @sendTelegramLocalPhotoSplat</dev:code> <dev:remarks> <maml:para>Sends photo message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $photo = "C:\photos\aphoto.jpg" $sendTelegramLocalPhotoSplat = @{ BotToken = $botToken ChatID = $chat PhotoPath = $photo Caption = "Check out this __awesome__ photo\." ParseMode = 'MarkdownV2' } Send-TelegramLocalPhoto @sendTelegramLocalPhotoSplat</dev:code> <dev:remarks> <maml:para>Sends photo message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalPhoto.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalPhoto.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendphoto</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendphoto</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramLocalSticker</command:name> <command:verb>Send</command:verb> <command:noun>TelegramLocalSticker</command:noun> <maml:description> <maml:para>Sends Telegram sticker message via Bot API from locally sourced sticker image</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send sticker message to specified Telegram chat. The sticker will be sourced from the local device and uploaded to telegram.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramLocalSticker</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>StickerPath</maml:name> <maml:Description> <maml:para>File path to the sticker you wish to send</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>StickerPath</maml:name> <maml:Description> <maml:para>File path to the sticker you wish to send</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>The following sticker types are supported: WEBP, TGS</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sticker = "C:\stickers\sticker.webp" Send-TelegramLocalSticker -BotToken $botToken -ChatID $chat -StickerPath $sticker</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sticker = "C:\stickers\sticker.webp" $sendTelegramLocalStickerSplat = @{ BotToken = $botToken ChatID = $chat StickerPath = $sticker DisableNotification = $true Verbose = $true } Send-TelegramLocalSticker @sendTelegramLocalStickerSplat</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalSticker.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalSticker.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendsticker</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendsticker</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramLocalVideo</command:name> <command:verb>Send</command:verb> <command:noun>TelegramLocalVideo</command:noun> <maml:description> <maml:para>Sends Telegram video message via Bot API from locally sourced file</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send video message to specified Telegram chat. The video will be sourced from the local device and uploaded to telegram. Several options can be specified to adjust message parameters. Telegram only supports mp4 videos.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramLocalVideo</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Video</maml:name> <maml:Description> <maml:para>Local path to video file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of sent video in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>Width</maml:name> <maml:Description> <maml:para>Video width</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Height</maml:name> <maml:Description> <maml:para>Video height</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Streaming</maml:name> <maml:Description> <maml:para>Use if the uploaded video is suitable for streaming</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Video</maml:name> <maml:Description> <maml:para>Local path to video file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of sent video in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>Width</maml:name> <maml:Description> <maml:para>Video width</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Height</maml:name> <maml:Description> <maml:para>Video height</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Streaming</maml:name> <maml:Description> <maml:para>Use if the uploaded video is suitable for streaming</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>Telegram clients support mp4 videos (other formats may be sent as Document) Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $file = "C:\videos\video.mp4" Send-TelegramLocalVideo -BotToken $botToken -ChatID $chat -Video $video</dev:code> <dev:remarks> <maml:para>Sends video message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $video = "C:\videos\video.mp4" $sendTelegramLocalVideoSplat = @{ BotToken = $botToken ChatID = $chat Video = $video Duration = 10 Width = 250 Height = 250 Caption = "Check out this video" ParseMode = 'MarkdownV2' Streaming = $true DisableNotification = $true Verbose = $true } Send-TelegramLocalVideo @sendTelegramLocalVideoSplat</dev:code> <dev:remarks> <maml:para>Sends video message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $video = "C:\videos\video.mp4" $sendTelegramLocalVideoSplat = @{ BotToken = $botToken ChatID = $chat Video = $video Streaming = $true Caption = "Check out this __awesome__ video\." ParseMode = 'MarkdownV2' } Send-TelegramLocalVideo @sendTelegramLocalVideoSplat</dev:code> <dev:remarks> <maml:para>Sends video message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalVideo.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocalVideo.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendvideo</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendvideo</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramLocation</command:name> <command:verb>Send</command:verb> <command:noun>TelegramLocation</command:noun> <maml:description> <maml:para>Sends Telegram location to indicate point on map</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send latitude and longitude points on map to specified Telegram chat.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramLocation</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Latitude</maml:name> <maml:Description> <maml:para>Latitude of the location</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Longitude</maml:name> <maml:Description> <maml:para>Longitude of the location</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Latitude</maml:name> <maml:Description> <maml:para>Latitude of the location</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Longitude</maml:name> <maml:Description> <maml:para>Longitude of the location</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $latitude = 37.621313 $longitude = -122.378955 Send-TelegramLocation -BotToken $botToken -ChatID $chat -Latitude $latitude -Longitude $longitude</dev:code> <dev:remarks> <maml:para>Sends location via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $photo = "C:\photos\aphoto.jpg" $sendTelegramLocationSplat = @{ BotToken = $botToken ChatID = $chat Latitude = $latitude Longitude = $longitude DisableNotification = $true Verbose = $true } Send-TelegramLocation @sendTelegramLocationSplat</dev:code> <dev:remarks> <maml:para>Sends location via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocation.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramLocation.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendlocation</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendlocation</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramMediaGroup</command:name> <command:verb>Send</command:verb> <command:noun>TelegramMediaGroup</command:noun> <maml:description> <maml:para>Sends Telegram a group of photos or videos as an album via Bot API from locally sourced media</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send a group of photo or video as an album message to specified Telegram chat. The media will be sourced from the local device and uploaded to telegram. This function only supports sending one media type per send (Photo | Video). 2 files minimum and 10 files maximum are required for this function.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramMediaGroup</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>MediaType</maml:name> <maml:Description> <maml:para>Type of media to send</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>FilePaths</maml:name> <maml:Description> <maml:para>List of filepaths for media you want to send</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>MediaType</maml:name> <maml:Description> <maml:para>Type of media to send</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>FilePaths</maml:name> <maml:Description> <maml:para>List of filepaths for media you want to send</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>The following photo types are supported: JPG, JPEG, PNG, GIF, BMP, WEBP, SVG, TIFF</maml:para> <maml:para>The following video types are supported: Telegram clients support mp4 videos</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> <maml:para>? This was really hard to make.</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sendTelegramMediaGroupSplat = @{ BotToken = $botToken ChatID = $chat MediaType = 'Photo' FilePaths = "C:\photo\photo1.jpg", "C:\photo\photo2.jpg" } Send-TelegramMediaGroup @sendTelegramMediaGroupSplat</dev:code> <dev:remarks> <maml:para>Uploads all provided photo files as album via Telegram Bot API.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sendTelegramMediaGroupSplat = @{ BotToken = $botToken ChatID = $chat MediaType = 'Photo' FilePaths = (Get-ChildItem C:\PhotoGroup | Select-Object -ExpandProperty FullName) } Send-TelegramMediaGroup @sendTelegramMediaGroupSplat</dev:code> <dev:remarks> <maml:para>Retrieves all photo file paths from C:\PhotoGroup and uploads as photo album. Keep in mind that your location must have at least 2, but not more than 10 files.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $vPath = 'C:\VideoGroup' $vFiles = @( "$vPath\first_contact.mp4", "$vPath\root_beer.mp4" ) $sendTelegramMediaGroupSplat = @{ BotToken = $botToken ChatID = $chat MediaType = 'Video' FilePaths = $vFiles DisableNotification = $true } Send-TelegramMediaGroup @sendTelegramMediaGroupSplat</dev:code> <dev:remarks> <maml:para>Uploads all provided video files as album via Telegram Bot API.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramMediaGroup.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramMediaGroup.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendmediagroup</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendmediagroup</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramPoll</command:name> <command:verb>Send</command:verb> <command:noun>TelegramPoll</command:noun> <maml:description> <maml:para>Sends Telegram native poll.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send a native poll with a question and several answer options.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramPoll</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Question</maml:name> <maml:Description> <maml:para>Poll question</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Options</maml:name> <maml:Description> <maml:para>String array of answer options</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>IsAnonymous</maml:name> <maml:Description> <maml:para>True, if the poll needs to be anonymous, defaults to True</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Boolean</command:parameterValue> <dev:type> <maml:name>Boolean</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>True</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>PollType</maml:name> <maml:Description> <maml:para>Poll type, "quiz" or "regular", defaults to "regular"</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Regular</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>MultipleAnswers</maml:name> <maml:Description> <maml:para>True, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Boolean</command:parameterValue> <dev:type> <maml:name>Boolean</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>QuizAnswer</maml:name> <maml:Description> <maml:para>0-based identifier of the correct answer option, required for polls in quiz mode</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Explanation</maml:name> <maml:Description> <maml:para>Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ExplanationParseMode</maml:name> <maml:Description> <maml:para>HTML vs Markdown for explanation formatting - HTML by default - https://core.telegram.org/bots/api#formatting-options</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>OpenPeriod</maml:name> <maml:Description> <maml:para>Amount of time in seconds the poll will be active after creation, 5-600.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Send-TelegramPoll</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Question</maml:name> <maml:Description> <maml:para>Poll question</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Options</maml:name> <maml:Description> <maml:para>String array of answer options</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>IsAnonymous</maml:name> <maml:Description> <maml:para>True, if the poll needs to be anonymous, defaults to True</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Boolean</command:parameterValue> <dev:type> <maml:name>Boolean</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>True</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>PollType</maml:name> <maml:Description> <maml:para>Poll type, "quiz" or "regular", defaults to "regular"</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Regular</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>MultipleAnswers</maml:name> <maml:Description> <maml:para>True, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Boolean</command:parameterValue> <dev:type> <maml:name>Boolean</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>QuizAnswer</maml:name> <maml:Description> <maml:para>0-based identifier of the correct answer option, required for polls in quiz mode</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Explanation</maml:name> <maml:Description> <maml:para>Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ExplanationParseMode</maml:name> <maml:Description> <maml:para>HTML vs Markdown for explanation formatting - HTML by default - https://core.telegram.org/bots/api#formatting-options</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>CloseDate</maml:name> <maml:Description> <maml:para>Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">DateTime</command:parameterValue> <dev:type> <maml:name>DateTime</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Question</maml:name> <maml:Description> <maml:para>Poll question</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Options</maml:name> <maml:Description> <maml:para>String array of answer options</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>IsAnonymous</maml:name> <maml:Description> <maml:para>True, if the poll needs to be anonymous, defaults to True</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Boolean</command:parameterValue> <dev:type> <maml:name>Boolean</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>True</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>PollType</maml:name> <maml:Description> <maml:para>Poll type, "quiz" or "regular", defaults to "regular"</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Regular</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>MultipleAnswers</maml:name> <maml:Description> <maml:para>True, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Boolean</command:parameterValue> <dev:type> <maml:name>Boolean</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>QuizAnswer</maml:name> <maml:Description> <maml:para>0-based identifier of the correct answer option, required for polls in quiz mode</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Explanation</maml:name> <maml:Description> <maml:para>Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ExplanationParseMode</maml:name> <maml:Description> <maml:para>HTML vs Markdown for explanation formatting - HTML by default - https://core.telegram.org/bots/api#formatting-options</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>OpenPeriod</maml:name> <maml:Description> <maml:para>Amount of time in seconds the poll will be active after creation, 5-600.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>CloseDate</maml:name> <maml:Description> <maml:para>Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">DateTime</command:parameterValue> <dev:type> <maml:name>DateTime</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> <maml:para>Telegram currently supports questions 1-255 characters Telegram currently supports 2-10 options 1-100 characters each</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $question = 'What is your favorite Star Trek series?' $opt = @( 'Star Trek: The Original Series', 'Star Trek: The Animated Series', 'Star Trek: The Next Generation', 'Star Trek: Deep Space Nine', 'Star Trek: Voyager', 'Star Trek: Enterprise', 'Star Trek: Discovery', 'Star Trek: Picard', 'Star Trek: Lower Decks' ) Send-TelegramPoll -BotToken $botToken -ChatID $chat -Question $question -Options $opt</dev:code> <dev:remarks> <maml:para>Sends poll via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $question = 'Who is your favorite Star Fleet Captain?' $opt = 'Jean-Luc Picard','Jean-Luc Picard','Jean-Luc Picard' $sendTelegramPollSplat = @{ BotToken = $token ChatID = $chat Question = $question Options = $opt DisableNotification = $true IsAnonymous = $true PollType = 'regular' MultipleAnswers = $false } Send-TelegramPoll @sendTelegramPollSplat</dev:code> <dev:remarks> <maml:para>Sends poll via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $question = 'Who was the best Starfleet captain?' $opt = @( 'James Kirk', 'Jean-Luc Picard', 'Benjamin Sisko', 'Kathryn Janeway', 'Jonathan Archer' ) $answer = 1 $sendTelegramPollSplat = @{ BotToken = $botToken ChatID = $chat Question = $question Options = $opt IsAnonymous = $false PollType = 'quiz' QuizAnswer = $answer } Send-TelegramPoll @sendTelegramPollSplat</dev:code> <dev:remarks> <maml:para>Sends quiz via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 4 --------------------------</maml:title> <dev:code>$question = 'Which class is the largest starship constructed by Starfleet?' $opt = @( 'Constitution class', 'Intrepid class', 'California class', 'Galaxy class', 'Invincible class', 'Sovereign class', 'Excelsior class', 'Miranda class', 'Nebula class', 'Olympic class' ) $explanation = 'At 1,607.2 meters in length, 764.4 meters across, and 305.76 meters high, Invincible class is the largest starship class ever built by Starfleet.' $answer = 4 $sendTelegramPollSplat = @{ BotToken = $token ChatID = $channel Question = $question Options = $opt Explanation = $explanation IsAnonymous = $false PollType = 'quiz' QuizAnswer = $answer } Send-TelegramPoll @sendTelegramPollSplat</dev:code> <dev:remarks> <maml:para>Sends quiz via Telegram API with answer explanation.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 5 --------------------------</maml:title> <dev:code>$question = 'Which Star Trek captain has an artificial heart?' $opt = @( 'James Kirk', 'Jean-Luc Picard', 'Benjamin Sisko', 'Kathryn Janeway', 'Jonathan Archer' ) $explanation = 'In _2327_, Jean\-Luc Picard received an *artificial heart* after he was stabbed by a Nausicaan during a bar brawl\.' $answer = 1 $sendTelegramPollSplat = @{ BotToken = $token ChatID = $channel Question = $question Options = $opt Explanation = $explanation ExplanationParseMode = 'MarkdownV2' IsAnonymous = $false PollType = 'quiz' QuizAnswer = $answer CloseDate = (Get-Date).AddDays(1) } Send-TelegramPoll @sendTelegramPollSplat</dev:code> <dev:remarks> <maml:para>Sends quiz via Telegram API with answer explanation properly formatted in MarkdownV2. Quiz will be open for 24 hours (1 day).</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramPoll.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramPoll.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendpoll</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendpoll</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramSticker</command:name> <command:verb>Send</command:verb> <command:noun>TelegramSticker</command:noun> <maml:description> <maml:para>Sends Telegram sticker message via Bot API by file_id or sticker pack emoji.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send sticker message to specified Telegram chat. The file_id can be specified if you know it. Use Get-TelegramStickerPackInfo if you do not already know the file_id of the sticker. Alternatively you can specify the sticker pack name and an emoji shortcode. This function will make an attempt to find the sticker that corresponds with the specified emoji. See notes for details.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramSticker</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>StickerSetName</maml:name> <maml:Description> <maml:para>Name of the sticker set</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Shortcode</maml:name> <maml:Description> <maml:para>Emoji shortcode</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Send-TelegramSticker</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>FileID</maml:name> <maml:Description> <maml:para>Telegram sticker file_id If you do not know the file ID of a sticker, you can use Get-TelegramStickerPackInfo to determine it.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Send-TelegramSticker</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>FileID</maml:name> <maml:Description> <maml:para>Telegram sticker file_id If you do not know the file ID of a sticker, you can use Get-TelegramStickerPackInfo to determine it.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Send-TelegramSticker</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>StickerSetName</maml:name> <maml:Description> <maml:para>Name of the sticker set</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Shortcode</maml:name> <maml:Description> <maml:para>Emoji shortcode</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>FileID</maml:name> <maml:Description> <maml:para>Telegram sticker file_id If you do not know the file ID of a sticker, you can use Get-TelegramStickerPackInfo to determine it.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>StickerSetName</maml:name> <maml:Description> <maml:para>Name of the sticker set</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Shortcode</maml:name> <maml:Description> <maml:para>Emoji shortcode</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1+ For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> <maml:para>Sticker packs are controlled by their author Not every sticker has a corresponding emoji Some sticker authors have the same emoji linked to multiple stickers This function will make a best attempt to look up the sticker pack you specify and send a sticker that matches the corresponding emoji shortcode.</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sticker = 'CAADAgADwQADECECEGEtCrI_kALvFgQ' Send-TelegramSticker -BotToken $botToken -ChatID $chat -FileID $sticker</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sticker = 'CAADAgADwQADECECEGEtCrI_kALvFgQ' $sendTelegramStickerSplat = @{ BotToken = $botToken ChatID = $chat FileID = $sticker DisableNotification = $true Verbose = $true } Send-TelegramSticker @sendTelegramStickerSplat</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" Send-TelegramSticker -BotToken $botToken -ChatID $chat -StickerSetName STPicard -Shortcode ':slightly_smiling_face:'</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 4 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sendTelegramStickerSplat = @{ BotToken = $botToken ChatID = $chat StickerSetName = 'STPicard' Shortcode = ':slightly_smiling_face:' DisableNotification = $true Verbose = $true } Send-TelegramSticker @sendTelegramStickerSplat</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramSticker.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramSticker.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendsticker</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendsticker</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramTextMessage</command:name> <command:verb>Send</command:verb> <command:noun>TelegramTextMessage</command:noun> <maml:description> <maml:para>Sends Telegram text message via Bot API</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send text message to specified Telegram chat. Several options can be specified to adjust message parameters.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramTextMessage</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Message</maml:name> <maml:Description> <maml:para>Text of the message to be sent</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisablePreview</maml:name> <maml:Description> <maml:para>Disables link previews for links in this message.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Message</maml:name> <maml:Description> <maml:para>Text of the message to be sent</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisablePreview</maml:name> <maml:Description> <maml:para>Disables link previews for links in this message.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6+, 7+ For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> <maml:para>Markdown Style: This is a legacy mode, retained for backward compatibility. When using Markdown/Markdownv2 you must properly escape characters.</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" Send-TelegramTextMessage -BotToken $botToken -ChatID $chat -Message "Hello"</dev:code> <dev:remarks> <maml:para>Sends text message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sendTelegramTextMessageSplat = @{ BotToken = $botToken ChatID = $chat Message = 'This is how to use <b>bold</b>,<i>italic</i>,<u>underline</u>, and <s>strikethrough</s>, with default HTML formatting.' } Send-TelegramTextMessage @sendTelegramTextMessageSplat</dev:code> <dev:remarks> <maml:para>Sends text message via Telegram API with properly formatted default HTML syntax.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $sendTelegramTextMessageSplat = @{ BotToken = $botToken ChatID = $chat Message = "Hello *chat* _channel_, check out this link: [TechThoughts](https://techthoughts.info/)" ParseMode = 'MarkdownV2' DisablePreview = $true DisableNotification = $true Verbose = $true } Send-TelegramTextMessage @sendTelegramTextMessageSplat</dev:code> <dev:remarks> <maml:para>Sends text message via Telegram API with properly formatted MarkdownV2 syntax.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 4 --------------------------</maml:title> <dev:code>$sendTelegramTextMessageSplat = @{ BotToken = $botToken ChatID = $chat ParseMode = 'MarkdownV2' Message = 'This is how to escape an __underscore__ in a message: \_' } Send-TelegramTextMessage @sendTelegramTextMessageSplat</dev:code> <dev:remarks> <maml:para>Sends text message via Telegram API using MarkdownV2 with an underlined word and a properly escaped character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramTextMessage.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramTextMessage.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendmessage</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendmessage</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramURLAnimation</command:name> <command:verb>Send</command:verb> <command:noun>TelegramURLAnimation</command:noun> <maml:description> <maml:para>Sends Telegram animation message via Bot API from URL sourced animation image</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send animation message to specified Telegram chat. The animation will be sourced from the provided URL and sent to Telegram. Several options can be specified to adjust message parameters.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramURLAnimation</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>AnimationURL</maml:name> <maml:Description> <maml:para>URL path to animation</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>AnimationURL</maml:name> <maml:Description> <maml:para>URL path to animation</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $animationURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/techthoughts.png" Send-TelegramURLAnimation -BotToken $botToken -ChatID $chat -AnimationURL $AnimationURL</dev:code> <dev:remarks> <maml:para>Sends animation message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $AnimationURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/jean.gif" $sendTelegramURLAnimationSplat = @{ BotToken = $botToken ChatID = $chat AnimationURL = $AnimationURL Caption = "Live long, and prosper." DisableNotification = $true Verbose = $true } Send-TelegramURLAnimation @sendTelegramURLAnimationSplat</dev:code> <dev:remarks> <maml:para>Sends animation message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $AnimationURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/jean.gif" $sendTelegramURLAnimationSplat = @{ BotToken = $botToken ChatID = $chat AnimationURL = $AnimationURL Caption = "Live __long__, and prosper\." ParseMode = 'MarkdownV2' } Send-TelegramURLAnimation @sendTelegramURLAnimationSplat</dev:code> <dev:remarks> <maml:para>Sends animation message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLAnimation.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLAnimation.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendanimation</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendanimation</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramURLAudio</command:name> <command:verb>Send</command:verb> <command:noun>TelegramURLAudio</command:noun> <maml:description> <maml:para>Sends Telegram audio message via Bot API from URL sourced file</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send audio message to specified Telegram chat. The file will be sourced from the provided URL and sent to Telegram. Several options can be specified to adjust message parameters. Only works for mp3 files.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramURLAudio</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>AudioURL</maml:name> <maml:Description> <maml:para>URL path to audio file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of the audio in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Performer</maml:name> <maml:Description> <maml:para>Performer</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>Title</maml:name> <maml:Description> <maml:para>Track Name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>AudioURL</maml:name> <maml:Description> <maml:para>URL path to audio file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of the audio in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Performer</maml:name> <maml:Description> <maml:para>Performer</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>Title</maml:name> <maml:Description> <maml:para>Track Name</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1+</maml:para> <maml:para>Your audio must be in the .mp3 format. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future.</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $audioURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/Tobu-_-Syndec-Dusk-_NCS-Release_-YouTube.mp3" Send-TelegramURLAudio -BotToken $botToken -ChatID $chat -AudioURL $audioURL</dev:code> <dev:remarks> <maml:para>Sends audio message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $audioURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/Tobu-_-Syndec-Dusk-_NCS-Release_-YouTube.mp3" $sendTelegramURLAudioSplat = @{ BotToken = $botToken ChatID = $chat AudioURL = $audioURL Caption = "Check out this audio track" ParseMode = 'MarkdownV2' Duration = 495 Performer = "Metallica" Title = "Halo On Fire" DisableNotification = $true Verbose = $true } Send-TelegramURLAudio @sendTelegramURLAudioSplat</dev:code> <dev:remarks> <maml:para>Sends audio message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $audioURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/Tobu-_-Syndec-Dusk-_NCS-Release_-YouTube.mp3" $sendTelegramURLAudioSplat = @{ BotToken = $botToken ChatID = $chat AudioURL = $audioURL Title = "Halo On Fire" Performer = "Metallica" Caption = "Check out this __awesome__ audio track\." ParseMode = 'MarkdownV2' } Send-TelegramURLAudio @sendTelegramURLAudioSplat</dev:code> <dev:remarks> <maml:para>Sends audio message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLAudio.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLAudio.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendaudio</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendaudio</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramURLDocument</command:name> <command:verb>Send</command:verb> <command:noun>TelegramURLDocument</command:noun> <maml:description> <maml:para>Sends Telegram document message via Bot API from URL sourced file</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send document message to specified Telegram chat. The file will be sourced from the provided URL and sent to Telegram. Several options can be specified to adjust message parameters. Only works for gif, pdf and zip files.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramURLDocument</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>FileURL</maml:name> <maml:Description> <maml:para>URL path to file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>FileURL</maml:name> <maml:Description> <maml:para>URL path to file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1+</maml:para> <maml:para>In sendDocument, sending by URL will currently only work for gif, pdf and zip files.</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $fileURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/LogExample.zip" Send-TelegramURLDocument -BotToken $botToken -ChatID $chat -FileURL $fileURL</dev:code> <dev:remarks> <maml:para>Sends document message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $fileURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/LogExample.zip" $sendTelegramURLDocumentSplat = @{ BotToken = $botToken ChatID = $chat FileURL = $fileURL Caption = "Log Files" ParseMode = 'MarkdownV2' DisableNotification = $true Verbose = $true } Send-TelegramURLDocument @sendTelegramURLDocumentSplat</dev:code> <dev:remarks> <maml:para>Sends document message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $fileURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/LogExample.zip" $sendTelegramURLDocumentSplat = @{ BotToken = $botToken ChatID = $chat FileURL = $fileURL Caption = "Here are the __important__ Log Files\." ParseMode = 'MarkdownV2' } Send-TelegramURLDocument @sendTelegramURLDocumentSplat</dev:code> <dev:remarks> <maml:para>Sends document message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLDocument.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLDocument.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#senddocument</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#senddocument</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramURLPhoto</command:name> <command:verb>Send</command:verb> <command:noun>TelegramURLPhoto</command:noun> <maml:description> <maml:para>Sends Telegram photo message via Bot API from URL sourced photo image</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send photo message to specified Telegram chat. The photo will be sourced from the provided URL and sent to Telegram. Several options can be specified to adjust message parameters.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramURLPhoto</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>PhotoURL</maml:name> <maml:Description> <maml:para>URL path to photo</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>PhotoURL</maml:name> <maml:Description> <maml:para>URL path to photo</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $photoURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/techthoughts.png" Send-TelegramURLPhoto -BotToken $botToken -ChatID $chat -PhotoURL $photourl</dev:code> <dev:remarks> <maml:para>Sends photo message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $photoURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/techthoughts.png" $sendTelegramURLPhotoSplat = @{ BotToken = $botToken ChatID = $chat PhotoURL = $photourl Caption = "DSC is a great technology" ParseMode = 'MarkdownV2' DisableNotification = $true Verbose = $true } Send-TelegramURLPhoto @sendTelegramURLPhotoSplat</dev:code> <dev:remarks> <maml:para>Sends photo message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $photoURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/techthoughts.png" $sendTelegramURLPhotoSplat = @{ BotToken = $botToken ChatID = $chat PhotoURL = $photourl Caption = "DSC is a __great__ technology\." ParseMode = 'MarkdownV2' } Send-TelegramURLPhoto @sendTelegramURLPhotoSplat</dev:code> <dev:remarks> <maml:para>Sends photo message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLPhoto.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLPhoto.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendphoto</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendphoto</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramURLSticker</command:name> <command:verb>Send</command:verb> <command:noun>TelegramURLSticker</command:noun> <maml:description> <maml:para>Sends Telegram sticker message via Bot API from URL sourced sticker image</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send sticker message to specified Telegram chat. The sticker will be sourced from the provided URL and sent to Telegram.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramURLSticker</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>StickerURL</maml:name> <maml:Description> <maml:para>URL path to sticker</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>StickerURL</maml:name> <maml:Description> <maml:para>URL path to sticker</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $StickerURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/techthoughts.webp" Send-TelegramURLSticker -BotToken $token -ChatID $channel -StickerURL $StickerURL</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $StickerURL = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/techthoughts.webp" $sendTelegramURLStickerSplat = @{ BotToken = $botToken ChatID = $chat StickerURL = $StickerURL DisableNotification = $true Verbose = $true } Send-TelegramURLSticker @sendTelegramURLStickerSplat</dev:code> <dev:remarks> <maml:para>Sends sticker message via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLSticker.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLSticker.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendsticker</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendsticker</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramURLVideo</command:name> <command:verb>Send</command:verb> <command:noun>TelegramURLVideo</command:noun> <maml:description> <maml:para>Sends Telegram video message via Bot API from URL sourced file</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send video message to specified Telegram chat. The file will be sourced from the provided URL and sent to Telegram. Several options can be specified to adjust message parameters. Only works for gif, pdf and zip files.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramURLVideo</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>VideoURL</maml:name> <maml:Description> <maml:para>URL path to video file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of sent video in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>Width</maml:name> <maml:Description> <maml:para>Video width</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Height</maml:name> <maml:Description> <maml:para>Video height</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Streaming</maml:name> <maml:Description> <maml:para>Use if the uploaded video is suitable for streaming</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>VideoURL</maml:name> <maml:Description> <maml:para>URL path to video file</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Duration</maml:name> <maml:Description> <maml:para>Duration of sent video in seconds</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>Width</maml:name> <maml:Description> <maml:para>Video width</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Height</maml:name> <maml:Description> <maml:para>Video height</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="7" aliases="none"> <maml:name>Caption</maml:name> <maml:Description> <maml:para>Brief title or explanation for media</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="8" aliases="none"> <maml:name>ParseMode</maml:name> <maml:Description> <maml:para>Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. Default is HTML.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>HTML</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Streaming</maml:name> <maml:Description> <maml:para>Use if the uploaded video is suitable for streaming</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1+</maml:para> <maml:para>Telegram clients support mp4 videos (other formats may be sent as Document) Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> <maml:para>Markdown Style: This is a legacy mode, retained for backward compatibility. When using Markdown/Markdownv2 you must properly escape characters.</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $videourl = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/Intro.mp4" Send-TelegramURLVideo -BotToken $botToken -ChatID $chat -VideoURL $videourl</dev:code> <dev:remarks> <maml:para>Sends video message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $videourl = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/Intro.mp4" $sendTelegramURLVideoSplat = @{ BotToken = $botToken ChatID = $chat VideoURL = $videourl Duration = 16 Width = 1920 Height = 1080 Caption = "Check out this video" ParseMode = 'MarkdownV2' Streaming = $true DisableNotification = $true Verbose = $true } Send-TelegramURLVideo @sendTelegramURLVideoSplat</dev:code> <dev:remarks> <maml:para>Sends video message via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $videourl = "https://github.com/techthoughts2/PoshGram/raw/master/test/SourceFiles/Intro.mp4" $sendTelegramURLVideoSplat = @{ BotToken = $botToken ChatID = $chat VideoURL = $videourl ParseMode = 'MarkdownV2' Caption = "Check out this __awesome__ video\." } Send-TelegramURLVideo @sendTelegramURLVideoSplat</dev:code> <dev:remarks> <maml:para>Sends video message via Telegram API with properly formatted underlined word and escaped special character.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLVideo.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramURLVideo.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendvideo</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendvideo</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#html-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#html-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdownv2-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdownv2-style</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#markdown-style</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#markdown-style</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Send-TelegramVenue</command:name> <command:verb>Send</command:verb> <command:noun>TelegramVenue</command:noun> <maml:description> <maml:para>Sends Telegram information about a venue.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Uses Telegram Bot API to send latitude, longitude, title, and address information about a venue to specified Telegram chat.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Send-TelegramVenue</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Latitude</maml:name> <maml:Description> <maml:para>Latitude of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Longitude</maml:name> <maml:Description> <maml:para>Longitude of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>Title</maml:name> <maml:Description> <maml:para>Name of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Address</maml:name> <maml:Description> <maml:para>Address of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>ChatID</maml:name> <maml:Description> <maml:para>Unique identifier for the target chat</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none"> <maml:name>Latitude</maml:name> <maml:Description> <maml:para>Latitude of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="4" aliases="none"> <maml:name>Longitude</maml:name> <maml:Description> <maml:para>Longitude of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Single</command:parameterValue> <dev:type> <maml:name>Single</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>0</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="5" aliases="none"> <maml:name>Title</maml:name> <maml:Description> <maml:para>Name of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="6" aliases="none"> <maml:name>Address</maml:name> <maml:Description> <maml:para>Address of the venue</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DisableNotification</maml:name> <maml:Description> <maml:para>Send the message silently. Users will receive a notification with no sound.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Version: 6.1+</maml:para> <maml:para>For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $latitude = 37.621313 $longitude = -122.378955 $title = 'Star Fleet Headquarters' $address = 'San Francisco, CA 94128' Send-TelegramVenue -BotToken $botToken -ChatID $chat -Latitude $latitude -Longitude $longitude -Title $title -Address $address</dev:code> <dev:remarks> <maml:para>Sends venue information via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $chat = "-nnnnnnnnn" $latitude = 37.621313 $longitude = -122.378955 $title = 'Star Fleet Headquarters' $address = 'San Francisco, CA 94128' $sendTelegramVenueSplat = @{ BotToken = $botToken ChatID = $chat Latitude = $latitude Longitude = $longitude Title = $title Address = $address DisableNotification = $true Verbose = $true } Send-TelegramVenue @sendTelegramVenueSplat</dev:code> <dev:remarks> <maml:para>Sends venue information via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramVenue.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Send-TelegramVenue.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#sendvenue</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#sendvenue</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Test-BotToken</command:name> <command:verb>Test</command:verb> <command:noun>BotToken</command:noun> <maml:description> <maml:para>Validates Bot auth Token</maml:para> </maml:description> </command:details> <maml:description> <maml:para>A simple method for testing your bot's auth token. Requires no parameters. Returns basic information about the bot in form of a User object.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Test-BotToken</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>BotToken</maml:name> <maml:Description> <maml:para>Use this token to access the HTTP API</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSCustomObject (if successful)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> <command:returnValue> <dev:type> <maml:name>System.Boolean (on failure)</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author: Jake Morrison - @jakemorrison - https://techthoughts.info/ This works with PowerShell Versions: 5.1, 6.0, 6.1 For a description of the Bot API, see this page: https://core.telegram.org/bots/api How do I get my channel ID? Use the getidsbot https://telegram.me/getidsbot -or- Use the Telegram web client and copy the channel ID in the address How do I set up a bot and get a token? Use the BotFather https://t.me/BotFather</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" Test-BotToken -BotToken $botToken</dev:code> <dev:remarks> <maml:para>Validates the specified Bot auth token via Telegram API</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx" $testBotTokenSplat = @{ BotToken = $botToken Verbose = $true } Test-BotToken @testBotTokenSplat</dev:code> <dev:remarks> <maml:para>Validates the specified Bot auth token via Telegram API</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>https://github.com/techthoughts2/PoshGram/blob/master/docs/Test-BotToken.md</maml:linkText> <maml:uri>https://github.com/techthoughts2/PoshGram/blob/master/docs/Test-BotToken.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>https://core.telegram.org/bots/api#getme</maml:linkText> <maml:uri>https://core.telegram.org/bots/api#getme</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> </helpItems> |