Get-HVMachine¶

SYNOPSIS¶

Gets virtual Machine(s) information with given search parameters.

SYNTAX¶

Get-HVMachine [[-PoolName] <String>] [[-MachineName] <String>] [[-DnsName] <String>] [[-State] <String>]
 [[-JsonFilePath] <String>] [[-HvServer] <Object>] [<CommonParameters>]

DESCRIPTION¶

Queries and returns virtual machines information, the machines list would be determined based on queryable fields poolName, dnsName, machineName, state. When more than one fields are used for query the virtual machines which satisfy all fields criteria would be returned.

EXAMPLES¶

EXAMPLE 1¶

Get-HVMachine -PoolName 'ManualPool'

Queries VM(s) with given parameter poolName

EXAMPLE 2¶

Get-HVMachine -MachineName 'PowerCLIVM'

Queries VM(s) with given parameter machineName

EXAMPLE 3¶

Get-HVMachine -State CUSTOMIZING

Queries VM(s) with given parameter vm state

EXAMPLE 4¶

Get-HVMachine -DnsName 'powercli-*'

Queries VM(s) with given parameter dnsName with wildcard character *

PARAMETERS¶

-PoolName¶

Pool name to query for. If the value is null or not provided then filter will not be applied, otherwise the virtual machines which has name same as value will be returned.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MachineName¶

The name of the Machine to query for. If the value is null or not provided then filter will not be applied, otherwise the virtual machines which has display name same as value will be returned.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DnsName¶

DNS name for the Machine to filter with. If the value is null or not provided then filter will not be applied, otherwise the virtual machines which has display name same as value will be returned.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-State¶

The basic state of the Machine to filter with. If the value is null or not provided then filter will not be applied, otherwise the virtual machines which has display name same as value will be returned.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-JsonFilePath¶

{ Fill JsonFilePath Description }

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-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: 6
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 list of objects of type MachineInfo¶

NOTES¶

===Tested Against Environment==== | | | |-|-| | Horizon View Server Version | 7.0.2, 7.1.0 | | PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 | | PowerShell Version | 5.0 |

RELATED LINKS¶