SolarWinds.WebHelpDesk

1.0.0

Functions/Public/Get-WHDAssetType.ps1

<#
    .SYNOPSIS
    Get an AssetType from WHD.
 
    .DESCRIPTION
    This function retrieves a specific AssetType from WHD, or a list of AssetTypes based on a provided search parameter.
 
    .PARAMETER ResourceId
    The id of the AssetType to be retrieved.
 
    .PARAMETER Qualifier
    A WHDQualifier object to filter the results.
    Use New-WHDQualifier and Join-WHDQualifier to build these objects.
 
    .PARAMETER QualifierString
    A WHD API qualifier string to filter the results.
    This is an alternative to using the Qualifier parameter if you prefer to build the qualifier string manually.
 
    .PARAMETER Name
    An assetType to search for.
#>
function Get-WHDAssetType {
    [CmdletBinding(DefaultParameterSetName = "Search")]
    param (
        [Parameter(ParameterSetName = "Single", Mandatory, Position = 0)]
        [int] $ResourceId,

        [Parameter(ParameterSetName = "Qualifier", Mandatory)]
        [WHDQualifier] $Qualifier,

        [Parameter(ParameterSetName = "QualifierString", Mandatory)]
        [string] $QualifierString,

        [Parameter(ParameterSetName = "Search")]
        [string] $Name
    )

    $AttributeMap = @{
        Name = "assetType"
    }

    $QueryParameters = @{
        ResourceType = [WHDResourceType]::AssetType
    }

    switch ($PSCmdlet.ParameterSetName) {
        "Single" {
            $QueryParameters["ResourceId"] = $ResourceId
        }
        "Qualifier" {
            $QueryParameters["Qualifier"] = $Qualifier
        }
        "QualifierString" {
            $QueryParameters["QualifierString"] = $QualifierString
        }
        "Search" {
            $QueryParameters["Qualifier"] = ConvertTo-WHDQualifier `
                -BoundParameters $PSBoundParameters `
                -AttributeMap $AttributeMap
        }
    }

    return Get-WHDResource @QueryParameters
}