Add-SCSMSRComment.ps1

Function Add-SCSMSRComment {
    <#
.SYNOPSIS
    Function to add a comment inside a Service Request

.DESCRIPTION
    Function to add a comment inside a Service Request
    You need to have SMlets installed and permission to write inside
    the service request.

.PARAMETER ServiceRequestObject
    Specifies the ServiceRequest where the comment will be added

.PARAMETER Comment
    Specifies the comment to add.

.PARAMETER CommentType
    Specifies the comment type.
    You need to specify 'User' or 'Analyst'.

.PARAMETER EnteredBy
    Specifies your name.

.PARAMETER IsPrivate
    Specifies if the switch is private

.EXAMPLE
    Add-SCSMSRComment -ServiceRequestObject $SR -Comment "Task Completed" -CommentType Analyst -EnteredBy 'Francois-Xavier Cat'

.EXAMPLE
    Add-SCSMSRComment -ServiceRequestObject $SR -Comment "Task Completed" -CommentType Analyst -EnteredBy 'Francois-Xavier Cat' -IsPrivate

.NOTES
    Francois-Xavier Cat
    lazywinadmin.com
    @lazywinadmin

    Script inspired from http://www.scsm.se/?p=1423 by Anders Asp
.LINK
    https://github.com/lazywinadmin/PowerShell
#>
    [CmdletBinding()]
    PARAM (

        [Alias("SRObject")]
        [parameter(Mandatory = $true)]
        #[System.WorkItem.ServiceRequest]
        $ServiceRequestObject,

        [parameter(Mandatory = $True)]
        [String]$Comment,

        [ValidateSet("User", "Analyst")]
        [parameter(Mandatory = $True)]
        #[System.WorkItem.TroubleTicket]
        [String]$CommentType,

        [parameter(Mandatory = $True)]
        [String]$EnteredBy,

        [Switch]$IsPrivate
    )
    BEGIN {
        TRY {
            if (-not (Get-Module -Name Smlets)) {
                Import-Module -Name Smlets -ErrorAction 'Stop'
            }
        }
        CATCH {
            $PSCmdlet.ThrowTerminatingError($_)
        }
    }
    PROCESS {
        TRY {
            # Make sure that the SR Object it passed to the function
            If ($null -eq $ServiceRequestObject.Id) {
                Switch ($CommentType) {
                    "Analyst" {
                        $CommentClass = "System.WorkItem.TroubleTicket.AnalystCommentLog"
                        #$CommentClassName = "AnalystCommentLog"
                    }
                    "User" {
                        $CommentClass = "System.WorkItem.TroubleTicket.UserCommentLog"
                        #$CommentClassName = "EndUserCommentLog"
                    }
                }
                # Generate a new GUID for the comment
                $NewGUID = ([guid]::NewGuid()).ToString()

                # Create the object projection with properties
                $Projection = @{
                    __CLASS           = "System.WorkItem.ServiceRequest";
                    __SEED            = $ServiceRequestObject;
                    EndUserCommentLog = @{
                        __CLASS  = $CommentClass;
                        __OBJECT = @{
                            Id          = $NewGUID;
                            DisplayName = $NewGUID;
                            Comment     = $Comment;
                            EnteredBy   = $EnteredBy;
                            EnteredDate = (Get-Date).ToUniversalTime();
                            IsPrivate   = $IsPrivate.ToBool();
                        }
                    }
                }

                # Create the actual comment
                New-SCSMObjectProjection -Type "System.WorkItem.ServiceRequestProjection" -Projection $Projection
            }
            else {
                Throw "Invalid Service Request Object!"
            }
        }
        CATCH {
            $PSCmdlet.ThrowTerminatingError($_)
        } #CATCH
    } #PROCESS
}