Skip to content

New-HVManualApplication

SYNOPSIS

Creates a Manual Application.

SYNTAX

New-HVManualApplication [-HvServer <ViewServerImpl>] -Name <String> [-DisplayName <String>]
 [-Description <String>] -ExecutablePath <String> [-Version <String>] [-Publisher <String>]
 [-Enabled <Boolean>] [-EnablePreLaunch <Boolean>] [-ConnectionServerRestrictions <String[]>]
 [-CategoryFolderName <String>] [-clientRestrictions <Boolean>] [-ShortcutLocations <String[]>]
 [-MultiSessionMode <String>] [-MaxMultiSessions <Int32>] [-StartFolder <String>] [-Args <String>]
 -Farm <String> [-AutoUpdateFileTypes <Boolean>] [-AutoUpdateOtherFileTypes <Boolean>]
 [-GlobalApplicationEntitlement <String>] [<CommonParameters>]

DESCRIPTION

Creates Application manually with given parameters.

EXAMPLES

EXAMPLE 1

New-HVManualApplication -Name 'App1' -DisplayName 'DisplayName' -Description 'ApplicationDescription' -ExecutablePath "PathOfTheExecutable" -Version 'AppVersion' -Publisher 'PublisherName' -Farm 'FarmName'

Creates a manual application App1 in the farm specified.

PARAMETERS

-HvServer

View API service object of Connect-HVServer cmdlet.

Type: ViewServerImpl
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

The Application name is the unique identifier used to identify this Application.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-DisplayName

The display name is the name that users will see when they connect to view client. If the display name is left blank, it defaults to Name.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: $Name
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Description

The description is a set of notes about the Application.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ExecutablePath

Path to Application executable.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Version

Application version.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Publisher

Application publisher.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Enabled

Indicates if Application is enabled.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-EnablePreLaunch

Application can be pre-launched if value is true.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ConnectionServerRestrictions

Connection server restrictions. This is a list of tags that access to the application is restricted to. Empty/Null list means that the application can be accessed from any connection server.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-CategoryFolderName

Name of the category folder in the user's OS containing a shortcut to the application. Unset if the application does not belong to a category.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-clientRestrictions

Client restrictions to be applied to Application. Currently it is valid for RDSH pools.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ShortcutLocations

Locations of the category folder in the user's OS containing a shortcut to the desktop. The value must be set if categoryFolderName is provided.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-MultiSessionMode

Multi-session mode for the application. An application launched in multi-session mode does not support reconnect behavior when user logs in from a different client instance.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: DISABLED
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-MaxMultiSessions

Maximum number of multi-sessions a user can have in this application pool.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-StartFolder

Starting folder for Application.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Args

Parameters to pass to application when launching.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Farm

Farm name.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-AutoUpdateFileTypes

Whether or not the file types supported by this application should be allowed to automatically update to reflect changes reported by the agent.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-AutoUpdateOtherFileTypes

Whether or not the other file types supported by this application should be allowed to automatically update to reflect changes reported by the agent.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-GlobalApplicationEntitlement

The name of a Global Application Entitlement to associate this Application pool with.

Type: String
Parameter Sets: (All)
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

A success message is displayed when done.

NOTES

Author : Samiullasha S
Author email : ssami@omnissa.com
Version : 1.0

===Tested Against Environment==== | | | |-|-| Horizon View Server Version : 7.8.0 PowerCLI Version : PowerCLI 11.1 PowerShell Version : 5.0