3.9 KiB
Executable File
external help file, Module Name, online version, schema
| external help file | Module Name | online version | schema |
|---|---|---|---|
| VMware.HV.Helper-help.xml | VMware.HV.Helper | 2.0.0 |
Get-HVFarm
SYNOPSIS
This function is used to find farms based on the search criteria provided by the user.
SYNTAX
Get-HVFarm [[-FarmName] <String>] [[-FarmDisplayName] <String>] [[-FarmType] <String>] [[-Enabled] <Boolean>]
[[-SuppressInfo] <Boolean>] [[-HvServer] <Object>] [<CommonParameters>]
DESCRIPTION
This function queries the specified Connection Server for farms which are configured on the server. If no farm is configured on the specified connection server or no farm matches the given search criteria, it will return null.
EXAMPLES
EXAMPLE 1
Get-HVFarm -FarmName 'Farm-01'
Queries and returns farmInfo based on given parameter farmName
EXAMPLE 2
Get-HVFarm -FarmName 'Farm-01' -FarmDisplayName 'Sales RDS Farm'
Queries and returns farmInfo based on given parameters farmName, farmDisplayName
EXAMPLE 3
Get-HVFarm -FarmName 'Farm-01' -FarmType 'MANUAL'
Queries and returns farmInfo based on given parameters farmName, farmType
EXAMPLE 4
Get-HVFarm -FarmName 'Farm-01' -FarmType 'MANUAL' -Enabled $true
Queries and returns farmInfo based on given parameters farmName, FarmType etc
EXAMPLE 5
Get-HVFarm -FarmName 'Farm-0*'
Queries and returns farmInfo based on parameter farmName with wild character *
PARAMETERS
-FarmName
farmName to be searched
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FarmDisplayName
farmDisplayName to be searched
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FarmType
farmType to be searched. It can take following values: "AUTOMATED" - search for automated farms only 'MANUAL' - search for manual farms only
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Enabled
search for farms which are enabled
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-SuppressInfo
Suppress text info, when no farm found with given search parameters
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-HvServer
Reference to Horizon View Server to query the data 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 the list of FarmInfo object matching the query criteria.
NOTES
| Author | praveen mathamsetty. |
| Author email | pmathamsetty@vmware.com |
| Version | 1.1 |
===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 |