Public/Add-GistComment.ps1

Function Add-GistComment {
    [CmdletBinding(
        HelpUri = 'http://dotps1.github.io/PSGist/Add-GistComment.html'
    )]
    [OutputType(
        [GistComment]
    )]

    Param (
        [Parameter(
            HelpMessage = 'The Id of the Gist Object.',
            Mandatory = $true,
            ValueFromPipelineByPropertyName = $true
        )]
        [String]
        $Id,
    
        [Parameter(
            HelpMessage = 'The comment content.',
            Mandatory = $true,
            ValueFromPipelineByPropertyName = $true
        )]
        [String]
        $Comment
    )
    
    Process {
        [HashTable]$body = @{
            body = $Comment
        }
        
        $apiCall = @{
            Body = ConvertTo-Json -InputObject $body -Compress
            RestMethod = 'gists/{0}/comments' -f $Id
            Method = 'POST' 
        }
        
        [GistComment]::new(
            (Invoke-GistApi @apiCall), $Id   
        )
    }
}