PoshGram.psm1
|
$script:assetPath = "$PSScriptRoot\asset\emoji.json" <# .Synopsis Evaluates if the provided URL is reachable .DESCRIPTION Evaluates if the provided URL is reachable and returns a boolean based on results .EXAMPLE Confirm-URL -Uri http://gph.is/2y3AWRU Determines if the provided URL is accessible and returns a boolean based on results .PARAMETER Uri Uri you wish to resolve .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Confirm-URL { [CmdletBinding()] param ( ## The URI to resolve [Parameter(Mandatory = $true, HelpMessage = 'Uri you wish to resolve')] [string]$Uri ) $result = $true #assume the best [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 Write-Verbose -Message "Attempting to confirm $Uri" try { Invoke-WebRequest -Uri $uri -UseBasicParsing -DisableKeepAlive -ErrorAction Stop | Out-Null Write-Verbose -Message 'Confirmed.' } #try_Invoke-WebRequest catch { Write-Verbose -Message 'Catch on Invoke-WebRequest. This is not necessarily a bad thing. Checking status code.' if ([int]$_.Exception.Response.StatusCode -eq 0) { Write-Warning -Message "$Uri" Write-Warning -Message 'The URL provided does not appear to be valid' $result = $false } #we will proceed with any other exit code } #catch_Invoke-WebRequest return $result } #Confirm-URL <# .Synopsis Resolve a URI to the URIs it redirects to .DESCRIPTION Resolves a URI provided to the URI it redirects to. If no redirect is in place, null is returned. This is useful for resolving shortlinks to try url file paths. .EXAMPLE Resolve-ShortLink -Uri http://gph.is/2y3AWRU Resolve shortlink to full URI .PARAMETER Uri Uri you wish to resolve .OUTPUTS System.String -or- Null .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Resolve-ShortLink { [CmdletBinding()] param ( ## The URI to resolve [Parameter(Mandatory = $true, HelpMessage = 'Uri you wish to resolve')] [string]$Uri ) $result = $null $eval = $null [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 try { $eval = Invoke-WebRequest -Uri $uri -MaximumRedirection 0 -ErrorAction Stop } #try_Invoke-WebRequest catch { #if($_.ErrorDetails.Message -like "*maximum redirection*"){ if ($_.Exception.Message -like "*Moved*") { $eval = $_ Write-Verbose -Message 'Moved detected.' #$result = $eval.Headers.Location $result = $eval.Exception.Response.Headers.Location.AbsoluteUri } #if_Error_Moved else { Write-Warning -Message 'An Error was encountered resolving a potential shortlink:' Write-Error $_ } #else_Error_Moved } #catch_Invoke-WebRequest return $result } #Resolve-ShortLink <# .Synopsis Verifies that provided quiz explanation matches Telegram requirements. .DESCRIPTION Evaluates if the provided quiz explanation meets the Telegram explanation requirements. .EXAMPLE Test-Explanation -Explanation $explanation Verifies if the provided options meet the poll requirements. .PARAMETER Explanation Quiz explanation text .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ Telegram currently supports 0-200 characters with at most 2 line feeds after entities parsing .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Test-Explanation { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'Quiz explanation text')] [string]$Explanation ) $results = $true #assume the best Write-Verbose -Message 'Evaluating provided explanation...' $splitTest = $Explanation -split '\n' $carriageCount = $splitTest | Measure-Object | Select-Object -ExpandProperty Count if ($carriageCount -gt 2) { Write-Warning -Message 'Explanation can contain at most 2 line feeds.' $results = $false } if ($Explanation.Length -gt 200) { Write-Warning -Message 'Explanation can contain at most 200 characters.' $results = $false } return $results } #function_Test-Explanation <# .Synopsis Verifies that specified file is a supported Telegram extension type .DESCRIPTION Evaluates the specified file path to determine if the file is a supported extension type .EXAMPLE Test-FileExtension -FilePath C:\photos\aphoto.jpg -Type Photo Verifies if the path specified is a supported photo extension type .EXAMPLE Test-FileExtension -FilePath $PhotoPath -Type Photo -Verbose Verifies if the path specified in $PhotoPath is a supported photo extension type with verbose output .EXAMPLE $fileTypeEval = Test-FileExtension -FilePath $AnimationPath -Type Animation Verifies if the path specified is a supported Animation extension type .EXAMPLE $fileTypeEval = Test-FileExtension -FilePath $Audio -Type Audio Verifies if the path specified is a supported Audio extension type .EXAMPLE $fileTypeEval = Test-FileExtension -FilePath $PhotoPath -Type Photo Verifies if the path specified is a supported photo extension type .EXAMPLE $fileTypeEval = Test-FileExtension -FilePath $Video -Type Video Verifies if the path specified is a supported Video extension type .EXAMPLE $fileTypeEval = Test-FileExtension -FilePath $Sticker -Type Sticker Verifies if the path specified is a supported Sticker extension type .PARAMETER FilePath Path to file that will be evaluated .PARAMETER Type Telegram message type .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Test-FileExtension { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'Path to file that will be evaluated')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$FilePath, [Parameter(Mandatory = $true, HelpMessage = 'Telegram message type')] [ValidateSet('Photo', 'Video', 'Audio', 'Animation', 'Sticker')] [string]$Type ) #------------------------------------------------------------ $supportedPhotoExtensions = @( 'JPG' 'JPEG' 'PNG' 'GIF' 'BMP' 'WEBP' 'SVG' 'TIFF' ) $supportedVideoExtensions = @( 'MP4' ) $supportedAudioExtensions = @( 'MP3', 'M4A' ) $supportedAnimationExtensions = @( 'GIF' ) $supportedStickerExtensions = @( 'WEBP' 'TGS' 'WEBM' ) switch ($Type) { Photo { $extType = $supportedPhotoExtensions } #photo Video { $extType = $supportedVideoExtensions } #video Audio { $extType = $supportedAudioExtensions } #audio Animation { $extType = $supportedAnimationExtensions } #animation Sticker { $extType = $supportedStickerExtensions } } #switch_Type Write-Verbose -Message "Validating type: $Type" #------------------------------------------------------------ [bool]$results = $true #assume the best. #------------------------------------------------------------ Write-Verbose -Message "Processing $FilePath ..." $divide = $FilePath.Split('.') $rawExtension = $divide[$divide.Length - 1] $extension = $rawExtension.ToUpper() Write-Verbose -Message "Verifying discovered extension: $extension" switch ($extension) { { $extType -contains $_ } { Write-Verbose -Message 'Extension verified.' } default { Write-Warning -Message "The specified file is not a supported $Type extension." $results = $false } #default } #switch_extension return $results } #function_Test-FileExtension <# .Synopsis Verifies that file size is supported by Telegram .DESCRIPTION Evaluates if the file is at or below the supported Telegram file size .EXAMPLE Test-FileSize -Path C:\videos\video.mp4 Verifies if the path specified is a supported video extension type .EXAMPLE Test-FileSize -Path $Path -Verbose Verifies if the path specified in $VideoPath is a supported video extension type with verbose output .PARAMETER Path Path to file .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ Telegram currently supports a 50MB file size for bots .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Test-FileSize { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'Path to file')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$Path ) $results = $true #assume the best $supportedSize = 50 try { $size = Get-ChildItem -Path $Path -ErrorAction Stop if (($size.Length / 1MB) -gt $supportedSize) { Write-Warning -Message "The file is over $supportedSize (MB)" $results = $false } } catch { Write-Warning -Message 'An error was encountered evaluating the file size' $results = $false } return $results } #function_Test-FileSize <# .Synopsis Verifies that MediaGroup requirements are met. .DESCRIPTION Evaluates the provided files to determine if they met all MediaGroup requirements. .EXAMPLE Test-MediaGroupRequirements -MediaType Photo -FilePaths $files Verifies if the provided files adhere to the Telegram MediaGroup requirements. .PARAMETER MediaType Type of media to send .PARAMETER FilePaths List of filepaths for media you want to send .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ Telegram currently supports a 50MB file size for bots .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Test-MediaGroupRequirements { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'Type of media to send')] [ValidateSet('Photo', 'Video', 'Document', 'Audio')] [string]$MediaType, [Parameter(Mandatory = $false, HelpMessage = 'List of filepaths for media you want to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string[]]$FilePaths ) Write-Verbose -Message 'Evaluating the group of files for MediaGroup requirements...' $results = $true #assume the best Write-Verbose -Message 'Evaluating file count...' if ($FilePaths.Count -le 1 -or $FilePaths.Count -gt 10) { Write-Warning -Message 'Send-TelegramMediaGroup requires a minimum of 2 and a maximum of 10 media files to be provided.' $results = $false return $results } #file_Count else { Write-Verbose -Message "File count is: $($FilePaths.Count)" } #else_FileCount foreach ($file in $FilePaths) { $fileTypeEval = $null $fileSizeEval = $null Write-Verbose -Message 'Verifying presence of media...' if (-not(Test-Path -Path $file)) { Write-Warning -Message "The specified media path: $file was not found." $results = $false return $results } #if_testPath if ($MediaType -ne 'Document') { Write-Verbose -Message 'Verifying extension type...' $fileTypeEval = Test-FileExtension -FilePath $file -Type $MediaType if ($fileTypeEval -eq $false) { $results = $false return $results } #if_Extension else { Write-Verbose -Message 'Extension supported.' } #else_Extension } Write-Verbose -Message 'Verifying file size...' $fileSizeEval = Test-FileSize -Path $file if ($fileSizeEval -eq $false) { $results = $false return $results } #if_Size else { Write-Verbose -Message 'File size verified.' } #else_Size } #foreach_File return $results } #Test-MediaGroupRequirements <# .Synopsis Verifies that poll options are supported by Telegram .DESCRIPTION Evaluates if the provided poll options meet the Telegram poll requirements. .EXAMPLE Test-PollOptions -PollOptions $options Verifies if the provided options meet the poll requirements. .EXAMPLE Test-PollOptions -PollOptions $options Verifies if the provided options meet the poll requirements with verbose output. .PARAMETER PollOptions Poll Options for eval .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ Telegram currently supports 2-10 options 1-100 characters each .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Test-PollOptions { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'Poll Options for eval')] [string[]]$PollOptions ) $results = $true #assume the best Write-Verbose -Message 'Evaluating number of options...' $optionCount = $PollOptions.Length if ($optionCount -lt 2 -or $optionCount -gt 10) { Write-Warning -Message 'Only 2-10 poll options are allowed.' $results = $false } #if_optionCount else { Write-Verbose -Message 'Option number verified.' Write-Verbose -Message 'Evaluating character length of options...' foreach ($option in $PollOptions) { if ($option.Length -lt 1 -or $option.Length -gt 100) { Write-Warning -Message "$option is not between 1-100 characters." $results = $false } #if_length } #foreach_option } #else_optionCount return $results } #function_Test-PollOptions <# .Synopsis Verifies that specified URL path contains a supported Telegram extension type .DESCRIPTION Evaluates the specified URL path to determine if the URL leads to a supported extension type .EXAMPLE Test-URLExtension -URL $URL -Type Photo Verifies if the URL path specified is a supported photo extension type .EXAMPLE Test-URLExtension -URL $PhotoURL -Type Photo -Verbose Verifies if the URL path specified is a supported photo extension type with Verbose output .EXAMPLE Test-URLExtension -URL $VideoURL -Type Video Verifies if the URL path specified is a supported video extension type .EXAMPLE Test-URLExtension -URL $AudioURL -Type Audio Verifies if the URL path specified is a supported audio extension type .EXAMPLE Test-URLExtension -URL $AnimationURL -Type Animation Verifies if the URL path specified is a supported animation extension type .EXAMPLE Test-URLExtension -URL $DocumentURL -Type Document Verifies if the URL path specified is a supported document extension type .EXAMPLE Test-URLExtension -URL $StickerURL -Type Sticker Verifies if the URL path specified is a supported sticker extension type .PARAMETER URL The URL string to the specified online file .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Test-URLExtension { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'URL string of document')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$URL, [Parameter(Mandatory = $true, HelpMessage = 'Telegram message type')] [ValidateSet('Photo', 'Video', 'Audio', 'Animation', 'Document', 'Sticker')] [string]$Type ) #------------------------------------------------------------ $supportedPhotoExtensions = @( 'JPG' 'JPEG' 'PNG' 'GIF' 'BMP' 'WEBP' 'SVG' 'TIFF' ) $supportedVideoExtensions = @( 'MP4' ) $supportedAudioExtensions = @( 'MP3' 'M4A' ) $supportedAnimationExtensions = @( 'GIF' ) $supportedDocumentExtensions = @( 'PDF' 'GIF' 'ZIP' ) $supportedStickerExtensions = @( 'WEBP' 'WEBM' #'TGS' #* doesn't seem to work for URL uploads ) switch ($Type) { Photo { $extType = $supportedPhotoExtensions } #photo Video { $extType = $supportedVideoExtensions } #video Audio { $extType = $supportedAudioExtensions } #audio Animation { $extType = $supportedAnimationExtensions } #animation Document { $extType = $supportedDocumentExtensions } #document Sticker { $extType = $supportedStickerExtensions } #sticker } #switch_Type Write-Verbose -Message "Validating type: $Type" #------------------------------------------------------------ [bool]$results = $true #assume the best. #------------------------------------------------------------ Write-Verbose -Message 'Testing provided URL' $urlEval = Confirm-URL -Uri $URL if ($urlEval -ne $true) { Write-Verbose -Message 'URL Confirmation did not return true.' $results = $false return $results } #if_urlEval #------------------------------------------------------------ Write-Verbose -Message 'Resolving potential shortlink...' $slEval = Resolve-ShortLink -Uri $URL -ErrorAction SilentlyContinue if ($slEval) { $URL = $slEval } #if_slEval #------------------------------------------------------------ Write-Verbose -Message "Processing $URL ..." $divide = $URL.Split('.') $rawExtension = $divide[$divide.Length - 1] $extension = $rawExtension.ToUpper() Write-Verbose -Message "Verifying discovered extension: $extension" switch ($extension) { { $extType -contains $_ } { Write-Verbose -Message 'Extension verified.' } default { Write-Warning -Message "The specified file is not a supported $Type extension." $results = $false } #default } #switch_extension #------------------------------------------------------------ return $results } #function_Test-URLExtension <# .Synopsis Verifies that specified URL file size is supported by Telegram .DESCRIPTION Evaluates the specified URL path to determine if the file is at or below the supported Telegram file size .EXAMPLE Test-URLFileSize -URL 'https://github.com/techthoughts2/PoshGram/raw/main/test/SourceFiles/techthoughts.png' Verifies if the file in the specified URL is at or below the Telegram maximum size .EXAMPLE Test-URLFileSize -URL $URL -Verbose Verifies if the file in the specified URL is at or below the Telegram maximum size with verbose output .PARAMETER URL URL address to file .OUTPUTS System.Boolean .NOTES Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/ Telegram currently supports a 50MB file size for bots .COMPONENT PoshGram - https://github.com/techthoughts2/PoshGram #> function Test-URLFileSize { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'URL address to file')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$URL ) $results = $true #assume the best $supportedSize = 50 try { $urlFileInfo = Invoke-WebRequest $URL -ErrorAction Stop if (($urlFileInfo.RawContentLength / 1MB) -gt $supportedSize) { Write-Warning -Message "The file is over $supportedSize (MB)" $results = $false } #if_size } #try_Invoke-WebRequest catch { Write-Warning -Message 'An error was encountered evaluating the file size' $results = $false } #catch_Invoke-WebRequest return $results } #function_Test-URLFileSize <# .EXTERNALHELP PoshGram-help.xml #> function Get-TelegramStickerPackInfo { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Sticker pack name')] [ValidateNotNullOrEmpty()] [string]$StickerSetName ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) $form = @{ name = $StickerSetName } #form $uri = 'https://api.telegram.org/bot{0}/getStickerSet' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Retrieving sticker information...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered getting the Telegram sticker info:' if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue return $results } else { throw $_ } } #catch_messageSend Write-Verbose -Message 'Sticker information found. Processing emoji information...' Write-Verbose -Message "Asset path: $script:assetPath" $je = Get-Content -Path $script:assetPath $psF = $je | ConvertFrom-Json $stickerData = @() foreach ($emoji in $results.result.stickers) { #------------------- $emojiData = $null $code = $null $name = $null #------------------- $bytes = [text.encoding]::unicode.getbytes($emoji.emoji) # $actual = [System.Text.Encoding]::Unicode.GetString($bytes) # $emoji | Add-Member -Type NoteProperty -Name ActualEmoji -Value $actual -Force $emoji | Add-Member -Type NoteProperty -Name Bytes -Value $bytes -Force $emojiData = $psf | Where-Object { $_.KDDI -eq $emoji.emoji } $code = $emojiData.Sheet $name = $emojiData.Google $emoji | Add-Member -Type NoteProperty -Name Code -Value $code -Force $emoji | Add-Member -Type NoteProperty -Name Shortcode -Value $name -Force $stickerData += $emoji } return $stickerData } #function_Get-TelegramStickerPackInfo <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramContact { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Contact phone number')] [ValidateNotNullOrEmpty()] [string]$PhoneNumber, [Parameter(Mandatory = $true, HelpMessage = 'Contact first name')] [ValidateNotNullOrEmpty()] [string]$FirstName, [Parameter(Mandatory = $false, HelpMessage = 'Contact last name')] [ValidateNotNullOrEmpty()] [string]$LastName, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) $form = @{ chat_id = $ChatID phone_number = $PhoneNumber first_name = $FirstName last_name = $LastName disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendContact' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending contact...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram contact:' if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramContact <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramDice { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Emoji on which the dice throw animation is based.')] [ValidateSet('dice', 'dart', 'basketball', 'football', 'slotmachine', 'bowling')] [string]$Emoji, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) switch ($Emoji) { dice { $emojiSend = '🎲' } dart { $emojiSend = '🎯' } basketball { $emojiSend = '🏀' } football { $emojiSend = 'âš½' } slotmachine { $emojiSend = '🎰' } bowling { $emojiSend = '🎳' } } $form = @{ chat_id = $ChatID emoji = $emojiSend disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendDice' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending dice...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram location:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramDice <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramLocalAnimation { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'File path to the animation you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$AnimationPath, [Parameter(Mandatory = $false, HelpMessage = 'Animation caption')] [string]$Caption = '', #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying presence of animation...' if (-not(Test-Path -Path $AnimationPath)) { throw ('The specified animation path: {0} was not found.' -f $AnimationPath) } #if_testPath else { Write-Verbose -Message 'Path verified.' } #else_testPath Write-Verbose -Message 'Verifying extension type...' $fileTypeEval = Test-FileExtension -FilePath $AnimationPath -Type Animation if ($fileTypeEval -eq $false) { throw 'File extension is not a supported Animation type' } #if_animationExtension else { Write-Verbose -Message 'Extension supported.' } #else_animationExtension Write-Verbose -Message 'Verifying file size...' $fileSizeEval = Test-FileSize -Path $AnimationPath if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_animationSize else { Write-Verbose -Message 'File size verified.' } #else_animationSize Write-Verbose -Message 'Getting animation file...' try { $fileObject = Get-Item $AnimationPath -ErrorAction Stop } #try_Get-ItemAnimation catch { Write-Warning -Message 'The specified animation could not be interpreted properly.' throw $_ } #catch_Get-ItemAnimation $form = @{ chat_id = $ChatID animation = $fileObject caption = $Caption parse_mode = $ParseMode disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendAnimation' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending animation...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram animation message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramLocalAnimation <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramLocalAudio { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Local path to file you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$Audio, [Parameter(Mandatory = $false, HelpMessage = 'Caption for file')] [string]$Caption = '', #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Duration of the audio in seconds')] [int]$Duration, [Parameter(Mandatory = $false, HelpMessage = 'Performer')] [string]$Performer, [Parameter(Mandatory = $false, HelpMessage = 'TrackName')] [string]$Title, [Parameter(Mandatory = $false, HelpMessage = 'Original File Name')] [string]$FileName, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying presence of file...' if (-not(Test-Path -Path $Audio)) { throw ('The specified file was not found {0}' -f $Audio) } #if_testPath else { Write-Verbose -Message 'Path verified.' } #else_testPath Write-Verbose -Message 'Verifying extension type...' $fileTypeEval = Test-FileExtension -FilePath $Audio -Type Audio if ($fileTypeEval -eq $false) { throw 'File extension is not a supported Audio type' } #if_audioExtension else { Write-Verbose -Message 'Extension supported.' } #else_audioExtension Write-Verbose -Message 'Verifying file size...' $fileSizeEval = Test-FileSize -Path $Audio if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_audioSize else { Write-Verbose -Message 'File size verified.' } #else_audioSize Write-Verbose -Message 'Getting audio file...' try { $fileObject = Get-Item $Audio -ErrorAction Stop } #try_Get-ItemAudio catch { Write-Warning -Message 'The specified audio could not be interpreted properly.' throw $_ } #catch_Get-ItemAudio $form = @{ chat_id = $ChatID audio = $fileObject caption = $Caption parse_mode = $ParseMode duration = $Duration performer = $Performer title = $Title file_name = $FileName disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendAudio' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending audio...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram audio message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramLocalAudio <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramLocalDocument { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Local path to file you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$File, [Parameter(Mandatory = $false, HelpMessage = 'Caption for file')] [string]$Caption = '', #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Disables automatic server-side content type detection')] [switch]$DisableContentTypeDetection, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying presence of file...' if (-not(Test-Path -Path $File)) { throw ('The specified file was not found: {0}' -f $AnimationPath) } #if_testPath else { Write-Verbose -Message 'Path verified.' } #else_testPath Write-Verbose -Message 'Verifying file size...' $fileSizeEval = Test-FileSize -Path $File if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_fileSize else { Write-Verbose -Message 'File size verified.' } #else_fileSize Write-Verbose -Message 'Getting document file...' try { $fileObject = Get-Item $File -ErrorAction Stop } #try_Get-Item catch { Write-Warning -Message 'The specified file could not be interpreted properly.' throw $_ } #catch_Get-Item $form = @{ chat_id = $ChatID document = $fileObject caption = $Caption parse_mode = $ParseMode disable_content_type_detection = $DisableContentTypeDetection.IsPresent disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendDocument' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending document...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram document message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramLocalDocument <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramLocalPhoto { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'File path to the photo you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$PhotoPath, [Parameter(Mandatory = $false, HelpMessage = 'Photo caption')] [string]$Caption = '', #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying presence of photo...' if (-not(Test-Path -Path $PhotoPath)) { throw ('The specified photo path: {0} was not found.' -f $PhotoPath) } #if_testPath else { Write-Verbose -Message 'Path verified.' } #else_testPath Write-Verbose -Message 'Verifying extension type...' $fileTypeEval = Test-FileExtension -FilePath $PhotoPath -Type Photo if ($fileTypeEval -eq $false) { throw 'File extension is not a supported Photo type' } #if_photoExtension else { Write-Verbose -Message 'Extension supported.' } #else_photoExtension Write-Verbose -Message 'Verifying file size...' $fileSizeEval = Test-FileSize -Path $PhotoPath if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_photoSize else { Write-Verbose -Message 'File size verified.' } #else_photoSize Write-Verbose -Message 'Getting photo file...' try { $fileObject = Get-Item $PhotoPath -ErrorAction Stop } #try_Get-ItemPhoto catch { Write-Warning -Message 'The specified photo could not be interpreted properly.' throw $_ } #catch_Get-ItemPhoto $form = @{ chat_id = $ChatID photo = $fileObject caption = $Caption parse_mode = $ParseMode disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendphoto' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending photo...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram photo message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramLocalPhoto <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramLocalSticker { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'File path to the sticker you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$StickerPath, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying presence of sticker...' if (-not(Test-Path -Path $StickerPath)) { throw ('The specified sticker path: {0} was not found.' -f $AnimationPath) } #if_testPath else { Write-Verbose -Message 'Path verified.' } #else_testPath Write-Verbose -Message 'Verifying extension type...' $fileTypeEval = Test-FileExtension -FilePath $StickerPath -Type Sticker if ($fileTypeEval -eq $false) { throw 'File extension is not a supported Sticker type' } #if_stickerExtension else { Write-Verbose -Message 'Extension supported.' } #else_stickerExtension Write-Verbose -Message 'Verifying file size...' $fileSizeEval = Test-FileSize -Path $StickerPath if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_stickerSize else { Write-Verbose -Message 'File size verified.' } #else_stickerSize Write-Verbose -Message 'Getting sticker file...' try { $fileObject = Get-Item $StickerPath -ErrorAction Stop } #try_Get-ItemSticker catch { Write-Warning -Message 'The specified sticker could not be interpreted properly.' throw $_ } #catch_Get-ItemSticker $form = @{ chat_id = $ChatID sticker = $fileObject disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendSticker' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending sticker...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram sticker message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramLocalSticker <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramLocalVideo { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Local path to file you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$Video, [Parameter(Mandatory = $false, HelpMessage = 'Duration of video in seconds')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Int32]$Duration, [Parameter(Mandatory = $false, HelpMessage = 'Video width')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Int32]$Width, [Parameter(Mandatory = $false, HelpMessage = 'Video height')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Int32]$Height, [Parameter(Mandatory = $false, HelpMessage = 'Original File Name')] [string]$FileName, [Parameter(Mandatory = $false, HelpMessage = 'Caption for file')] [string]$Caption = '', #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Use if the uploaded video is suitable for streaming')] [switch]$Streaming, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying presence of file...' if (-not(Test-Path -Path $Video)) { throw ('The specified video file: {0} was not found.' -f $Video) } #if_testPath else { Write-Verbose -Message 'Path verified.' } #else_testPath Write-Verbose -Message 'Verifying extension type...' $fileTypeEval = Test-FileExtension -FilePath $Video -Type Video if ($fileTypeEval -eq $false) { throw 'File extension is not a supported Video type' } #if_videoExtension else { Write-Verbose -Message 'Extension supported.' } #else_videoExtension Write-Verbose -Message 'Verifying file size...' $fileSizeEval = Test-FileSize -Path $Video if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_videoSize else { Write-Verbose -Message 'File size verified.' } #else_videoSize Write-Verbose -Message 'Getting video file...' try { $fileObject = Get-Item $Video -ErrorAction Stop } #try_Get-ItemVideo catch { Write-Warning -Message 'The specified video file could not be interpreted properly.' throw $_ } #catch_Get-ItemVideo $form = @{ chat_id = $ChatID video = $fileObject duration = $Duration width = $Width height = $Height file_name = $FileName caption = $Caption parse_mode = $ParseMode supports_streaming = $Streaming.IsPresent disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendVideo' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending video...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram video message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramLocalVideo <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramLocation { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Latitude of the location')] [ValidateRange(-90, 90)] [single]$Latitude, [Parameter(Mandatory = $true, HelpMessage = 'Longitude of the location')] [ValidateRange(-180, 180)] [single]$Longitude, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) $form = @{ chat_id = $ChatID latitude = $Latitude longitude = $Longitude disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendLocation' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending location...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram location:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramLocation <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramMediaGroup { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Type of media to send')] [ValidateSet('Photo', 'Video', 'Document', 'Audio')] [string]$MediaType, [Parameter(Mandatory = $false, HelpMessage = 'List of filepaths for media you want to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string[]]$FilePaths, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) $MediaType = $MediaType.ToLower() Write-Verbose -Message ('You have specified a media type of: {0}' -f $MediaType) Write-Verbose -Message 'Testing if media group meets requirements...' $mediaGroupReqsEval = Test-MediaGroupRequirements -MediaType $MediaType -FilePath $FilePaths if (-not $mediaGroupReqsEval) { throw 'Telegram media group requirements not met' } Write-Verbose -Message 'Forming serialized JSON for all media files...' $form = @{ chat_id = $ChatID; disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent media = '' } $json = @' [ '@ $i = 1 foreach ($file in $FilePaths) { $fInfo = $null try { $fInfo = Get-Item -Path $file -ErrorAction Stop } catch { throw ('An issue was encountered retrieving data from: {0}' -f $file) } $Form += @{"$MediaType$i" = $fInfo } $json += "{`"type`":`"$MediaType`",`"`media`":`"attach://$MediaType$i`"}," $i++ } $json = $json.Substring(0, $json.Length - 1) $json += @' ] '@ $Form.media = $json Write-Verbose -Message 'JSON formation completed.' $uri = 'https://api.telegram.org/bot{0}/sendMediaGroup' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending media...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } Write-Verbose -Message 'Sending media...' try { $results = Invoke-RestMethod @invokeRestMethodSplat Write-Verbose -Message 'Media sent.' } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram photo message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramMediaGroup <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramPoll { [CmdletBinding(DefaultParameterSetName = 'default')] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Poll question')] [ValidateLength(1, 300)] [string]$Question, [Parameter(Mandatory = $true, HelpMessage = 'String array of answer options')] [ValidateNotNullOrEmpty()] [string[]]$Options, [Parameter(Mandatory = $false, HelpMessage = 'Set the poll to be anonymous or not')] [bool]$IsAnonymous = $true, #default is anonymous [Parameter(Mandatory = $false, HelpMessage = 'Poll Type')] [ValidateSet('quiz', 'regular')] [string]$PollType = 'regular', #default is regular [Parameter(Mandatory = $false, HelpMessage = 'Poll allows multiple answers - ignored in quiz mode')] [bool]$MultipleAnswers = $false, #default is false [Parameter(Mandatory = $false, HelpMessage = 'Quiz answer designator')] [int]$QuizAnswer, [Parameter(Mandatory = $false, HelpMessage = 'Text that is shown when a user chooses an incorrect answer')] [string]$Explanation, [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for explanation formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ExplanationParseMode = 'HTML', #set to HTML by default [Parameter(ParameterSetName = 'OpenPeriod', Mandatory = $false, HelpMessage = 'Time in seconds the poll/quiz will be active after creation')] [ValidateRange(5, 600)] [int]$OpenPeriod, [Parameter(ParameterSetName = 'OpenDate', Mandatory = $false, HelpMessage = 'Point in time when the poll will be automatically closed.')] [datetime]$CloseDate, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Testing poll options...' $optionEval = Test-PollOptions -PollOptions $Options if ($optionEval -eq $false) { throw 'Poll options do not meet Telegram requirements' } Write-Verbose -Message 'Converting options to json format...' $Options = $Options | ConvertTo-Json $form = @{ chat_id = $ChatID question = $Question disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent options = $Options is_anonymous = $IsAnonymous type = $PollType allows_multiple_answers = $MultipleAnswers } #form if ($PollType -eq 'quiz') { Write-Verbose -Message 'Processing quiz...' Write-Verbose -Message ('Quiz answer: {0}' -f $QuizAnswer) if (-not ($QuizAnswer -ge 0 -and $QuizAnswer -le 9)) { throw 'When PollType is quiz, you must supply a QuizAnswer designator between 0-9.' } else { $Form += @{correct_option_id = $QuizAnswer } if ($Explanation) { $explanationEval = Test-Explanation -Explanation $Explanation if ($explanationEval -eq $false) { throw 'Explanation does not meet Telegram requirements.' } $Form += @{explanation = $Explanation } $Form += @{explanation_parse_mode = $ExplanationParseMode } } } } if ($OpenPeriod) { $Form += @{open_period = $OpenPeriod } } if ($CloseDate) { $Form += @{close_date = (New-TimeSpan -Start (Get-Date) -End $CloseDate).TotalSeconds } } $uri = 'https://api.telegram.org/bot{0}/sendPoll' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending poll...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram poll:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramPoll <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramSticker { [CmdletBinding()] param ( [Parameter(ParameterSetName = 'FileIDG')] [Parameter(ParameterSetName = 'FileEmojiG')] [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(ParameterSetName = 'FileIDG')] [Parameter(ParameterSetName = 'FileEmojiG')] [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(ParameterSetName = 'FileIDG')] [Parameter(Mandatory = $true, ParameterSetName = 'ByFileID', HelpMessage = 'Telegram sticker file_id')] [string]$FileID, [Parameter(ParameterSetName = 'FileEmojiG')] [Parameter(Mandatory = $true, ParameterSetName = 'BySPShortCode', HelpMessage = 'Name of the sticker set')] [string]$StickerSetName, [Parameter(ParameterSetName = 'FileEmojiG')] [Parameter(Mandatory = $true, ParameterSetName = 'BySPShortCode', HelpMessage = 'Emoji shortcode')] [ValidateSet( ':hash:', ':keycap_star:', ':zero:', ':one:', ':two:', ':three:', ':four:', ':five:', ':six:', ':seven:', ':eight:', ':nine:', ':copyright:', ':registered:', ':mahjong:', ':black_joker:', ':a:', ':b:', ':o2:', ':parking:', ':ab:', ':cl:', ':cool:', ':free:', ':id:', ':new:', ':ng:', ':ok:', ':sos:', ':up:', ':vs:', ':flag-ac:', ':flag-ad:', ':flag-ae:', ':flag-af:', ':flag-ag:', ':flag-ai:', ':flag-al:', ':flag-am:', ':flag-ao:', ':flag-aq:', ':flag-ar:', ':flag-as:', ':flag-at:', ':flag-au:', ':flag-aw:', ':flag-ax:', ':flag-az:', ':flag-ba:', ':flag-bb:', ':flag-bd:', ':flag-be:', ':flag-bf:', ':flag-bg:', ':flag-bh:', ':flag-bi:', ':flag-bj:', ':flag-bl:', ':flag-bm:', ':flag-bn:', ':flag-bo:', ':flag-bq:', ':flag-br:', ':flag-bs:', ':flag-bt:', ':flag-bv:', ':flag-bw:', ':flag-by:', ':flag-bz:', ':flag-ca:', ':flag-cc:', ':flag-cd:', ':flag-cf:', ':flag-cg:', ':flag-ch:', ':flag-ci:', ':flag-ck:', ':flag-cl:', ':flag-cm:', ':cn:', ':flag-co:', ':flag-cp:', ':flag-cr:', ':flag-cu:', ':flag-cv:', ':flag-cw:', ':flag-cx:', ':flag-cy:', ':flag-cz:', ':de:', ':flag-dg:', ':flag-dj:', ':flag-dk:', ':flag-dm:', ':flag-do:', ':flag-dz:', ':flag-ea:', ':flag-ec:', ':flag-ee:', ':flag-eg:', ':flag-eh:', ':flag-er:', ':es:', ':flag-et:', ':flag-eu:', ':flag-fi:', ':flag-fj:', ':flag-fk:', ':flag-fm:', ':flag-fo:', ':fr:', ':flag-ga:', ':gb:', ':flag-gd:', ':flag-ge:', ':flag-gf:', ':flag-gg:', ':flag-gh:', ':flag-gi:', ':flag-gl:', ':flag-gm:', ':flag-gn:', ':flag-gp:', ':flag-gq:', ':flag-gr:', ':flag-gs:', ':flag-gt:', ':flag-gu:', ':flag-gw:', ':flag-gy:', ':flag-hk:', ':flag-hm:', ':flag-hn:', ':flag-hr:', ':flag-ht:', ':flag-hu:', ':flag-ic:', ':flag-id:', ':flag-ie:', ':flag-il:', ':flag-im:', ':flag-in:', ':flag-io:', ':flag-iq:', ':flag-ir:', ':flag-is:', ':it:', ':flag-je:', ':flag-jm:', ':flag-jo:', ':jp:', ':flag-ke:', ':flag-kg:', ':flag-kh:', ':flag-ki:', ':flag-km:', ':flag-kn:', ':flag-kp:', ':kr:', ':flag-kw:', ':flag-ky:', ':flag-kz:', ':flag-la:', ':flag-lb:', ':flag-lc:', ':flag-li:', ':flag-lk:', ':flag-lr:', ':flag-ls:', ':flag-lt:', ':flag-lu:', ':flag-lv:', ':flag-ly:', ':flag-ma:', ':flag-mc:', ':flag-md:', ':flag-me:', ':flag-mf:', ':flag-mg:', ':flag-mh:', ':flag-mk:', ':flag-ml:', ':flag-mm:', ':flag-mn:', ':flag-mo:', ':flag-mp:', ':flag-mq:', ':flag-mr:', ':flag-ms:', ':flag-mt:', ':flag-mu:', ':flag-mv:', ':flag-mw:', ':flag-mx:', ':flag-my:', ':flag-mz:', ':flag-na:', ':flag-nc:', ':flag-ne:', ':flag-nf:', ':flag-ng:', ':flag-ni:', ':flag-nl:', ':flag-no:', ':flag-np:', ':flag-nr:', ':flag-nu:', ':flag-nz:', ':flag-om:', ':flag-pa:', ':flag-pe:', ':flag-pf:', ':flag-pg:', ':flag-ph:', ':flag-pk:', ':flag-pl:', ':flag-pm:', ':flag-pn:', ':flag-pr:', ':flag-ps:', ':flag-pt:', ':flag-pw:', ':flag-py:', ':flag-qa:', ':flag-re:', ':flag-ro:', ':flag-rs:', ':ru:', ':flag-rw:', ':flag-sa:', ':flag-sb:', ':flag-sc:', ':flag-sd:', ':flag-se:', ':flag-sg:', ':flag-sh:', ':flag-si:', ':flag-sj:', ':flag-sk:', ':flag-sl:', ':flag-sm:', ':flag-sn:', ':flag-so:', ':flag-sr:', ':flag-ss:', ':flag-st:', ':flag-sv:', ':flag-sx:', ':flag-sy:', ':flag-sz:', ':flag-ta:', ':flag-tc:', ':flag-td:', ':flag-tf:', ':flag-tg:', ':flag-th:', ':flag-tj:', ':flag-tk:', ':flag-tl:', ':flag-tm:', ':flag-tn:', ':flag-to:', ':flag-tr:', ':flag-tt:', ':flag-tv:', ':flag-tw:', ':flag-tz:', ':flag-ua:', ':flag-ug:', ':flag-um:', ':flag-un:', ':us:', ':flag-uy:', ':flag-uz:', ':flag-va:', ':flag-vc:', ':flag-ve:', ':flag-vg:', ':flag-vi:', ':flag-vn:', ':flag-vu:', ':flag-wf:', ':flag-ws:', ':flag-xk:', ':flag-ye:', ':flag-yt:', ':flag-za:', ':flag-zm:', ':flag-zw:', ':koko:', ':sa:', ':u7121:', ':u6307:', ':u7981:', ':u7a7a:', ':u5408:', ':u6e80:', ':u6709:', ':u6708:', ':u7533:', ':u5272:', ':u55b6:', ':ideograph_advantage:', ':accept:', ':cyclone:', ':foggy:', ':closed_umbrella:', ':night_with_stars:', ':sunrise_over_mountains:', ':sunrise:', ':city_sunset:', ':city_sunrise:', ':rainbow:', ':bridge_at_night:', ':ocean:', ':volcano:', ':milky_way:', ':earth_africa:', ':earth_americas:', ':earth_asia:', ':globe_with_meridians:', ':new_moon:', ':waxing_crescent_moon:', ':first_quarter_moon:', ':moon:', ':full_moon:', ':waning_gibbous_moon:', ':last_quarter_moon:', ':waning_crescent_moon:', ':crescent_moon:', ':new_moon_with_face:', ':first_quarter_moon_with_face:', ':last_quarter_moon_with_face:', ':full_moon_with_face:', ':sun_with_face:', ':star2:', ':stars:', ':thermometer:', ':mostly_sunny:', ':barely_sunny:', ':partly_sunny_rain:', ':rain_cloud:', ':snow_cloud:', ':lightning:', ':tornado:', ':fog:', ':wind_blowing_face:', ':hotdog:', ':taco:', ':burrito:', ':chestnut:', ':seedling:', ':evergreen_tree:', ':deciduous_tree:', ':palm_tree:', ':cactus:', ':hot_pepper:', ':tulip:', ':cherry_blossom:', ':rose:', ':hibiscus:', ':sunflower:', ':blossom:', ':corn:', ':ear_of_rice:', ':herb:', ':four_leaf_clover:', ':maple_leaf:', ':fallen_leaf:', ':leaves:', ':mushroom:', ':tomato:', ':eggplant:', ':grapes:', ':melon:', ':watermelon:', ':tangerine:', ':lemon:', ':banana:', ':pineapple:', ':apple:', ':green_apple:', ':pear:', ':peach:', ':cherries:', ':strawberry:', ':hamburger:', ':pizza:', ':meat_on_bone:', ':poultry_leg:', ':rice_cracker:', ':rice_ball:', ':rice:', ':curry:', ':ramen:', ':spaghetti:', ':bread:', ':fries:', ':sweet_potato:', ':dango:', ':oden:', ':sushi:', ':fried_shrimp:', ':fish_cake:', ':icecream:', ':shaved_ice:', ':ice_cream:', ':doughnut:', ':cookie:', ':chocolate_bar:', ':candy:', ':lollipop:', ':custard:', ':honey_pot:', ':cake:', ':bento:', ':stew:', ':fried_egg:', ':fork_and_knife:', ':tea:', ':sake:', ':wine_glass:', ':cocktail:', ':tropical_drink:', ':beer:', ':beers:', ':baby_bottle:', ':knife_fork_plate:', ':champagne:', ':popcorn:', ':ribbon:', ':gift:', ':birthday:', ':jack_o_lantern:', ':christmas_tree:', ':santa:', ':fireworks:', ':sparkler:', ':balloon:', ':tada:', ':confetti_ball:', ':tanabata_tree:', ':crossed_flags:', ':bamboo:', ':dolls:', ':flags:', ':wind_chime:', ':rice_scene:', ':school_satchel:', ':mortar_board:', ':medal:', ':reminder_ribbon:', ':studio_microphone:', ':level_slider:', ':control_knobs:', ':film_frames:', ':admission_tickets:', ':carousel_horse:', ':ferris_wheel:', ':roller_coaster:', ':fishing_pole_and_fish:', ':microphone:', ':movie_camera:', ':cinema:', ':headphones:', ':art:', ':tophat:', ':circus_tent:', ':ticket:', ':clapper:', ':performing_arts:', ':video_game:', ':dart:', ':slot_machine:', ':8ball:', ':game_die:', ':bowling:', ':flower_playing_cards:', ':musical_note:', ':notes:', ':saxophone:', ':guitar:', ':musical_keyboard:', ':trumpet:', ':violin:', ':musical_score:', ':running_shirt_with_sash:', ':tennis:', ':ski:', ':basketball:', ':checkered_flag:', ':snowboarder:', ':woman-running:', ':man-running:', ':runner:', ':woman-surfing:', ':man-surfing:', ':surfer:', ':sports_medal:', ':trophy:', ':horse_racing:', ':football:', ':rugby_football:', ':woman-swimming:', ':man-swimming:', ':swimmer:', ':woman-lifting-weights:', ':man-lifting-weights:', ':weight_lifter:', ':woman-golfing:', ':man-golfing:', ':golfer:', ':racing_motorcycle:', ':racing_car:', ':cricket_bat_and_ball:', ':volleyball:', ':field_hockey_stick_and_ball:', ':ice_hockey_stick_and_puck:', ':table_tennis_paddle_and_ball:', ':snow_capped_mountain:', ':camping:', ':beach_with_umbrella:', ':building_construction:', ':house_buildings:', ':cityscape:', ':derelict_house_building:', ':classical_building:', ':desert:', ':desert_island:', ':national_park:', ':stadium:', ':house:', ':house_with_garden:', ':office:', ':post_office:', ':european_post_office:', ':hospital:', ':bank:', ':atm:', ':hotel:', ':love_hotel:', ':convenience_store:', ':school:', ':department_store:', ':factory:', ':izakaya_lantern:', ':japanese_castle:', ':european_castle:', ':rainbow-flag:', ':waving_white_flag:', ':pirate_flag:', ':flag-england:', ':flag-scotland:', ':flag-wales:', ':waving_black_flag:', ':rosette:', ':label:', ':badminton_racquet_and_shuttlecock:', ':bow_and_arrow:', ':amphora:', ':skin-tone-2:', ':skin-tone-3:', ':skin-tone-4:', ':skin-tone-5:', ':skin-tone-6:', ':rat:', ':mouse2:', ':ox:', ':water_buffalo:', ':cow2:', ':tiger2:', ':leopard:', ':rabbit2:', ':cat2:', ':dragon:', ':crocodile:', ':whale2:', ':snail:', ':snake:', ':racehorse:', ':ram:', ':goat:', ':sheep:', ':monkey:', ':rooster:', ':chicken:', ':dog2:', ':pig2:', ':boar:', ':elephant:', ':octopus:', ':shell:', ':bug:', ':ant:', ':bee:', ':beetle:', ':fish:', ':tropical_fish:', ':blowfish:', ':turtle:', ':hatching_chick:', ':baby_chick:', ':hatched_chick:', ':bird:', ':penguin:', ':koala:', ':poodle:', ':dromedary_camel:', ':camel:', ':dolphin:', ':mouse:', ':cow:', ':tiger:', ':rabbit:', ':cat:', ':dragon_face:', ':whale:', ':horse:', ':monkey_face:', ':dog:', ':pig:', ':frog:', ':hamster:', ':wolf:', ':bear:', ':panda_face:', ':pig_nose:', ':feet:', ':chipmunk:', ':eyes:', ':eye-in-speech-bubble:', ':eye:', ':ear:', ':nose:', ':lips:', ':tongue:', ':point_up_2:', ':point_down:', ':point_left:', ':point_right:', ':facepunch:', ':wave:', ':ok_hand:', ':+1:', ':-1:', ':clap:', ':open_hands:', ':crown:', ':womans_hat:', ':eyeglasses:', ':necktie:', ':shirt:', ':jeans:', ':dress:', ':kimono:', ':bikini:', ':womans_clothes:', ':purse:', ':handbag:', ':pouch:', ':mans_shoe:', ':athletic_shoe:', ':high_heel:', ':sandal:', ':boot:', ':footprints:', ':bust_in_silhouette:', ':busts_in_silhouette:', ':boy:', ':girl:', ':male-farmer:', ':male-cook:', ':male-student:', ':male-singer:', ':male-artist:', ':male-teacher:', ':male-factory-worker:', ':man-boy-boy:', ':man-boy:', ':man-girl-boy:', ':man-girl-girl:', ':man-girl:', ':man-man-boy:', ':man-man-boy-boy:', ':man-man-girl:', ':man-man-girl-boy:', ':man-man-girl-girl:', ':man-woman-boy:', ':man-woman-boy-boy:', ':man-woman-girl:', ':man-woman-girl-boy:', ':man-woman-girl-girl:', ':male-technologist:', ':male-office-worker:', ':male-mechanic:', ':male-scientist:', ':male-astronaut:', ':male-firefighter:', ':male_red_haired:', ':male_curly_haired:', ':male_bald:', ':male_white_haired:', ':male-doctor:', ':male-judge:', ':male-pilot:', ':man-heart-man:', ':man-kiss-man:', ':man:', ':female-farmer:', ':female-cook:', ':female-student:', ':female-singer:', ':female-artist:', ':female-teacher:', ':female-factory-worker:', ':woman-boy-boy:', ':woman-boy:', ':woman-girl-boy:', ':woman-girl-girl:', ':woman-girl:', ':woman-woman-boy:', ':woman-woman-boy-boy:', ':woman-woman-girl:', ':woman-woman-girl-boy:', ':woman-woman-girl-girl:', ':female-technologist:', ':female-office-worker:', ':female-mechanic:', ':female-scientist:', ':female-astronaut:', ':female-firefighter:', ':female_red_haired:', ':female_curly_haired:', ':female_bald:', ':female_white_haired:', ':female-doctor:', ':female-judge:', ':female-pilot:', ':woman-heart-man:', ':woman-heart-woman:', ':woman-kiss-man:', ':woman-kiss-woman:', ':woman:', ':family:', ':couple:', ':two_men_holding_hands:', ':two_women_holding_hands:', ':female-police-officer:', ':male-police-officer:', ':cop:', ':woman-with-bunny-ears-partying:', ':man-with-bunny-ears-partying:', ':dancers:', ':bride_with_veil:', ':blond-haired-woman:', ':blond-haired-man:', ':person_with_blond_hair:', ':man_with_gua_pi_mao:', ':woman-wearing-turban:', ':man-wearing-turban:', ':man_with_turban:', ':older_man:', ':older_woman:', ':baby:', ':female-construction-worker:', ':male-construction-worker:', ':construction_worker:', ':princess:', ':japanese_ogre:', ':japanese_goblin:', ':ghost:', ':angel:', ':alien:', ':space_invader:', ':imp:', ':skull:', ':woman-tipping-hand:', ':man-tipping-hand:', ':information_desk_person:', ':female-guard:', ':male-guard:', ':guardsman:', ':dancer:', ':lipstick:', ':nail_care:', ':woman-getting-massage:', ':man-getting-massage:', ':massage:', ':woman-getting-haircut:', ':man-getting-haircut:', ':haircut:', ':barber:', ':syringe:', ':pill:', ':kiss:', ':love_letter:', ':ring:', ':gem:', ':couplekiss:', ':bouquet:', ':couple_with_heart:', ':wedding:', ':heartbeat:', ':broken_heart:', ':two_hearts:', ':sparkling_heart:', ':heartpulse:', ':cupid:', ':blue_heart:', ':green_heart:', ':yellow_heart:', ':purple_heart:', ':gift_heart:', ':revolving_hearts:', ':heart_decoration:', ':diamond_shape_with_a_dot_inside:', ':bulb:', ':anger:', ':bomb:', ':zzz:', ':boom:', ':sweat_drops:', ':droplet:', ':dash:', ':hankey:', ':muscle:', ':dizzy:', ':speech_balloon:', ':thought_balloon:', ':white_flower:', ':100:', ':moneybag:', ':currency_exchange:', ':heavy_dollar_sign:', ':credit_card:', ':yen:', ':dollar:', ':euro:', ':pound:', ':money_with_wings:', ':chart:', ':seat:', ':computer:', ':briefcase:', ':minidisc:', ':floppy_disk:', ':cd:', ':dvd:', ':file_folder:', ':open_file_folder:', ':page_with_curl:', ':page_facing_up:', ':date:', ':calendar:', ':card_index:', ':chart_with_upwards_trend:', ':chart_with_downwards_trend:', ':bar_chart:', ':clipboard:', ':pushpin:', ':round_pushpin:', ':paperclip:', ':straight_ruler:', ':triangular_ruler:', ':bookmark_tabs:', ':ledger:', ':notebook:', ':notebook_with_decorative_cover:', ':closed_book:', ':book:', ':green_book:', ':blue_book:', ':orange_book:', ':books:', ':name_badge:', ':scroll:', ':memo:', ':telephone_receiver:', ':pager:', ':fax:', ':satellite_antenna:', ':loudspeaker:', ':mega:', ':outbox_tray:', ':inbox_tray:', ':package:', ':e-mail:', ':incoming_envelope:', ':envelope_with_arrow:', ':mailbox_closed:', ':mailbox:', ':mailbox_with_mail:', ':mailbox_with_no_mail:', ':postbox:', ':postal_horn:', ':newspaper:', ':iphone:', ':calling:', ':vibration_mode:', ':mobile_phone_off:', ':no_mobile_phones:', ':signal_strength:', ':camera:', ':camera_with_flash:', ':video_camera:', ':tv:', ':radio:', ':vhs:', ':film_projector:', ':prayer_beads:', ':twisted_rightwards_arrows:', ':repeat:', ':repeat_one:', ':arrows_clockwise:', ':arrows_counterclockwise:', ':low_brightness:', ':high_brightness:', ':mute:', ':speaker:', ':sound:', ':loud_sound:', ':battery:', ':electric_plug:', ':mag:', ':mag_right:', ':lock_with_ink_pen:', ':closed_lock_with_key:', ':key:', ':lock:', ':unlock:', ':bell:', ':no_bell:', ':bookmark:', ':link:', ':radio_button:', ':back:', ':end:', ':on:', ':soon:', ':top:', ':underage:', ':keycap_ten:', ':capital_abcd:', ':abcd:', ':1234:', ':symbols:', ':abc:', ':fire:', ':flashlight:', ':wrench:', ':hammer:', ':nut_and_bolt:', ':hocho:', ':gun:', ':microscope:', ':telescope:', ':crystal_ball:', ':six_pointed_star:', ':beginner:', ':trident:', ':black_square_button:', ':white_square_button:', ':red_circle:', ':large_blue_circle:', ':large_orange_diamond:', ':large_blue_diamond:', ':small_orange_diamond:', ':small_blue_diamond:', ':small_red_triangle:', ':small_red_triangle_down:', ':arrow_up_small:', ':arrow_down_small:', ':om_symbol:', ':dove_of_peace:', ':kaaba:', ':mosque:', ':synagogue:', ':menorah_with_nine_branches:', ':clock1:', ':clock2:', ':clock3:', ':clock4:', ':clock5:', ':clock6:', ':clock7:', ':clock8:', ':clock9:', ':clock10:', ':clock11:', ':clock12:', ':clock130:', ':clock230:', ':clock330:', ':clock430:', ':clock530:', ':clock630:', ':clock730:', ':clock830:', ':clock930:', ':clock1030:', ':clock1130:', ':clock1230:', ':candle:', ':mantelpiece_clock:', ':hole:', ':man_in_business_suit_levitating:', ':female-detective:', ':male-detective:', ':sleuth_or_spy:', ':dark_sunglasses:', ':spider:', ':spider_web:', ':joystick:', ':man_dancing:', ':linked_paperclips:', ':lower_left_ballpoint_pen:', ':lower_left_fountain_pen:', ':lower_left_paintbrush:', ':lower_left_crayon:', ':raised_hand_with_fingers_splayed:', ':middle_finger:', ':spock-hand:', ':black_heart:', ':desktop_computer:', ':printer:', ':three_button_mouse:', ':trackball:', ':frame_with_picture:', ':card_index_dividers:', ':card_file_box:', ':file_cabinet:', ':wastebasket:', ':spiral_note_pad:', ':spiral_calendar_pad:', ':compression:', ':old_key:', ':rolled_up_newspaper:', ':dagger_knife:', ':speaking_head_in_silhouette:', ':left_speech_bubble:', ':right_anger_bubble:', ':ballot_box_with_ballot:', ':world_map:', ':mount_fuji:', ':tokyo_tower:', ':statue_of_liberty:', ':japan:', ':moyai:', ':grinning:', ':grin:', ':joy:', ':smiley:', ':smile:', ':sweat_smile:', ':laughing:', ':innocent:', ':smiling_imp:', ':wink:', ':blush:', ':yum:', ':relieved:', ':heart_eyes:', ':sunglasses:', ':smirk:', ':neutral_face:', ':expressionless:', ':unamused:', ':sweat:', ':pensive:', ':confused:', ':confounded:', ':kissing:', ':kissing_heart:', ':kissing_smiling_eyes:', ':kissing_closed_eyes:', ':stuck_out_tongue:', ':stuck_out_tongue_winking_eye:', ':stuck_out_tongue_closed_eyes:', ':disappointed:', ':worried:', ':angry:', ':rage:', ':cry:', ':persevere:', ':triumph:', ':disappointed_relieved:', ':frowning:', ':anguished:', ':fearful:', ':weary:', ':sleepy:', ':tired_face:', ':grimacing:', ':sob:', ':open_mouth:', ':hushed:', ':cold_sweat:', ':scream:', ':astonished:', ':flushed:', ':sleeping:', ':dizzy_face:', ':no_mouth:', ':mask:', ':smile_cat:', ':joy_cat:', ':smiley_cat:', ':heart_eyes_cat:', ':smirk_cat:', ':kissing_cat:', ':pouting_cat:', ':crying_cat_face:', ':scream_cat:', ':slightly_frowning_face:', ':slightly_smiling_face:', ':upside_down_face:', ':face_with_rolling_eyes:', ':woman-gesturing-no:', ':man-gesturing-no:', ':no_good:', ':woman-gesturing-ok:', ':man-gesturing-ok:', ':ok_woman:', ':woman-bowing:', ':man-bowing:', ':bow:', ':see_no_evil:', ':hear_no_evil:', ':speak_no_evil:', ':woman-raising-hand:', ':man-raising-hand:', ':raising_hand:', ':raised_hands:', ':woman-frowning:', ':man-frowning:', ':person_frowning:', ':woman-pouting:', ':man-pouting:', ':person_with_pouting_face:', ':pray:', ':rocket:', ':helicopter:', ':steam_locomotive:', ':railway_car:', ':bullettrain_side:', ':bullettrain_front:', ':train2:', ':metro:', ':light_rail:', ':station:', ':tram:', ':train:', ':bus:', ':oncoming_bus:', ':trolleybus:', ':busstop:', ':minibus:', ':ambulance:', ':fire_engine:', ':police_car:', ':oncoming_police_car:', ':taxi:', ':oncoming_taxi:', ':car:', ':oncoming_automobile:', ':blue_car:', ':truck:', ':articulated_lorry:', ':tractor:', ':monorail:', ':mountain_railway:', ':suspension_railway:', ':mountain_cableway:', ':aerial_tramway:', ':ship:', ':woman-rowing-boat:', ':man-rowing-boat:', ':rowboat:', ':speedboat:', ':traffic_light:', ':vertical_traffic_light:', ':construction:', ':rotating_light:', ':triangular_flag_on_post:', ':door:', ':no_entry_sign:', ':smoking:', ':no_smoking:', ':put_litter_in_its_place:', ':do_not_litter:', ':potable_water:', ':non-potable_water:', ':bike:', ':no_bicycles:', ':woman-biking:', ':man-biking:', ':bicyclist:', ':woman-mountain-biking:', ':man-mountain-biking:', ':mountain_bicyclist:', ':woman-walking:', ':man-walking:', ':walking:', ':no_pedestrians:', ':children_crossing:', ':mens:', ':womens:', ':restroom:', ':baby_symbol:', ':toilet:', ':wc:', ':shower:', ':bath:', ':bathtub:', ':passport_control:', ':customs:', ':baggage_claim:', ':left_luggage:', ':couch_and_lamp:', ':sleeping_accommodation:', ':shopping_bags:', ':bellhop_bell:', ':bed:', ':place_of_worship:', ':octagonal_sign:', ':shopping_trolley:', ':hammer_and_wrench:', ':shield:', ':oil_drum:', ':motorway:', ':railway_track:', ':motor_boat:', ':small_airplane:', ':airplane_departure:', ':airplane_arriving:', ':satellite:', ':passenger_ship:', ':scooter:', ':motor_scooter:', ':canoe:', ':sled:', ':flying_saucer:', ':skateboard:', ':zipper_mouth_face:', ':money_mouth_face:', ':face_with_thermometer:', ':nerd_face:', ':thinking_face:', ':face_with_head_bandage:', ':robot_face:', ':hugging_face:', ':the_horns:', ':call_me_hand:', ':raised_back_of_hand:', ':left-facing_fist:', ':right-facing_fist:', ':handshake:', ':crossed_fingers:', ':i_love_you_hand_sign:', ':face_with_cowboy_hat:', ':clown_face:', ':nauseated_face:', ':rolling_on_the_floor_laughing:', ':drooling_face:', ':lying_face:', ':woman-facepalming:', ':man-facepalming:', ':face_palm:', ':sneezing_face:', ':face_with_raised_eyebrow:', ':star-struck:', ':zany_face:', ':shushing_face:', ':face_with_symbols_on_mouth:', ':face_with_hand_over_mouth:', ':face_vomiting:', ':exploding_head:', ':pregnant_woman:', ':breast-feeding:', ':palms_up_together:', ':selfie:', ':prince:', ':man_in_tuxedo:', ':mrs_claus:', ':woman-shrugging:', ':man-shrugging:', ':shrug:', ':woman-cartwheeling:', ':man-cartwheeling:', ':person_doing_cartwheel:', ':woman-juggling:', ':man-juggling:', ':juggling:', ':fencer:', ':woman-wrestling:', ':man-wrestling:', ':wrestlers:', ':woman-playing-water-polo:', ':man-playing-water-polo:', ':water_polo:', ':woman-playing-handball:', ':man-playing-handball:', ':handball:', ':wilted_flower:', ':drum_with_drumsticks:', ':clinking_glasses:', ':tumbler_glass:', ':spoon:', ':goal_net:', ':first_place_medal:', ':second_place_medal:', ':third_place_medal:', ':boxing_glove:', ':martial_arts_uniform:', ':curling_stone:', ':lacrosse:', ':softball:', ':flying_disc:', ':croissant:', ':avocado:', ':cucumber:', ':bacon:', ':potato:', ':carrot:', ':baguette_bread:', ':green_salad:', ':shallow_pan_of_food:', ':stuffed_flatbread:', ':egg:', ':glass_of_milk:', ':peanuts:', ':kiwifruit:', ':pancakes:', ':dumpling:', ':fortune_cookie:', ':takeout_box:', ':chopsticks:', ':bowl_with_spoon:', ':cup_with_straw:', ':coconut:', ':broccoli:', ':pie:', ':pretzel:', ':cut_of_meat:', ':sandwich:', ':canned_food:', ':leafy_green:', ':mango:', ':moon_cake:', ':bagel:', ':smiling_face_with_3_hearts:', ':partying_face:', ':woozy_face:', ':hot_face:', ':cold_face:', ':pleading_face:', ':lab_coat:', ':goggles:', ':hiking_boot:', ':womans_flat_shoe:', ':crab:', ':lion_face:', ':scorpion:', ':turkey:', ':unicorn_face:', ':eagle:', ':duck:', ':bat:', ':shark:', ':owl:', ':fox_face:', ':butterfly:', ':deer:', ':gorilla:', ':lizard:', ':rhinoceros:', ':shrimp:', ':squid:', ':giraffe_face:', ':zebra_face:', ':hedgehog:', ':sauropod:', ':t-rex:', ':cricket:', ':kangaroo:', ':llama:', ':peacock:', ':hippopotamus:', ':parrot:', ':raccoon:', ':lobster:', ':mosquito:', ':microbe:', ':badger:', ':swan:', ':bone:', ':leg:', ':foot:', ':tooth:', ':female_superhero:', ':male_superhero:', ':female_supervillain:', ':male_supervillain:', ':cheese_wedge:', ':cupcake:', ':salt:', ':face_with_monocle:', ':adult:', ':child:', ':older_adult:', ':bearded_person:', ':person_with_headscarf:', ':woman_in_steamy_room:', ':man_in_steamy_room:', ':person_in_steamy_room:', ':woman_climbing:', ':man_climbing:', ':person_climbing:', ':woman_in_lotus_position:', ':man_in_lotus_position:', ':person_in_lotus_position:', ':female_mage:', ':male_mage:', ':mage:', ':female_fairy:', ':male_fairy:', ':fairy:', ':female_vampire:', ':male_vampire:', ':vampire:', ':mermaid:', ':merman:', ':merperson:', ':female_elf:', ':male_elf:', ':elf:', ':female_genie:', ':male_genie:', ':genie:', ':female_zombie:', ':male_zombie:', ':zombie:', ':brain:', ':orange_heart:', ':billed_cap:', ':scarf:', ':gloves:', ':coat:', ':socks:', ':red_envelope:', ':firecracker:', ':jigsaw:', ':test_tube:', ':petri_dish:', ':dna:', ':compass:', ':abacus:', ':fire_extinguisher:', ':toolbox:', ':bricks:', ':magnet:', ':luggage:', ':lotion_bottle:', ':thread:', ':yarn:', ':safety_pin:', ':teddy_bear:', ':broom:', ':basket:', ':roll_of_paper:', ':soap:', ':sponge:', ':receipt:', ':nazar_amulet:', ':bangbang:', ':interrobang:', ':tm:', ':information_source:', ':left_right_arrow:', ':arrow_up_down:', ':arrow_upper_left:', ':arrow_upper_right:', ':arrow_lower_right:', ':arrow_lower_left:', ':leftwards_arrow_with_hook:', ':arrow_right_hook:', ':watch:', ':hourglass:', ':keyboard:', ':eject:', ':fast_forward:', ':rewind:', ':arrow_double_up:', ':arrow_double_down:', ':black_right_pointing_double_triangle_with_vertical_bar:', ':black_left_pointing_double_triangle_with_vertical_bar:', ':black_right_pointing_triangle_with_double_vertical_bar:', ':alarm_clock:', ':stopwatch:', ':timer_clock:', ':hourglass_flowing_sand:', ':double_vertical_bar:', ':black_square_for_stop:', ':black_circle_for_record:', ':m:', ':black_small_square:', ':white_small_square:', ':arrow_forward:', ':arrow_backward:', ':white_medium_square:', ':black_medium_square:', ':white_medium_small_square:', ':black_medium_small_square:', ':sunny:', ':cloud:', ':umbrella:', ':snowman:', ':comet:', ':phone:', ':ballot_box_with_check:', ':umbrella_with_rain_drops:', ':coffee:', ':shamrock:', ':point_up:', ':skull_and_crossbones:', ':radioactive_sign:', ':biohazard_sign:', ':orthodox_cross:', ':star_and_crescent:', ':peace_symbol:', ':yin_yang:', ':wheel_of_dharma:', ':white_frowning_face:', ':relaxed:', ':female_sign:', ':male_sign:', ':aries:', ':taurus:', ':gemini:', ':cancer:', ':leo:', ':virgo:', ':libra:', ':scorpius:', ':sagittarius:', ':capricorn:', ':aquarius:', ':pisces:', ':chess_pawn:', ':spades:', ':clubs:', ':hearts:', ':diamonds:', ':hotsprings:', ':recycle:', ':infinity:', ':wheelchair:', ':hammer_and_pick:', ':anchor:', ':crossed_swords:', ':medical_symbol:', ':scales:', ':alembic:', ':gear:', ':atom_symbol:', ':fleur_de_lis:', ':warning:', ':zap:', ':white_circle:', ':black_circle:', ':coffin:', ':funeral_urn:', ':soccer:', ':baseball:', ':snowman_without_snow:', ':partly_sunny:', ':thunder_cloud_and_rain:', ':ophiuchus:', ':pick:', ':helmet_with_white_cross:', ':chains:', ':no_entry:', ':shinto_shrine:', ':church:', ':mountain:', ':umbrella_on_ground:', ':fountain:', ':golf:', ':ferry:', ':boat:', ':skier:', ':ice_skate:', ':woman-bouncing-ball:', ':man-bouncing-ball:', ':person_with_ball:', ':tent:', ':fuelpump:', ':scissors:', ':white_check_mark:', ':airplane:', ':email:', ':fist:', ':hand:', ':v:', ':writing_hand:', ':pencil2:', ':black_nib:', ':heavy_check_mark:', ':heavy_multiplication_x:', ':latin_cross:', ':star_of_david:', ':sparkles:', ':eight_spoked_asterisk:', ':eight_pointed_black_star:', ':snowflake:', ':sparkle:', ':x:', ':negative_squared_cross_mark:', ':question:', ':grey_question:', ':grey_exclamation:', ':exclamation:', ':heavy_heart_exclamation_mark_ornament:', ':heart:', ':heavy_plus_sign:', ':heavy_minus_sign:', ':heavy_division_sign:', ':arrow_right:', ':curly_loop:', ':loop:', ':arrow_heading_up:', ':arrow_heading_down:', ':arrow_left:', ':arrow_up:', ':arrow_down:', ':black_large_square:', ':white_large_square:', ':star:', ':o:', ':wavy_dash:', ':part_alternation_mark:', ':congratulations:', ':secret:' )] [string]$Shortcode, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) if ($FileID) { Write-Verbose -Message 'sticker file_id provided.' $sticker = $FileID } #if_fileid else { Write-Verbose -Message 'Sticker by emoji shortcode and sticker pack.' $stickerPackInfo = Get-TelegramStickerPackInfo -BotToken $BotToken -StickerSetName $StickerSetName if (-not ($stickerPackInfo -eq $false)) { $sticker = $stickerPackInfo | Where-Object { $_.Shortcode -eq $Shortcode } | Select-Object -First 1 if (-not $sticker) { throw ('The sticker pack {0} does not contain the emoji {1}' -f $StickerSetName, $Shortcode) } #if_noSticker else { $sticker = $sticker.file_id } #else_noSticker } #if_sticker_info else { throw 'Unable to obtain sticker pack information.' } #else_sticker_info } #else_fileid $form = @{ chat_id = $ChatID sticker = $sticker disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendSticker' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending sticker...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { Write-Verbose -Message 'Sending message...' $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the sticker:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramSticker <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramTextMessage { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Text of the message to be sent')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$Message, [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Custom or inline keyboard object')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [psobject]$Keyboard, [Parameter(Mandatory = $false, HelpMessage = 'Disables link previews')] [switch]$DisablePreview, #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) $payload = @{ chat_id = $ChatID text = $Message parse_mode = $ParseMode disable_web_page_preview = $DisablePreview.IsPresent disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #payload if ($Keyboard) { $payload.Add('reply_markup', $Keyboard) } $uri = 'https://api.telegram.org/bot{0}/sendMessage' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending message...' $invokeRestMethodSplat = @{ Uri = $uri Body = ([System.Text.Encoding]::UTF8.GetBytes((ConvertTo-Json -Compress -InputObject $payload -Depth 50))) ErrorAction = 'Stop' ContentType = 'application/json' Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramTextMessage <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramURLAnimation { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'URL path to animation')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$AnimationURL, [Parameter(Mandatory = $false, HelpMessage = 'animation caption')] [string]$Caption, [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying URL leads to supported animation extension...' $fileTypeEval = Test-URLExtension -URL $AnimationURL -Type Animation if ($fileTypeEval -eq $false) { throw ('The specified animation URL: {0} does not contain a supported extension.' -f $AnimationURL) } #if_animationExtension else { Write-Verbose -Message 'Extension supported.' } #else_animationExtension Write-Verbose -Message 'Verifying URL presence and file size...' $fileSizeEval = Test-URLFileSize -URL $AnimationURL if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_animationSize else { Write-Verbose -Message 'File size verified.' } #else_animationSize $payload = @{ chat_id = $ChatID animation = $AnimationURL caption = $Caption parse_mode = $ParseMode disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #payload $uri = 'https://api.telegram.org/bot{0}/sendAnimation' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending animation...' $invokeRestMethodSplat = @{ Uri = $uri Body = (ConvertTo-Json -Compress -InputObject $payload) ErrorAction = 'Stop' ContentType = 'application/json' Method = 'Post' } try { Write-Verbose -Message 'Sending message...' $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramURLAnimation <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramURLAudio { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Local path to file you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$AudioURL, [Parameter(Mandatory = $false, HelpMessage = 'Caption for file')] [string]$Caption = '', #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Duration of the audio in seconds')] [int]$Duration, [Parameter(Mandatory = $false, HelpMessage = 'Performer')] [string]$Performer, [Parameter(Mandatory = $false, HelpMessage = 'TrackName')] [string]$Title, [Parameter(Mandatory = $false, HelpMessage = 'Original File Name')] [string]$FileName, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying URL leads to supported audio extension...' $fileTypeEval = Test-URLExtension -URL $AudioURL -Type Audio if ($fileTypeEval -eq $false) { throw ('The specified audio URL: {0} does not contain a supported extension.' -f $AudioURL) } #if_audioExtension else { Write-Verbose -Message 'Extension supported.' } #else_audioExtension Write-Verbose -Message 'Verifying URL presence and file size...' $fileSizeEval = Test-URLFileSize -URL $AudioURL if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_audioSize else { Write-Verbose -Message 'File size verified.' } #else_audioSize $payload = @{ chat_id = $ChatID audio = $AudioURL caption = $Caption parse_mode = $ParseMode duration = $Duration performer = $Performer title = $Title file_name = $FileName disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #payload $uri = 'https://api.telegram.org/bot{0}/sendAudio' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending audio...' $invokeRestMethodSplat = @{ Uri = $uri Body = (ConvertTo-Json -Compress -InputObject $payload) ErrorAction = 'Stop' ContentType = 'application/json' Method = 'Post' } try { Write-Verbose -Message 'Sending message...' $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramURLAudio <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramURLDocument { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'URL path to file')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$FileURL, [Parameter(Mandatory = $false, HelpMessage = 'File caption')] [string]$Caption, [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Disables automatic server-side content type detection')] [switch]$DisableContentTypeDetection, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying URL leads to supported document extension...' $fileTypeEval = Test-URLExtension -URL $FileURL -Type Document if ($fileTypeEval -eq $false) { throw ('The specified file URL: {0} does not contain a supported extension.' -f $FileURL) } #if_documentExtension else { Write-Verbose -Message 'Extension supported.' } #else_documentExtension Write-Verbose -Message 'Verifying URL presence and file size...' $fileSizeEval = Test-URLFileSize -URL $FileURL if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_documentSize else { Write-Verbose -Message 'File size verified.' } #else_documentSize $payload = @{ chat_id = $ChatID document = $FileURL caption = $Caption parse_mode = $ParseMode disable_content_type_detection = $DisableContentTypeDetection.IsPresent disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #payload $uri = 'https://api.telegram.org/bot{0}/sendDocument' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending document...' $invokeRestMethodSplat = @{ Uri = $uri Body = (ConvertTo-Json -Compress -InputObject $payload) ErrorAction = 'Stop' ContentType = 'application/json' Method = 'Post' } try { Write-Verbose -Message 'Sending message...' $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramURLDocument <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramURLPhoto { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'URL path to photo')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$PhotoURL, [Parameter(Mandatory = $false, HelpMessage = 'Photo caption')] [string]$Caption, [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying URL leads to supported photo extension...' $fileTypeEval = Test-URLExtension -URL $PhotoURL -Type Photo if ($fileTypeEval -eq $false) { throw ('The specified photo URL: {0} does not contain a supported extension.' -f $AnimationURL) } #if_photoExtension else { Write-Verbose -Message 'Extension supported.' } #else_photoExtension Write-Verbose -Message 'Verifying URL presence and file size...' $fileSizeEval = Test-URLFileSize -URL $PhotoURL if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_photoSize else { Write-Verbose -Message 'File size verified.' } #else_photoSize $payload = @{ chat_id = $ChatID photo = $PhotoURL caption = $Caption parse_mode = $ParseMode disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #payload $uri = 'https://api.telegram.org/bot{0}/sendphoto' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending photo...' $invokeRestMethodSplat = @{ Uri = ('https://api.telegram.org/bot{0}/sendphoto' -f $BotToken) Body = (ConvertTo-Json -Compress -InputObject $payload) ErrorAction = 'Stop' ContentType = 'application/json' Method = 'Post' } try { Write-Verbose -Message 'Sending message...' $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramURLPhoto <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramURLSticker { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'URL path to sticker')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$StickerURL, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying URL leads to supported sticker extension...' $fileTypeEval = Test-URLExtension -URL $StickerURL -Type Sticker if ($fileTypeEval -eq $false) { throw ('The specified sticker URL: {0} does not contain a supported extension.' -f $StickerURL) } #if_stickerExtension else { Write-Verbose -Message 'Extension supported.' } #else_stickerExtension Write-Verbose -Message 'Verifying URL presence and file size...' $fileSizeEval = Test-URLFileSize -URL $StickerURL if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_stickerSize else { Write-Verbose -Message 'File size verified.' } #else_stickerSize $payload = @{ chat_id = $ChatID sticker = $StickerURL disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #payload $uri = 'https://api.telegram.org/bot{0}/sendSticker' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending sticker...' $invokeRestMethodSplat = @{ Uri = $uri Body = (ConvertTo-Json -Compress -InputObject $payload) ErrorAction = 'Stop' ContentType = 'application/json' Method = 'Post' } try { Write-Verbose -Message 'Sending message...' $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramURLSticker <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramURLVideo { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'URL to file you wish to send')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$VideoURL, [Parameter(Mandatory = $false, HelpMessage = 'Duration of video in seconds')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Int32]$Duration, [Parameter(Mandatory = $false, HelpMessage = 'Video width')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Int32]$Width, [Parameter(Mandatory = $false, HelpMessage = 'Video height')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Int32]$Height, [Parameter(Mandatory = $false, HelpMessage = 'Original File Name')] [string]$FileName, [Parameter(Mandatory = $false, HelpMessage = 'Caption for file')] [string]$Caption = '', #set to false by default [Parameter(Mandatory = $false, HelpMessage = 'HTML vs Markdown for message formatting')] [ValidateSet('Markdown', 'MarkdownV2', 'HTML')] [string]$ParseMode = 'HTML', #set to HTML by default [Parameter(Mandatory = $false, HelpMessage = 'Use if the uploaded video is suitable for streaming')] [switch]$Streaming, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) Write-Verbose -Message 'Verifying URL leads to supported document extension...' $fileTypeEval = Test-URLExtension -URL $VideoURL -Type Video if ($fileTypeEval -eq $false) { throw ('The specified Video URL: {0} does not contain a supported extension.' -f $VideoURL) } #if_videoExtension else { Write-Verbose -Message 'Extension supported.' } #else_videoExtension Write-Verbose -Message 'Verifying URL presence and file size...' $fileSizeEval = Test-URLFileSize -URL $VideoURL if ($fileSizeEval -eq $false) { throw 'File size does not meet Telegram requirements' } #if_videoSize else { Write-Verbose -Message 'File size verified.' } #else_videoSize $payload = @{ chat_id = $ChatID video = $VideoURL duration = $Duration width = $Width height = $Height file_name = $FileName caption = $Caption parse_mode = $ParseMode supports_streaming = $Streaming disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #payload $uri = 'https://api.telegram.org/bot{0}/sendVideo' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending video...' $invokeRestMethodSplat = @{ Uri = $uri Body = (ConvertTo-Json -Compress -InputObject $payload) ErrorAction = 'Stop' ContentType = 'application/json' Method = 'Post' } try { Write-Verbose -Message 'Sending message...' $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram message:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramURLVideo <# .EXTERNALHELP PoshGram-help.xml #> function Send-TelegramVenue { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken, #you could set a token right here if you wanted [Parameter(Mandatory = $true, HelpMessage = '-#########')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$ChatID, #you could set a Chat ID right here if you wanted [Parameter(Mandatory = $true, HelpMessage = 'Latitude of the venue')] [ValidateRange(-90, 90)] [single]$Latitude, [Parameter(Mandatory = $true, HelpMessage = 'Longitude of the venue')] [ValidateRange(-180, 180)] [single]$Longitude, [Parameter(Mandatory = $true, HelpMessage = 'Name of the venue')] [ValidateNotNullOrEmpty()] [string]$Title, [Parameter(Mandatory = $true, HelpMessage = 'Address of the venue')] [ValidateNotNullOrEmpty()] [string]$Address, [Parameter(Mandatory = $false, HelpMessage = 'Send the message silently')] [switch]$DisableNotification, [Parameter(Mandatory = $false, HelpMessage = 'Protects the contents of the sent message from forwarding and saving')] [switch]$ProtectContent ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) $form = @{ chat_id = $ChatID latitude = $Latitude longitude = $Longitude title = $Title address = $Address disable_notification = $DisableNotification.IsPresent protect_content = $ProtectContent.IsPresent } #form $uri = 'https://api.telegram.org/bot{0}/sendVenue' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Sending venue...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Form = $form Method = 'Post' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered sending the Telegram venue:' Write-Error $_ if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Send-TelegramVenue <# .EXTERNALHELP PoshGram-help.xml #> function Test-BotToken { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = '#########:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx')] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [string]$BotToken ) Write-Verbose -Message ('Starting: {0}' -f $MyInvocation.Mycommand) $uri = 'https://api.telegram.org/bot{0}/getMe' -f $BotToken Write-Debug -Message ('Base URI: {0}' -f $uri) Write-Verbose -Message 'Testing Bot Token...' $invokeRestMethodSplat = @{ Uri = $uri ErrorAction = 'Stop' Method = 'Get' } try { $results = Invoke-RestMethod @invokeRestMethodSplat } #try_messageSend catch { Write-Warning -Message 'An error was encountered testing the BOT token:' if ($_.ErrorDetails) { $results = $_.ErrorDetails | ConvertFrom-Json -ErrorAction SilentlyContinue } else { throw $_ } } #catch_messageSend return $results } #function_Test-BotToken |