Public/Set-IdoItCategory.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
Function Set-IdoItCategory {
    <#
        .SYNOPSIS
        Set-IdoItCategory

        .DESCRIPTION
        With Set-IdoItCategory you can change values for a category for a given object.

        .PARAMETER Id
        This parameter contains the id of the object you want to change a category

        .PARAMETER Category
        This parameter takes a constant name of a specific category

        .PARAMETER CatgId
        With CatgId you can pass an id of a global category from table isysgui_catg

        .PARAMETER CatsId
        With CatsId you can pass an id of a specific catgeory from table isysgui_cats

        .PARAMETER Data
        The data parameter takes a hashtable with all the key-value pairs of the category you want to change.

        .EXAMPLE
        PS> Set-IdoItCategory -Id 3411 -Category 'C__CATG__CPU' -Data @{Manufacturer='Intel'}

        Changes the Manufacturer for the CPU to Intel for object 3411

        .NOTES
        Version
        0.1.0 29.12.2017 CB initial release
    #>

        [CmdletBinding( SupportsShouldProcess = $True )]
        Param (
            [Parameter( Mandatory = $True, ValueFromPipelineByPropertyName = $True, Position = 0)]
            [Int]$Id,

            [Parameter( Mandatory = $True, ParameterSetName = "Category")]
            [String]$Category,

            [Parameter( Mandatory = $True, ParameterSetName = "CatgId")]
            [Int]$CatgId,

            [Parameter( Mandatory = $True, ParameterSetName = "CatsId")]
            [Int]$CatsId,

            [Parameter( Mandatory = $True )]
            [Hashtable]$Data
        )

        $Params = @{}
        $Params.Add("objID", $Id)

        Switch ($PSCmdlet.ParameterSetName) {
            "Category" {$Params.Add("category", $Category); Break }
            "CatgId" {$Params.Add("catgID", $CatgId); Break }
            "CatsId" {$Params.Add("catsID", $CatsId); Break }
        }

        $Params.Add("data", $Data)

        If ($PSCmdlet.ShouldProcess("Updating category on object $Id")) {
            $ResultObj = Invoke-IdoIt -Method "cmdb.category.update" -Params $Params

            Return $ResultObj
        }
    }