Dune

1.0.1

Public/Get-DuneComputeNode.ps1

function Get-DuneComputeNode {
    [CmdletBinding(DefaultParameterSetName = "Default")]
    param (
        [Parameter(Position = 0)]
        [string]$Hostname,

        [Parameter(ParameterSetName = "Id")]
        [guid]$Id,

        [Parameter(ParameterSetName = "Collection", ValueFromPipeline)]
        [DuneCollection]$Collection,

        [Parameter(ParameterSetName = "Deployment", ValueFromPipeline)]
        [DuneDeployment]$Deployment,

        [Parameter(ParameterSetName = "ResourceGroup", ValueFromPipeline)]
        [DuneResourceGroup]$ResourceGroup,

        [Parameter(ParameterSetName = "Resource", ValueFromPipeline)]
        [DuneResource]$Resource,

        [Parameter(ParameterSetName = "ResourceProvider", ValueFromPipeline)]
        [DuneResourceProvider]$ResourceProvider,

        [Parameter(ParameterSetName = "ExtId")]
        [string]$ExtId,

        [Parameter()]
        [string]$Fqdn,

        [Parameter()]
        [string]$Name,

        [Parameter()]
        [ValidateSet('VirtualMachine', 'PhysicalMachine')]
        [string]$ObjectType,

        [Parameter()]
        [OperationalStates]$State,

        [Parameter()]
        [switch]$Raw = $False,

        [Parameter()]
        [switch]$IncludeDeleted
    )

    begin {
        Write-Debug "$($MyInvocation.MyCommand)|begin"
        $ReturnObjects = @()
        $ProcessedUrls = @()
        $BaseUri = 'computenodes'
        $Method = "GET"
    }

    process {
        Write-Debug "$($MyInvocation.MyCommand)|process|$($PSCmdlet.ParameterSetName)"

        # Build Uri
        $Uri = switch ($PSCmdlet.ParameterSetName) {
            'Id' { $BaseUri, $Id -join '/' }
            'Collection' { '{0}?CollectionId={1}' -f $BaseUri, $Collection.Id }
            'Deployment' { $BaseUri, "DeploymentId=$($Deployment.Id)" -join '?' }
            'ResourceGroup' { $BaseUri, "ParentId=$($ResourceGroup.Id)" -join '?' }
            'ResourceProvider' { $BaseUri, "ResourceProviderId=$($ResourceProvider.Id)" -join '?' }
            'ExtId' { '{0}?ExtIdIEquals={1}' -f $BaseUri, $ExtId }
            'Resource' {
                if ($Resource.ObjectType -in 'VirtualMachine', 'PhysicalMachine') {
                    $BaseUri, $Resource.Id -join '/'
                }
                else {
                    Write-Warning "Wrong ObjectType $($Resource.ObjectType) for $($Resource.Name) (id: $($Resource.Id))"
                    return
                }
            }
            Default { $BaseUri }
        }
        If ($Hostname) {
            $Uri = $Uri | Add-UriQueryParam "HostnameILike=$Hostname" -ConvertWildcards
        }
        if ($Fqdn) {
            $Uri = $Uri | Add-UriQueryParam "FqdnILike=$Fqdn" -ConvertWildcards
        }
        if ($Name) {
            $Uri = $Uri | Add-UriQueryParam "NameILike=$Name" -ConvertWildcards
        }
        if ($PSBoundParameters.ContainsKey('State')) {
            $Uri = $Uri | Add-UriQueryParam "State=$($State.ToString())"
        }
        if ($ObjectType) {
            $Uri = $Uri | Add-UriQueryParam "ObjectType=$ObjectType"
        }
        if ($IncludeDeleted) {
            $Uri = $Uri | Add-UriQueryParam "IncludeDeleted=1"
        }
        $Uri = $Uri | Add-UriQueryParam "IncludeReferencedObjects=1"

        # ApiCall Cache
        if ($ProcessedUrls -notcontains $Uri) {
            try {
                $ResultItems = Invoke-DuneApiRequest -Uri $Uri -Method $Method -ExtractItems
                $ProcessedUrls += $Uri
                $ReturnObjects += $ResultItems | ForEach-Object {
                    if ($Raw) {
                        $_
                    }
                    else {
                        ConvertTo-DuneClassObject -Class DuneComputeNode -InputObject $_
                    }
                }
            }
            catch {
                throw $_
            }
        }
        else {
            Write-Debug "$($MyInvocation.MyCommand)|process|ApiCall Cache hit: DuneApiRequest for $Uri already invoked"
        }
    }

    end {
        Write-Debug "$($MyInvocation.MyCommand)|end"

        return $ReturnObjects | Sort-Object -Unique Id | Sort-Object Hostname
    }
}