Public/Set-DwTaskValueDate.ps1
|
function Set-DwTaskValueDate { <# .SYNOPSIS Updates a project date task. .DESCRIPTION Updates a project task. This cannot be used to clear the date value. Takes TaskId, ProjectID, ObjectKey, Value and SlotId (optional) as inputs. .PARAMETER Instance Dashworks instance. For example, https://myinstance.dashworks.app:8443 .PARAMETER APIKey Dashworks API Key. .PARAMETER TaskId TaskId of the task to be updated. .PARAMETER ProjectId The projectId of the task being updated. .PARAMETER ObjectKey The projectId of the task being updated. .PARAMETER Value An ISO 8601 formatted date string to set the task to. EG ('2022-01-01') .PARAMETER SlotId Optional: The slot to set the task to. The slotId is not validated. .PARAMETER ObjectType The type of object being updated. .EXAMPLE PS> Set-DwTaskValueDate -Instance "https://myinstance.dashworks.app:8443" -APIKey "xxxxx" -ObjectKey 12345 -ObjectType Device -TaskId 123 -ProjectId 85 -Value '2022-01-01' -SlotId 34 #> [CmdletBinding(SupportsShouldProcess)] param( [Parameter(Mandatory=$true)] [string]$Instance, [Parameter(Mandatory=$true)] [string]$APIKey, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [int]$TaskId, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [int]$ProjectId, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [int]$ObjectKey, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string]$Value, [Parameter(Mandatory = $false)] [string]$SlotId, [Parameter(Mandatory = $true)] [ValidateSet("Device", "User", "Application", "Mailbox")] [string]$ObjectType ) $path = switch($ObjectType) { "Device" {"device"} "User" {"user"} "Application" {"application"} "Mailbox" {"mailbox"} } $uri = '{0}/apiv1/{1}/{2}/projectTasksDateAndSlot' -f $Instance, $path, $ObjectKey $headers = @{ 'x-api-key' = $APIKey 'content-type' = 'application/Json' } $params = @{ 'value'=$Value 'projectid'=$ProjectID 'taskid'=$TaskID } if ($SlotId) { $params.add("slotid",$SlotID) } $body = $params | ConvertTo-Json try { if ($PSCmdlet.ShouldProcess($ObjectKey)) { $response = Invoke-WebRequest -Uri $uri -Headers $headers -Body $body -Method PUT $results = ($response.Content | ConvertFrom-Json).results return $results } } catch { Write-Error $_ } } |