Public/Set-TeamViewerManagedDevice.ps1
|
function Set-TeamViewerManagedDevice { [CmdletBinding(SupportsShouldProcess = $true)] param( [Parameter(Mandatory = $true)] [securestring] $ApiToken, [Parameter(Mandatory = $true, ValueFromPipeline = $true)] [ValidateScript( { $_ | Resolve-TeamViewerManagedDeviceId } )] [Alias("DeviceId")] [object] $Device, [Alias("Alias")] [string] $Name, [ValidateScript( { $_ | Resolve-TeamViewerPolicyId } )] [Alias("PolicyId")] [object] $Policy, [ValidateScript( { $_ | Resolve-TeamViewerManagedGroupId } )] [Alias("ManagedGroupId")] [object] $ManagedGroup, [switch] $RemovePolicy ) Begin { $body = @{} if ($Name) { $body['name'] = $Name } if ($Policy) { $body['teamviewerPolicyId'] = $Policy | Resolve-TeamViewerPolicyId } elseif ($RemovePolicy) { $body['teamviewerPolicyId'] = "" } elseif ($ManagedGroup) { $body['managedGroupId'] = $ManagedGroup | Resolve-TeamViewerManagedGroupId } if ($Policy -And $RemovePolicy) { $PSCmdlet.ThrowTerminatingError( ("Parameters -Policy and -RemovePolicy cannot be used together." | ` ConvertTo-ErrorRecord -ErrorCategory InvalidArgument)) } if (($Policy -or $RemovePolicy) -And $ManagedGroup) { $PSCmdlet.ThrowTerminatingError( ("The combination of parameters -Policy, -PolicyRemove and -ManagedGroup is not allowed." | ` ConvertTo-ErrorRecord -ErrorCategory InvalidArgument)) } if ($body.Count -eq 0) { $PSCmdlet.ThrowTerminatingError( ("The given input does not change the managed device." | ` ConvertTo-ErrorRecord -ErrorCategory InvalidArgument)) } } Process { $deviceId = $Device | Resolve-TeamViewerManagedDeviceId $resourceUri = "$(Get-TeamViewerApiUri)/managed/devices/$deviceId" if ($PSCmdlet.ShouldProcess($Device.ToString(), "Change managed device entry")) { Invoke-TeamViewerRestMethod ` -ApiToken $ApiToken ` -Uri $resourceUri ` -Method Put ` -ContentType "application/json; charset=utf-8" ` -Body ([System.Text.Encoding]::UTF8.GetBytes(($body | ConvertTo-Json))) ` -WriteErrorTo $PSCmdlet ` -ErrorAction Stop | ` Out-Null } } } |