Get-HVBaseImageVM¶
SYNOPSIS¶
Gets a list of compatible base image virtual machines.
SYNTAX¶
Type (Default)¶
Get-HVBaseImageVM [-HvServer <Object>] [-VirtualCenter <Object>] [-Type <Object>] [<CommonParameters>]
Name¶
Get-HVBaseImageVM [-HvServer <Object>] [-VirtualCenter <Object>] [-Name <String>] [<CommonParameters>]
DESCRIPTION¶
Queries and returns BaseImageVmInfo for the specified vCenter Server.
EXAMPLES¶
EXAMPLE 1¶
Get-HVBaseImageVM -VirtualCenter 'vCenter1' -Type VDI
EXAMPLE 2¶
Get-HVBaseImageVM -VirtualCenter $vCenter1 -Type ALL
EXAMPLE 3¶
Get-HVBaseImageVM -Name '*WIN10*'
PARAMETERS¶
-HvServer¶
Reference to Horizon View Server to query the virtual machines from. If the value is not passed or null then first element from global:DefaultHVServers would be considered in place of hvServer.
Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VirtualCenter¶
A parameter to specify which vCenter Server to check base image VMs for. It can be specified as a String, containing the name of the vCenter, or as a vCenter object as returned by Get-HVvCenterServer. If the value is not passed or null then first element returned from Get-HVvCenterServer would be considered in place of VirtualCenter.
Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Type¶
A parameter to define the type of compatability to check the base image VM list against. Valid options are 'VDI', 'RDS', or 'ALL' 'VDI' will return all desktop compatible Base Image VMs. 'RDS' will return all RDSH compatible Base Image VMs. 'ALL' will return all Base Image VMs, regardless of compatibility. The default value is 'ALL'.
Type: Object
Parameter Sets: Type
Aliases:
Required: False
Position: Named
Default value: VDI
Accept pipeline input: False
Accept wildcard characters: False
-Name¶
The name of a virtual machine (if known), to filter Base Image VMs on. Wildcards are accepted. If Name is specified, then Type is not considered for filtering.
Type: String
Parameter Sets: Name
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters¶
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS¶
OUTPUTS¶
Returns array of object type Omnissa.Horizon.BaseImageVmInfo¶
NOTES¶
Author | Matt Frey. |
Author email | mfrey@omnissa.com |
Version | 1.0 |
===Tested Against Environment==== | | | |-|-| | Horizon View Server Version | 7.7 | | PowerCLI Version | PowerCLI 11.2.0 | | PowerShell Version | 5.1 |