# Set-RASPubVDIApp ## NAME Set-RASPubVDIApp ## SYNOPSIS Modifies properties of a published VDI application. ## SYNTAX **Set-RASPubVDIApp** \[[Id](#id-string)] *(uint)*\*\* \[-[ConnectTo](#ConnectTo) {AnyGuest}] \[[CreateShortcutInStartFolder](#createshortcutinstartfolder-string) *(bool)*] \[[CreateShortcutInStartUpFolder](#createshortcutinstartupfolder-string) *(bool)*] \[[CreateShortcutOnDesktop](#createshortcutondesktop-string) *(bool)*] \[[Description](#description-string) *(string)*] \[-[EnabledMode](#EnabledMode) {Disabled | Enabled | Maintenance}] \[[ExcludePrelaunch](#excludeprelaunch-string) *(bool)*] \[[Icon](#icon-string) *(string)*] \[[IconIndex](#iconindex-string) *(uint)*] \[[InheritMaintenance](#inheritmaintenance-string) *(bool)*] \[[InheritShortcutDefaultSettings](#inheritshortcutdefaultsettings-string) *(bool)*] \[-[MaintenanceMessage\_de\_DE](#MaintenanceMessage_de_DE) *(string)*] \[-[MaintenanceMessage\_en\_US](#MaintenanceMessage_en_US) *(string)*] \[-[MaintenanceMessage\_es\_ES](#MaintenanceMessage_es_ES) *(string)*] \[-[MaintenanceMessage\_fr\_FR](#MaintenanceMessage_fr_FR) *(string)*] \[-[MaintenanceMessage\_it\_IT](#MaintenanceMessage_it_IT) *(string)*] \[-[MaintenanceMessage\_ja\_JP](#MaintenanceMessage_ja_JP) *(string)*] \[-[MaintenanceMessage\_ko\_KR](#MaintenanceMessage_ko_KR) *(string)*] \[-[MaintenanceMessage\_nl\_NL](#MaintenanceMessage_nl_NL) *(string)*] \[-[MaintenanceMessage\_pt\_BR](#MaintenanceMessage_pt_BR) *(string)*] \[-[MaintenanceMessage\_zh\_CN](#MaintenanceMessage_zh_CN) *(string)*] \[-[MaintenanceMessage\_zh\_TW](#MaintenanceMessage_zh_TW) *(string)*] \[[Name](#name-string) *(string)*] \[[Package](#package-string) *(string)*] \[[PackagedApp](#packagedapp-string) *(string)*] \[[Parameters](#parameters-string) *(string)*] \[[Persistent](#persistent-string) *(bool)*] \[[PreferredRoutingEnabled](#preferredroutingenabled-string) *(bool)*] \[-[PublishToSite](#PublishToSite) *(*[*Site\[\]*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/site)*)*] \[-[PublishToSiteIds](#PublishToSiteIds) *(uint\[])*] \[[ReplicateMaintenance](#replicatemaintenance-string) *(bool)*] \[[ReplicateShortcutSettings](#replicateshortcutsettings-string) *(bool)*] \[[SiteId](#siteid-string) *(uint)*] \[[StartIn](#startin-string) *(string)*] \[[StartOnLogon](#startonlogon-string) *(bool)*] \[[StartPath](#startpath-string) *(string)*] \[[Target](#target-string) *(string)*] \[-[VDIHostPool](#VDIHostPool) *(*[*VDIHostPool*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/vdihostpool)*)*] \[[VDIHostPoolId](#vdihostpoolid-string) *(uint)*] \[-[VDITemplate](#VDITemplate) *(*[*Template*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/template)*)*] \[-[WinType](#WinType) {Normal | Maximized | Minimized}] \[*(*[*CommonParameters*](#CommonParameters)*)*] **Set-RASPubVDIApp** \[-[InputObject](#inputobject)] *(*[*PubItem*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/pubitem)*)* \[-[ConnectTo](#ConnectTo) {AnyGuest}] \[[CreateShortcutInStartFolder](#createshortcutinstartfolder-string) *(bool)*] \[[CreateShortcutInStartUpFolder](#createshortcutinstartupfolder-string) *(bool)*] \[[CreateShortcutOnDesktop](#createshortcutondesktop-string) *(bool)*] \[[Description](#description-string) *(string)*] \[-[EnabledMode](#EnabledMode) {Disabled | Enabled | Maintenance}] \[[ExcludePrelaunch](#excludeprelaunch-string) *(bool)*] \[[Icon](#icon-string) *(string)*] \[[IconIndex](#iconindex-string) *(uint)*] \[[InheritMaintenance](#inheritmaintenance-string) *(bool)*] \[[InheritShortcutDefaultSettings](#inheritshortcutdefaultsettings-string) *(bool)*] \[-[MaintenanceMessage\_de\_DE](#MaintenanceMessage_de_DE) *(string)*] \[-[MaintenanceMessage\_en\_US](#MaintenanceMessage_en_US) *(string)*] \[-[MaintenanceMessage\_es\_ES](#MaintenanceMessage_es_ES) *(string)*] \[-[MaintenanceMessage\_fr\_FR](#MaintenanceMessage_fr_FR) *(string)*] \[-[MaintenanceMessage\_it\_IT](#MaintenanceMessage_it_IT) *(string)*] \[-[MaintenanceMessage\_ja\_JP](#MaintenanceMessage_ja_JP) *(string)*] \[-[MaintenanceMessage\_ko\_KR](#MaintenanceMessage_ko_KR) *(string)*] \[-[MaintenanceMessage\_nl\_NL](#MaintenanceMessage_nl_NL) *(string)*] \[-[MaintenanceMessage\_pt\_BR](#MaintenanceMessage_pt_BR) *(string)*] \[-[MaintenanceMessage\_zh\_CN](#MaintenanceMessage_zh_CN) *(string)*] \[-[MaintenanceMessage\_zh\_TW](#MaintenanceMessage_zh_TW) *(string)*] \[[Name](#name-string) *(string)*] \[[Package](#package-string) *(string)*] \[[PackagedApp](#packagedapp-string) *(string)*] \[[Parameters](#parameters-string) *(string)*] \[[Persistent](#persistent-string) *(bool)*] \[[PreferredRoutingEnabled](#preferredroutingenabled-string) *(bool)*] \[-[PublishToSite](#PublishToSite) *(*[*Site\[\]*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/site)*)*] \[-[PublishToSiteIds](#PublishToSiteIds) *(uint\[])*] \[[ReplicateMaintenance](#replicatemaintenance-string) *(bool)*] \[[ReplicateShortcutSettings](#replicateshortcutsettings-string) *(bool)*] \[[SiteId](#siteid-string) *(uint)*] \[[StartIn](#startin-string) *(string)*] \[[StartOnLogon](#startonlogon-string) *(bool)*] \[[StartPath](#startpath-string) *(string)*] \[[Target](#target-string) *(string)*] \[-[VDIHostPool](#VDIHostPool) *(*[*VDIHostPool*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/vdihostpool)*)*] \[[VDIHostPoolId](#vdihostpoolid-string) *(uint)*] \[-[VDITemplate](#VDITemplate) *(*[*Template*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/template)*)*] \[-[WinType](#WinType) {Normal | Maximized | Minimized}] \[*(*[*CommonParameters*](#CommonParameters)*)*] ## DESCRIPTION Modifies properties of a published VDI application. Use only the parameters (application properties) that you want to modify. To set filtering options, use the Pub Filtering cmdlets. ## PARAMETERS ## Persistent (bool) Specifies whether the connection is persistent or not. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ConnectTo ([VDIMatchingMode](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/vdimatchingmode)) Specifies the 'Matching Mode' option to connect with. Acceptable values: AnyGuest. Possible values: AnyGuest ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VDIHostPoolId (uint) Specifies the VDI Host Pool from which to publish an application. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VDIHostPool ([VDIHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/vdihostpool)) Specifies the VDI Host Pool from which to publish an application. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## VDITemplate ([Template](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/template)) Specifies the RAS template from which to publish an application. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Target (string) File name and path of a published application executable. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## StartIn (string) Folder name in which to start a published application. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Parameters (string) Optional parameters to pass to the published application executable. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Package (string) The MSIX Package. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## PackagedApp (string) The application within the MSIX package. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## WinType ([WindowType](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/windowtype)) Published application window type. Acceptable values: Normal, Maximized, Minimized. Possible values: Normal, Maximized, Minimized ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ReplicateShortcutSettings (bool) Replicate shortcut settings to all sites. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## CreateShortcutOnDesktop (bool) Create a shortcut on a client's desktop. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## CreateShortcutInStartFolder (bool) Create a shortcut in the client's Start folder. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## CreateShortcutInStartUpFolder (bool) Create a shortcut in the client's Auto Start folder. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## StartPath (string) Specifies the path in the Start folder where the shortcut will be created. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## InheritShortcutDefaultSettings (bool) Inherit default shortcut settings. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## StartOnLogon (bool) Start a resource automatically when a user logs on. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ExcludePrelaunch (bool) Exclude application from prelaunch. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Name (string) A new name to assign to the published resource. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Icon (string) Published resource icon file name. Can be an executable (.exe), a .dll or a .ico file. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## IconIndex (uint) Icon index Specifies the index of the icon that will be loaded from the binary specified in the Icon property ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ReplicateMaintenance (bool) Replicate Maintenance ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## InheritMaintenance (bool) Inherit Maintenance ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## EnabledMode ([PubResourceEnabledMode](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/pubresourceenabledmode)) Changes the availability status of the published resource. Possible values: Disabled, Enabled, Maintenance ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_en\_US (string) Maintenance message for the published resource in English. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_ja\_JP (string) Maintenance message for the published resource in Japanese. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_fr\_FR (string) Maintenance message for the published resource in French. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_es\_ES (string) Maintenance message for the published resource in Spanish. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_it\_IT (string) Maintenance message for the published resource in Italian. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_pt\_BR (string) Maintenance message for the published resource in Portuguese. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_nl\_NL (string) Maintenance message for the published resource in Dutch. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_de\_DE (string) Maintenance message for the published resource in German. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_zh\_TW (string) Maintenance message for the published resource in Chinese (Traditional). ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_zh\_CN (string) Maintenance message for the published resource in Chinese (Simplified). ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## MaintenanceMessage\_ko\_KR (string) Maintenance message for the published resource in Korean. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Description (string) Published resource description. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## PublishToSite ([Site\[\]](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/site)) An array of sites to which to publish a resource. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## PublishToSiteIds (uint\[]) An array of sites to which to publish a resource. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## PreferredRoutingEnabled (bool) Enable or disable Preferred Routing. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## Id (uint) Published resource ID. ``` Required? true Position? 0 Default value 0 Accept pipeline input? false Accept wildcard characters? false ``` ## InputObject ([PubItem](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/pubitem)) An object specifying the published resource. To obtain the object, use the Get-PubItem cmdlet. ``` Required? true Position? 0 Default value Accept pipeline input? true (ByValue) Accept wildcard characters? false ``` ## SiteId (uint) Site ID. ``` Required? false Position? named Default value 0 Accept pipeline input? false Accept wildcard characters? false ``` (CommonParameters) ``` This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters documentation. ``` ## INPUTS [PubItem](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/pubitem) ## OUTPUTS -none- ## EXAMPLES **---------- EXAMPLE 1 ----------** Set-RASPubVDIApp -Id 1 -Enabled $false Disables a published application specified by ID.\ \&#xNAN;**---------- EXAMPLE 2 ----------** Set-RASPubVDIApp $PubVDIApp -Enabled $false Disables a published application specified by the $PubVDIApp object.\ \&#xNAN;**---------- EXAMPLE 3 ----------** Get-RASPubVDIApp -Id 1 | Set-RASPubVDIApp -Enabled $false Disables a published application specified by an object obtained from the pipeline output.\ \&#xNAN;**---------- EXAMPLE 4 ----------** Set-RASPubVDIApp -Id 1 -Package "AppPackage2" -PackagedApp "TestApp2" Modifies the package and application package details of the published application specified by ID. ## RELATED LINKS * [Get-RASPubVDIApp](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/get-raspubvdiapp) * [Remove-RASPubVDIApp](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/remove-raspubvdiapp) * [Set-RASPubDefaultSettings](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/set-raspubdefaultsettings)