RAps

1.0.3

Functions/Invitations/New-RAInvitation.ps1

function New-RAInvitation {
    [CmdletBinding(
        SupportsShouldProcess,
        ConfirmImpact = 'Medium'
    )]
    [OutputType([string])]
    param (

        [Parameter(
            Mandatory,
            HelpMessage = 'Enter all properties of the Invitation Request'
        )]
        [HashTable]$InvitationRequest,

        [Parameter(
            HelpMessage = 'Select this flag if you invite a Remote Access user'
        )]
        [switch]$UserInvitation
    )

    begin {

    }

    process {
        if ($UserInvitation) {
            $url = "https://$($Script:ApiURL)/v2-edge/invitations/user-invitations"
        } else {
            $url = "https://$($Script:ApiURL)/v2-edge/invitations/vendor-invitations"
        }
        $restCall = @{
            'Method'         = 'Post'
            'Uri'            = $url
            'Body'           = ($InvitationRequest | ConvertTo-Json -Depth 3)
            'WebSession'     = $Script:WebSession
            'ContentType'    = $Script:ContentType
        }
        if ($PSCmdlet.ShouldProcess('Remote Access Invitation', 'Creating a new invitation')) {
            $result = Invoke-RestMethod @restCall
        }
    }

    end {
        Write-Output -InputObject $result
    }
}