Public/Get-CAMObject.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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
Function Get-CAMObject
{
<#
    .SYNOPSIS
        Function to retrieving Cireson Asset Management Object(s)
     
    .DESCRIPTION
        Function to retrieving Cireson Asset Management Object(s)
     
    .PARAMETER TypeName
        Specifies the type of Object you want to create
         
    .PARAMETER Filter
        Specifies the Filter to apply on the query
     
    .EXAMPLE
        Get-CAMObject -TypeName Vendor
 
    .EXAMPLE
        Get-CAMObject -TypeName Vendor -filter "Name -eq 'Google'"
     
    .NOTES
        Francois-Xavier Cat
        lazywinadmin.com
        @lazywinadm
        github.com/lazywinadmin
#>

    [CmdletBinding()]
    PARAM (
        [Parameter(Mandatory)]
        [ValidateSet(
            "Base",
            "CatalogItem",
            "Consumable",
            "CostCenter",
            "HardwareAsset",
            "Import.Connector",
            "Invoice",
            "Lease",
            "License",
            "Location",
            "Log",
            "MeteringData",
            "NoticeEvent",
            "NoticeEventData",
            "Organization",
            "Purchase",
            "PurchaseOrder",
            "Settings",
            "SoftwareAsset",
            "Standard",
            "Subnet",
            "SupportContract",
            "Vendor",
            "Warranty"
            )]
        [String]$TypeName,
        [Parameter()]
        $Filter
    )
    TRY
    {
        Write-Verbose -Message $(New-ScriptMessage -Block PROCESS -message 'Creating Splatting')
        Write-Verbose -Message $(New-ScriptMessage -Block PROCESS -message "Querying Class: Cireson.AssetManagement.$TypeName")
        $Splatting = @{
            Class = (get-scsmclass -name "Cireson.AssetManagement.$TypeName")
        }
        
        IF($PSBoundParameters['Filter'])
        {
            Write-Verbose -Message $(New-ScriptMessage -Block PROCESS -message 'Filter Specified: $Filter')
            $Splatting.Filter = $Filter
        }
        
        # Get CAM object
        Write-Verbose -Message $(New-ScriptMessage -Block PROCESS -message 'Retrieving objects...')
        Get-SCSMObject @Splatting
    }
    CATCH
    {
        Write-Error -Message "[PROCESS] An Error occured"
        $Error[0].Exception.Message
    }
}