Public/Administration/Entities/Get-GlpiToolsEntities.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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<#
.SYNOPSIS
    Function returns entities from GLPI
.DESCRIPTION
    Function returns all possible enitites, you can provide id or name to get informations about desired entity
.PARAMETER All
    This parameter will return all Entities from GLPI
.PARAMETER EntityId
    This parameter can take pipline input, either, you can use this function with -ComputerId keyword.
    Provide to this param Entity ID from GLPI Entities Bookmark
.PARAMETER EntityName
    This parameter can take pipline input, either, you can use this function with -ComputerName keyword.
    Provide to this param entity Name from GLPI Entities Bookmark
.EXAMPLE
    PS C:\> Get-GlpiToolsEntities -All
    Command will return all entities from GLPI
.EXAMPLE
    PS C:\> Get-GlpiToolsEntities -EntityId 3
    Command will return entity with Id number 3 from GLPI
.EXAMPLE
    PS C:\> 3 | Get-GlpiToolsEntities
    Command will return entity with Id number 3 from GLPI
.EXAMPLE
    PS C:\> Get-GlpiToolsEntities -EntityName Old
    Command will return entity with Name Old from GLPI
.INPUTS
    Entity ID which you can find in GLPI, or use this Function to convert ID returned from other Functions
.OUTPUTS
    Function returns PSCustomObject with property's of entity from GLPI
.NOTES
    PSP 01/2019
#>


function Get-GlpiToolsEntities {
    [CmdletBinding()]
    param (
        [parameter(Mandatory = $false,
            ParameterSetName = "All")]
        [switch]$All,
        [parameter(Mandatory = $true,
            ValueFromPipeline = $true,
            ParameterSetName = "EntityId")]
        [alias('EID')]
        [string[]]$EntityId,
        [parameter(Mandatory = $false,
            ParameterSetName = "EntityId")]
        [switch]$Raw,
        [parameter(Mandatory = $true,
            ParameterSetName = "EntityName")]
        [alias('EN')]
        [string]$EntityName
    )
    
    begin {
        $SessionToken = $Script:SessionToken
        $AppToken = $Script:AppToken
        $PathToGlpi = $Script:PathToGlpi

        $SessionToken = Set-GlpiToolsInitSession | Select-Object -ExpandProperty SessionToken
        $AppToken = Get-GlpiToolsConfig | Select-Object -ExpandProperty AppToken
        $PathToGlpi = Get-GlpiToolsConfig | Select-Object -ExpandProperty PathToGlpi

        $ChoosenParam = ($PSCmdlet.MyInvocation.BoundParameters).Keys

        $EntitiesArray = [System.Collections.Generic.List[PSObject]]::New()
    }
    
    process {
        switch ($ChoosenParam) {
            All {
                $params = @{
                    headers = @{
                        'Content-Type'  = 'application/json'
                        'App-Token'     = $AppToken
                        'Session-Token' = $SessionToken
                    }
                    method  = 'get'
                    uri     = "$($PathToGlpi)/Entity/?range=0-9999999999999"
                }
                
                $GlpiEntitiesAll = Invoke-RestMethod @params -Verbose:$false

                foreach ($GlpiEntity in $GlpiEntitiesAll) {
                    $EntityHash = [ordered]@{ }
                            $EntityProperties = $GlpiEntity.PSObject.Properties | Select-Object -Property Name, Value 
                                
                            foreach ($EntityProp in $EntityProperties) {
                                $EntityHash.Add($EntityProp.Name, $EntityProp.Value)
                            }
                            $object = [pscustomobject]$EntityHash
                            $EntitiesArray.Add($object)
                }
                $EntitiesArray
                $EntitiesArray = [System.Collections.Generic.List[PSObject]]::New()
            }
            EntityId {
                foreach ( $EId in $EntityId ) {
                    $params = @{
                        headers = @{
                            'Content-Type'  = 'application/json'
                            'App-Token'     = $AppToken
                            'Session-Token' = $SessionToken
                        }
                        method  = 'get'
                        uri     = "$($PathToGlpi)/Entity/$($EId)"
                    }

                    Try {
                        $GlpiEntity = Invoke-RestMethod @params -ErrorAction Stop

                        if ($Raw) {
                            $EntityHash = [ordered]@{ }
                            $EntityProperties = $GlpiEntity.PSObject.Properties | Select-Object -Property Name, Value 
                                
                            foreach ($EntityProp in $EntityProperties) {
                                $EntityHash.Add($EntityProp.Name, $EntityProp.Value)
                            }
                            $object = [pscustomobject]$EntityHash
                            $EntitiesArray.Add($object)
                        } else {
                            $EntityHash = [ordered]@{ }
                            $EntityProperties = $GlpiEntity.PSObject.Properties | Select-Object -Property Name, Value 
                                
                            foreach ($EntityProp in $EntityProperties) {

                                $EntityPropNewValue = Get-GlpiToolsParameters -Parameter $EntityProp.Name -Value $EntityProp.Value

                                $EntityHash.Add($EntityProp.Name, $EntityPropNewValue)
                            }
                            $object = [pscustomobject]$EntityHash
                            $EntitiesArray.Add($object)
                        }
                    } Catch {

                        Write-Verbose -Message "Entity ID = $EId is not found"
                        
                    }
                    $EntitiesArray
                    $EntitiesArray = [System.Collections.Generic.List[PSObject]]::New()
                }
            }
            EntityName {
                Search-GlpiToolsItems -SearchFor Entity -SearchType contains -SearchValue $EntityName
            }
            Default {}
        }
    }
    
    end {
        Set-GlpiToolsKillSession -SessionToken $SessionToken
    }
}