Get-RASVDIHost
Retrieves the host VM list from a Provider in real-time.
Get-RASVDIHost [-ProviderId] <uint> [[-SiteId] <uint>] -Id <string> [-User <string>] [-VDITemplateId <uint>] [<CommonParameters>]
Get-RASVDIHost [[-ProviderId] <uint>] [[-SiteId] <uint>] [-User <string>] [-VDITemplateId <uint>] [<CommonParameters>]
Get-RASVDIHost [-VDITemplateObj] <Template> [[-SiteId] <uint>] [-User <string>] [-VDITemplateId <uint>] [<CommonParameters>]
Retrieves the list of host VMs from one or multiple Provider servers.
Returns an array of objects of type VDIHost, each containing properties of a host VM.
To see the complete list of object properties, use the Format-List cmdlet (see examples).
Note: the returned object contains only the major properties of a host VM; it does not include all of the settings supported in RAS.
-ProviderId <uint> The ID of a Provider server from which to obtain the VM list.
-SiteId <uint> Site ID from which to retrieve the desktop VM list.
If the parameter is omitted, the site ID of the Licensing Server will be used.
-Id <string> The ID of a desktop VM for which to retrieve the information.
-VDITemplateObj <Template> The VDI Template for which to retrieve the desktops of.
-VDITemplateId <uint> The ID of the VDI Template for which to retrieve the desktops of.
-User <string> The username assigned to Desktop.
If empty square brackets ([]) are passed, the desktop list will be filtered with those with an assigned user.
<CommonParameters>
-none-
---------- EXAMPLE 1 ----------
Get-RASVDIHost 2 | Format-List
Retrieves the list of host VMs from the specified Provider server from the Licensing Server site.
To get the info from a specific site, specify the -SiteId parameter.
The Format-List cmdlet formats the display output to include the complete list of the returned properties. ---------- EXAMPLE 2 ----------
Get-RASVDIHost -ProviderId 2 -SiteId 2
Retrieves the list of host VMs from the specified Provider server from the specified site. ---------- EXAMPLE 3 ----------
Get-RASVDIHost | Format-List
Retrieves the complete list of host VMs residing on all available Provider servers in the Licensing Server site.
To get the info from a specific site, specify the -SiteId parameter.
The Format-List cmdlet formats the display output to include the complete list of the returned properties. ---------- EXAMPLE 4 ----------
Get-RASVDIHost -ProviderId 2 -Id 42311235-09c5-ca15-337d-b9723015edf0
Retrieves the information about a specified host VM residing on the specified Provider server. ---------- EXAMPLE 5 ----------
Get-RASVDIHost -VDITemplateObj $TempObj
Retrieves the information about the VDI hosts created from the specified VDI template.