Public/Get-AvdSessionHostResources.ps1
|
function Get-AvdSessionHostResources { <# .SYNOPSIS Gets the Azure resources from a AVD Session Host .DESCRIPTION The function will help you getting the associated Azure resource information which is behind the AVD Session Host .PARAMETER HostpoolName Enter the AVD hostpool name .PARAMETER ResourceGroupName Enter the AVD hostpool resourcegroup .PARAMETER SessionHostName Enter the AVD Session Host name .EXAMPLE Get-AvdSessionHostResources -Hostpoolname avd-hostpool -ResourceGroup rg-avd-01 .EXAMPLE Get-AvdSessionHostResources -Hostpoolname avd-hostpool -ResourceGroup rg-avd-01 -Name avd-0 .EXAMPLE Get-AvdSessionHostResources -Id sessionhostId #> [CmdletBinding(DefaultParameterSetName = 'All')] param ( [parameter(Mandatory, ParameterSetName = 'All')] [parameter(Mandatory, ParameterSetName = 'Hostname')] [ValidateNotNullOrEmpty()] [string]$HostpoolName, [parameter(Mandatory, ParameterSetName = 'All')] [parameter(Mandatory, ParameterSetName = 'Hostname')] [ValidateNotNullOrEmpty()] [string]$ResourceGroupName, [parameter(Mandatory, ParameterSetName = 'Hostname')] [ValidateNotNullOrEmpty()] [string]$Name, [parameter(Mandatory, ParameterSetName = 'Resource', ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()] [string]$Id ) Begin { Write-Verbose "Start searching for resources" $apiVersion = "?api-version=2022-03-01" } Process { switch ($PsCmdlet.ParameterSetName) { All { $parameters = @{ HostPoolName = $HostpoolName ResourceGroupName = $ResourceGroupName } } Hostname { $parameters = @{ hostPoolName = $HostpoolName resourceGroupName = $ResourceGroupName name = $Name } } Resource { Write-Verbose "Got a resource object, looking for $Id" $parameters = @{ Id = $Id } } } try { $sessionHosts = Get-AvdSessionHost @parameters } catch { Throw "No sessionhosts ($name) found in $HostpoolName ($ResourceGroupName), $_" } $sessionHosts | Foreach-Object { Write-Verbose "Searching for $($_.Name)" try { $requestParameters = @{ uri = "{0}{1}{2}&`$expand=instanceView" -f $global:AzureApiUrl, $_.properties.resourceId, $apiVersion method = "GET" } $resource = Request-Api @requestParameters } catch { Write-Warning "Sessionhost $($_.name) has no resources, consider deleting it. Use the Remove-AvdSessionHost command, $_. URI is $($requestparameters.uri)" } $_ | Add-Member -NotePropertyName vmResources -NotePropertyValue $resource -Force } } End { return $sessionHosts } } |