Functions/Public/Get-WHDLocation.ps1
|
<#
.SYNOPSIS Get a Location from WHD. .DESCRIPTION This function retrieves a specific Location from WHD, or a list of Locations based on a provided search parameter. .PARAMETER ResourceId The id of the Location 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 A locationName to search for. .PARAMETER Expand If specified, list results will use the detailed format. #> function Get-WHDLocation { [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, [Parameter(ParameterSetName = "Search")] [Parameter(ParameterSetName = "Qualifier")] [Parameter(ParameterSetName = "QualifierString")] [switch] $Expand ) $AttributeMap = @{ Name = "locationName" } $QueryParameters = @{ ResourceType = [WHDResourceType]::Location Expand = $Expand.IsPresent } 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 } |