WhatsUpGoldPS

0.1.5

functions/Set-WUGDeviceProperties.ps1

                                <#

.SYNOPSIS

Sets properties of one or more devices in WhatsUp Gold.

.SYNTAX

Set-WUGDeviceProperties [-DeviceID] <array> [[-DisplayName] <string>] [[-isWireless] <boolean>] [[-collectWireless] <boolean>] [[-keepDetailsCurrent] <boolean>] [[-note] <string>] [[-snmpOid] <string>] [[-actionPolicy] <array>]

.DESCRIPTION

The Set-WUGDeviceProperties function allows you to set properties for one or more devices in WhatsUp Gold. You can specify the device ID(s) using the -DeviceID parameter. If you do not specify this parameter, you will be prompted to enter the device ID(s). Other parameters allow you to specify various properties to set for the devices.

PARAMETERS

.PARAMETER DeviceID <array>

    Specifies the device ID(s) of the device(s) for which you want to set properties. This parameter is mandatory.

.PARAMETER DisplayName <string>

    Specifies the display name of the device. Default is null.

.PARAMETER  isWireless <boolean>

    Specifies whether the device is a wireless device. Default is null.

.PARAMETER collectWireless <boolean>

    Specifies whether wireless information should be collected for the device. Default is null.

.PARAMETER keepDetailsCurrent <boolean>

    Specifies whether details should be kept current for the device. Default is null.

.PARAMETER note <string>

    Specifies notes for the device. Default is null.

.PARAMETER snmpOid <string>

    Specifies the SNMP OID for the device. Default is null.

.PARAMETER actionPolicy <array>

    Specifies the action policy for the device. Default is null.

.NOTES

    Author: Jason Alberino (jason@wug.ninja) 2023-03-24

    Last modified: Let's see your name here YYYY-MM-DD

#>

function Set-WUGDeviceProperties {

    param (

        [Parameter(Mandatory = $true)] [array] $DeviceID,

        [Parameter()] [string] $DisplayName,

        [Parameter()] [boolean] $isWireless,

        [Parameter()] [boolean] $collectWireless,

        [Parameter()] [boolean] $keepDetailsCurrent,

        [Parameter()] [string] $note,

        [Parameter()] [string] $snmpOid,

        [Parameter()] [string] $actionPolicyName,

        [Parameter()] [string] $actionPolicyId

        #[Parameter()][string]$JsonData

    )

    # Your existing code to make the API call using $JsonData

    # TBD using call from Get-WUGDeviceTemplate or Get-WUGDeviceProperties

    #Global variables error checking

    if (-not $global:WUGBearerHeaders) { Write-Error -Message "Authorization header not set, running Connect-WUGServer"; Connect-WUGServer; }

    if ((Get-Date) -ge $global:expiry) { Write-Error -Message "Token expired, running Connect-WUGServer"; Connect-WUGServer; } else { Request-WUGAuthToken }

    if (-not $global:WhatsUpServerBaseURI) { Write-Error "Base URI not found. running Connect-WUGServer"; Connect-WUGServer; }

    #End global variables error checking

    #Input validation here

    #Array validations

    #actionPolicy

    #DeviceID

    if (!$DeviceID) { $DeviceID = Write-Error "You must specify the DeviceID."; $DeviceID = Read-Host "Enter a DeviceID or IDs, separated by commas"; $DeviceID = $DeviceID.Split(","); }

    #String Validation

    #DisplayName

    #note

    #snmpOid

    #input validation to make sure this is a valid snmpOid or throw

    #Boolean validations

    #End input validation

    $finalresult = @()

    if ($DeviceID.Count -eq 1) {

        $uri = $global:WhatsUpServerBaseURI + "/api/v1/devices/$($DeviceID[0])/properties"

        $method = "PUT"

        $body = @{}

        if ($DisplayName) { $body.displayname = $DisplayName }

        if ($isWireless) { $body.iswireless = $isWireless }

        if ($collectWireless) { $body.collectwireless = $collectWireless }

        if ($keepDetailsCurrent) { $body.keepdetailscurrent = $keepDetailsCurrent }

        if ($note) { $body.note = $note }

        if ($snmpOid) { $body.snmpoid = $snmpOid }

        if ($actionPolicyId -or $actionPolicyName) {

            $actionPolicy = @{}

            if ($body.actionpolicy) {

                $actionPolicy = $body.actionpolicy

            }

            if ($actionPolicyId) {

                $actionPolicy += @{

                    id = "${actionPolicyId}"

                }

            }

            if ($actionPolicyName) {

                $actionPolicy += @{

                    name = "${actionPolicyName}"

                }

            }

            $body.actionpolicy = $actionPolicy

        } else {

            $actionPolicy = @{}

            $body.actionpolicy = $actionPolicy

        }

        $jsonBody = $body | ConvertTo-Json -Depth 5

        try {

            $result = Get-WUGAPIResponse -uri $uri -method $method -body $jsonBody

            Write-Information $jsonBody

            return $result.data

        }

        catch {

            Write-Error "Error setting device properties: $($_)"

        }

    }

    else {

        $uri = $global:WhatsUpServerBaseURI + "/api/v1/devices/-/properties"

        $method = "PATCH"

        $batchSize = 201

        for ($i = 0; $i -lt $DeviceID.Count; $i += $batchSize) {

            $currentBatch = $DeviceID[$i..($i + $batchSize - 1)]

            $body = @{

                devices = $currentBatch

            }

            if ($isWireless) { $body.iswireless = $isWireless }

            if ($collectWireless) { $body.collectwireless = $collectWireless }

            if ($keepDetailsCurrent) { $body.keepdetailscurrent = $keepDetailsCurrent }

            if ($note) { $body.note = $note }

            if ($snmpOid) { $body.snmpoid = $snmpOid }

            if ($actionPolicyId -or $actionPolicyName) {

                $actionPolicy = @{}

                if ($body.actionpolicy) {

                    $actionPolicy = $body.actionpolicy

                }

                if ($actionPolicyId) {

                    $actionPolicy += @{

                        id = "${actionPolicyId}"

                    }

                }

                if ($actionPolicyName) {

                    $actionPolicy += @{

                        name = "${actionPolicyName}"

                    }

                }

                $body.actionpolicy = $actionPolicy

            } else {

                $actionPolicy = @{}

                $body.actionpolicy = $actionPolicy

            }

            $jsonBody = $body | ConvertTo-Json -Depth 5

            Write-Information "Current batch of ${batchSize} is being processed."

            Write-Debug "Get-WUGAPIResponse -uri ${uri} -method ${method} -body ${jsonBody}"

            try {

                $result = Get-WUGAPIResponse -uri $uri -method $method -body $jsonBody

                $finalresult += $result.data

            }

            catch {

                Write-Error $jsonBody

                Write-Error "Error setting device properties: $_"

                $errorMessage = "Error setting device properties: $($_.Exception.Message)`nStackTrace: $($_.ScriptStackTrace)"

                Write-Error $errorMessage

            }

        }

        return $finalresult

    }

}

# SIG # Begin signature block

# MIIVvgYJKoZIhvcNAQcCoIIVrzCCFasCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAsjWfRFcNadW/F

# tUcdAZtmU/r2FFZ7BslhmnfHsdaBUaCCEfkwggVvMIIEV6ADAgECAhBI/JO0YFWU

# jTanyYqJ1pQWMA0GCSqGSIb3DQEBDAUAMHsxCzAJBgNVBAYTAkdCMRswGQYDVQQI

# DBJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcMB1NhbGZvcmQxGjAYBgNVBAoM

# EUNvbW9kbyBDQSBMaW1pdGVkMSEwHwYDVQQDDBhBQUEgQ2VydGlmaWNhdGUgU2Vy

# dmljZXMwHhcNMjEwNTI1MDAwMDAwWhcNMjgxMjMxMjM1OTU5WjBWMQswCQYDVQQG

# EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMS0wKwYDVQQDEyRTZWN0aWdv

# IFB1YmxpYyBDb2RlIFNpZ25pbmcgUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEBAQUA

# A4ICDwAwggIKAoICAQCN55QSIgQkdC7/FiMCkoq2rjaFrEfUI5ErPtx94jGgUW+s

# hJHjUoq14pbe0IdjJImK/+8Skzt9u7aKvb0Ffyeba2XTpQxpsbxJOZrxbW6q5KCD

# J9qaDStQ6Utbs7hkNqR+Sj2pcaths3OzPAsM79szV+W+NDfjlxtd/R8SPYIDdub7

# P2bSlDFp+m2zNKzBenjcklDyZMeqLQSrw2rq4C+np9xu1+j/2iGrQL+57g2extme

# me/G3h+pDHazJyCh1rr9gOcB0u/rgimVcI3/uxXP/tEPNqIuTzKQdEZrRzUTdwUz

# T2MuuC3hv2WnBGsY2HH6zAjybYmZELGt2z4s5KoYsMYHAXVn3m3pY2MeNn9pib6q

# RT5uWl+PoVvLnTCGMOgDs0DGDQ84zWeoU4j6uDBl+m/H5x2xg3RpPqzEaDux5mcz

# mrYI4IAFSEDu9oJkRqj1c7AGlfJsZZ+/VVscnFcax3hGfHCqlBuCF6yH6bbJDoEc

# QNYWFyn8XJwYK+pF9e+91WdPKF4F7pBMeufG9ND8+s0+MkYTIDaKBOq3qgdGnA2T

# OglmmVhcKaO5DKYwODzQRjY1fJy67sPV+Qp2+n4FG0DKkjXp1XrRtX8ArqmQqsV/

# AZwQsRb8zG4Y3G9i/qZQp7h7uJ0VP/4gDHXIIloTlRmQAOka1cKG8eOO7F/05QID

# AQABo4IBEjCCAQ4wHwYDVR0jBBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYD

# VR0OBBYEFDLrkpr/NZZILyhAQnAgNpFcF4XmMA4GA1UdDwEB/wQEAwIBhjAPBgNV

# HRMBAf8EBTADAQH/MBMGA1UdJQQMMAoGCCsGAQUFBwMDMBsGA1UdIAQUMBIwBgYE

# VR0gADAIBgZngQwBBAEwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybC5jb21v

# ZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNAYIKwYBBQUHAQEE

# KDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5jb21vZG9jYS5jb20wDQYJKoZI

# hvcNAQEMBQADggEBABK/oe+LdJqYRLhpRrWrJAoMpIpnuDqBv0WKfVIHqI0fTiGF

# OaNrXi0ghr8QuK55O1PNtPvYRL4G2VxjZ9RAFodEhnIq1jIV9RKDwvnhXRFAZ/ZC

# J3LFI+ICOBpMIOLbAffNRk8monxmwFE2tokCVMf8WPtsAO7+mKYulaEMUykfb9gZ

# pk+e96wJ6l2CxouvgKe9gUhShDHaMuwV5KZMPWw5c9QLhTkg4IUaaOGnSDip0TYl

# d8GNGRbFiExmfS9jzpjoad+sPKhdnckcW67Y8y90z7h+9teDnRGWYpquRRPaf9xH

# +9/DUp/mBlXpnYzyOmJRvOwkDynUWICE5EV7WtgwggYaMIIEAqADAgECAhBiHW0M

# UgGeO5B5FSCJIRwKMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYD

# VQQKEw9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENv

# ZGUgU2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5

# NTlaMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzAp

# BgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0G

# CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjI

# ztNsfvxYB5UXeWUzCxEeAEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NV

# DgFigOMYzB2OKhdqfWGVoYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/3

# 6F09fy1tsB8je/RV0mIk8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05Zw

# mRmTnAO5/arnY83jeNzhP06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm

# +qxp4VqpB3MV/h53yl41aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUe

# dyz8rNyfQJy/aOs5b4s+ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz4

# 4MPZ1f9+YEQIQty/NQd/2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBM

# dlyh2n5HirY4jKnFH/9gRvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQY

# MBaAFDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritU

# pimqF6TNDDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNV

# HSUEDDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsG

# A1UdHwREMEIwQKA+oDyGOmh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1

# YmxpY0NvZGVTaWduaW5nUm9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsG

# AQUFBzAChjpodHRwOi8vY3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2Rl

# U2lnbmluZ1Jvb3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0

# aWdvLmNvbTANBgkqhkiG9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURh

# w1aVcdGRP4Wh60BAscjW4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0Zd

# OaWTsyNyBBsMLHqafvIhrCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajj

# cw5+w/KeFvPYfLF/ldYpmlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNc

# WbWDRF/3sBp6fWXhz7DcML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalO

# hOfCipnx8CaLZeVme5yELg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJs

# zkyeiaerlphwoKx1uHRzNyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z7

# 6mKnzAfZxCl/3dq3dUNw4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5J

# KdGvspbOrTfOXyXvmPL6E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHH

# j95Ejza63zdrEcxWLDX6xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2

# Bev6SivBBOHY+uqiirZtg0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/

# L9Uo2bC5a4CH2RwwggZkMIIEzKADAgECAhEA6IUbK/8zRw2NKvPg4jKHsTANBgkq

# hkiG9w0BAQwFADBUMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1p

# dGVkMSswKQYDVQQDEyJTZWN0aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgQ0EgUjM2

# MB4XDTIzMDQxOTAwMDAwMFoXDTI2MDcxODIzNTk1OVowVTELMAkGA1UEBhMCVVMx

# FDASBgNVBAgMC0Nvbm5lY3RpY3V0MRcwFQYDVQQKDA5KYXNvbiBBbGJlcmlubzEX

# MBUGA1UEAwwOSmFzb24gQWxiZXJpbm8wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw

# ggIKAoICAQC2JA01BehqpO3INejKVsKScaS9sd0Hjoz1tceFig6Yyu2glTKimH9n

# r9l5438Cjpc1x+n42gMfnS5Cza4tZUWr1usOq3d0TljKFOOSW8Uve1J+PC0f/Hxp

# DbI8hE38ICDmgv8EozBOgo4lPm/rDHVTHgiRZvy1H8gPTuE13ck2sevVslku2E2F

# 8wst5Kb12OqngF96RXptEeM0iTipPhfNinWCa8e58+mbt1dHCbX46593DRd3yQv+

# rvPkIh9QkMGmumfjV5lv1S3iqf/Vg6XP9R3lTPMWNO2IEzIjk12t817rU3xYyf2Q

# 4dlA/i1bRpFfjEVcxQiZJdQKnQlqd3hOk0tr8bxTI3RZxgOLRgC8mA9hgcnJmreM

# WP4CwXZUKKX13pMqzrX/qiSUsB+Mvcn7LHGEo9pJIBgMItZW4zn4uPzGbf53EQUW

# nPfUOSBdgkRAdkb/c7Lkhhc1HNPWlUqzS/tdopI7+TzNsYr7qEckXpumBlUSONoJ

# n2V1zukFbgsBq0mRWSZf+ut3OVGo7zSYopsMXSIPFEaBcxNuvcZQXv6YdXEsDpvG

# mysbgVa/7uP3KwH9h79WeFU/TiGEISH5B59qTg26+GMRqhyZoYHj7wI36omwSNja

# tUo5cYz4AEYTO58gceMcztNO45BynLwPbZwZ0bxPN2wL1ruIYd+ewQIDAQABo4IB

# rjCCAaowHwYDVR0jBBgwFoAUDyrLIIcouOxvSK4rVKYpqhekzQwwHQYDVR0OBBYE

# FJHuVIzRubayI0tfw82Q7Q/47iu9MA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8E

# AjAAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMEoGA1UdIARDMEEwNQYMKwYBBAGyMQEC

# AQMCMCUwIwYIKwYBBQUHAgEWF2h0dHBzOi8vc2VjdGlnby5jb20vQ1BTMAgGBmeB

# DAEEATBJBgNVHR8EQjBAMD6gPKA6hjhodHRwOi8vY3JsLnNlY3RpZ28uY29tL1Nl

# Y3RpZ29QdWJsaWNDb2RlU2lnbmluZ0NBUjM2LmNybDB5BggrBgEFBQcBAQRtMGsw

# RAYIKwYBBQUHMAKGOGh0dHA6Ly9jcnQuc2VjdGlnby5jb20vU2VjdGlnb1B1Ymxp

# Y0NvZGVTaWduaW5nQ0FSMzYuY3J0MCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5z

# ZWN0aWdvLmNvbTAjBgNVHREEHDAagRhqYXNvbi5hbGJlcmlub0BnbWFpbC5jb20w

# DQYJKoZIhvcNAQEMBQADggGBAET0EFH0r+hqoQWr4Ha9UDuEv28rTgV2aao1nFRg

# GZ/5owM7x9lxappLUbgQFfeIzzAsp3gwTKMYf47njUjvOBZD9zV/3I/vaLmY2enm

# MXZ48Om9GW4pNmnvsef2Ub1/+dRzgs8UFX5wBJcfy4OWP3t0OaKJkn+ZltgFF1cu

# L/RPiWSRcZuhh7dIWgoPQrVx8BtC8pkh4F5ECxogQnlaDNBzGYf1UYNfEQOFec31

# UK8oENwWx5/EaKFrSi9Y4tu6rkpH0idmYds/1fvqApGxujhvCO4Se8Atfc98icX4

# DWkc1QILREHiVinmoO3smmjB5wumgP45p9OVJXhI0D0gUFQfOSappa5eO2lbnNVG

# 90rCsADmVpDDmNt2qPG01luBbX6VtWMP2thjP5/CWvUy6+xfrhlqvwZyZt3SKtuf

# FWkqnNWMnmgtBNSmBF5+q8w5SJW+24qrncKJWSIim/nRtC11XnoI9SXlaucS3Nlb

# crQVicXOtbhksEqMTn52i8NOfzGCAxswggMXAgEBMGkwVDELMAkGA1UEBhMCR0Ix

# GDAWBgNVBAoTD1NlY3RpZ28gTGltaXRlZDErMCkGA1UEAxMiU2VjdGlnbyBQdWJs

# aWMgQ29kZSBTaWduaW5nIENBIFIzNgIRAOiFGyv/M0cNjSrz4OIyh7EwDQYJYIZI

# AWUDBAIBBQCggYQwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkqhkiG9w0B

# CQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAv

# BgkqhkiG9w0BCQQxIgQg29YARqz+vnpk4TOyaI7uU5z69NBv3MQLNzf3QhKseZEw

# DQYJKoZIhvcNAQEBBQAEggIAqriDYU5wttvy36pTNhiHwxDmp4WDM025KU7M+lfM

# fzvbxc/EPsiSJnd/fsZ4mtFKsNlevJM5tthhcSJVAuD4L5dkPRWRifSvLsc98RKk

# Yhdu1b6JHpL4CVpSYJXvuRIPR2i4TrpQZcx2tF4MqyQ5u6PJMe3sINbiUAhYkQ35

# tbcSfTdaLccV6p5ze9P3+JdY2c41+Vapbech0wUyhrt7EaOKGrUBrK+cqF5gdHom

# XsF5TYqP3l/6K3zc/TIHIRrb3MZWd+7c0v6eHLPlsTewB4GQAyOGZ5M25lLvB/6J

# vsJYO6tqcTheDYXRJL0aJZd6ESeJhz2STqbGeW6oQP41LLu7F0nDtjeMPwYPuabS

# lXXTM0w35I5xGtPNUQSZrO73BXmhmh35hVZQsDhnAH2NWj71BScO38rl3i2SfBJw

# DQv5+LPdBTEqJWhfnavfJIaQuzAN0pr9dBAh7t8d/9QEKU/4UzHc93v+P1p9hQ59

# e5JK3p1iA312hqptq+hOycXp1PaRDLA9jo1KQVckzqUd5TuliqlPN9UkILTfMlo4

# P/WQhT5OIt6IKlNNmWXHKEzh4i45crnl9WIlZcG07r3O834H2jZa5OWnt6ZXOa2Z

# KyluxPDZ4QsPQN0JUiDN8SnCRJIOTSRrwSp9I3367sbLE4g5+IjkC1ejZEVqKsMt

# DEA=

# SIG # End signature block