Timetabler

0.3

public/Remove-CTRole.ps1

function Remove-CTRole {
    [CmdletBinding(SupportsShouldProcess)]
    param (
        [Parameter(Mandatory, Position=0, ValueFromPipelineByPropertyName)]
        [Alias('id')]
        [string] $RoleId
    )

    begin {
        $url = $Script:_ctUri
        $token = $Script:_ctApiCode
        
        if (!$url -or !$token) {
            throw 'You must call the Connect-CT cmdlet before calling any other cmdlets.'
        }
    
        $headers = @{
            ApiCode = $token
        }

        if ($Script:_ctTimetableId) {
            $headers.TimetableId = $Script:_ctTimetableId
        }
    }

    process {
        $path = "/api/roles/$RoleId"

        $uri = [uri]::new($url, $path)

        if ($PSCmdlet.ShouldProcess($RoleId, 'Delete role.')) {
            Invoke-RestMethod -Uri $uri -Headers $headers -Method Delete
        }
    }
}