Public/Remove-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
69
Function Remove-IdoItCategory {
    <#
        .SYNOPSIS
        Remove-IdoItCategory

        .DESCRIPTION
        With Remove-IdoItCategory you can remove a category object for a given object.

        .PARAMETER Id
        This parameter contains the id of the object you want to remove 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 ElementId
        This value is mandatory for multi value categories like CPU or hostaddress.

        .EXAMPLE
        PS> Remove-IdoItCategory -Id 3411 -CatgId 53 -ElementId 393

        Removes from category 53 the element with the id 393 for the object 3411

        .NOTES
        Version
        0.1.0 29.12.2017 CB initial release
    #>

        [CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'High')]
        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)]
            [Int]$ElementId

        )
        $Params = @{}

        $Params.Add("id", $Id)

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

        If ($PSBoundParameters.ContainsKey("ElementId")) {
            $Params.Add("cateID", $ElementId)
        }

        If ($PSCmdlet.ShouldProcess("Deleting category from object $id")) {
            $ResultObj = Invoke-Cmdb -Method "cmdb.category.delete" -Params $Params
            Return $ResultObj
        }
    }