Functions/Public/catalog-service/Get-vRAIcon.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 |
function Get-vRAIcon { <# .SYNOPSIS Retrieve a vRA Icon .DESCRIPTION Retrieve a vRA Icon .PARAMETER Id Specify the ID of an Icon .INPUTS System.String .OUTPUTS System.Management.Automation.PSObject. .EXAMPLE Get-vRAIcon -Id "cafe_default_icon_genericAllServices" Get the default All Services Icon. Note: admin permissions for the default vRA Tenant are required for this action. .EXAMPLE Get-vRAIcon -Id "cafe_icon_Service01" Get the vRA Icon named cafe_icon_Service01 #> [CmdletBinding()][OutputType('System.Management.Automation.PSObject')] Param ( [parameter(Mandatory=$true,ValueFromPipeline=$true)] [ValidateNotNullOrEmpty()] [String[]]$Id ) begin { # --- Test for vRA API version xRequires -Version 7.1 } process { try { foreach ($IconId in $Id){ $URI = "/catalog-service/api/icons/$($IconId)" # --- Run vRA REST Request $Icon = Invoke-vRARestMethod -Method GET -URI $URI -Verbose:$VerbosePreference [PSCustomobject]@{ Id = $Icon.id FileName = $Icon.fileName ContentType = $Icon.contentType Image = $Icon.image Organization = $Icon.organization } } } catch [Exception]{ throw } } end { } } |