# New-RASPubVDIDesktop ### NAME New-RASPubVDIDesktop\
### SYNOPSIS Adds a published VDI desktop to a site.\
### SYNTAX New-RASPubVDIDesktop \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#Name)] *\* \[-[AllowMultiMonitor](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#AllowMultiMonitor) {Enabled | Disabled | UseClientSettings}] \[-[ConnectTo](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#ConnectTo) {AnyGuest}] \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#Description) *\*] \[-[DesktopSize](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#DesktopSize) {UseAvailableArea | FullScreen | W640xH480 | W800xH600 | W854xH480 | W1024xH576 | W1024xH768 | W1152xH864 | W1280xH720 | W1280xH768 | W1280xH800 | W1280xH960 | W1280xH1024 | W1360xH768 | W1366xH768 | W1400xH1050 | W1440xH900 | W1600xH900 | W1600xH1024 | W1600xH1200 | W1680xH1050 | W1920xH1080 | W1920xH1200 | W1920xH1440 | W2048xH1152 | Custom}] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#Enabled) *\*] \[-[EnabledMode](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#EnabledMode) {Disabled | Enabled | Maintenance}] \[-[Height](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#Height) *\*] \[-[Icon](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#Icon) *\*] \[-[IconIndex](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#IconIndex) *\*] \[-[InheritMaintenance](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#InheritMaintenance) *\*] \[-[MaintenanceMessage\_de\_DE](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_de_DE) *\*] \[-[MaintenanceMessage\_en\_US](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_en_US) *\*] \[-[MaintenanceMessage\_es\_ES](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_es_ES) *\*] \[-[MaintenanceMessage\_fr\_FR](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_fr_FR) *\*] \[-[MaintenanceMessage\_it\_IT](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_it_IT) *\*] \[-[MaintenanceMessage\_ja\_JP](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_ja_JP) *\*] \[-[MaintenanceMessage\_ko\_KR](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_ko_KR) *\*] \[-[MaintenanceMessage\_nl\_NL](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_nl_NL) *\*] \[-[MaintenanceMessage\_pt\_BR](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_pt_BR) *\*] \[-[MaintenanceMessage\_zh\_CN](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_zh_CN) *\*] \[-[MaintenanceMessage\_zh\_TW](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#MaintenanceMessage_zh_TW) *\*] \[-[ParentFolder](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#ParentFolder) *<*[*PubFolder*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PubFolder.html)*>*] \[-[ParentId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#ParentId) *\*] \[-[Persistent](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#Persistent) *\*] \[-[PreviousId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#PreviousId) *\*] \[-[PreviousItem](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#PreviousItem) *<*[*PubItem*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PubItem.html)*>*] \[-[PublishToSite](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#PublishToSite) *<*[*Site\[\]*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/Site.html)*>*] \[-[PublishToSiteIds](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#PublishToSiteIds) *\*] \[-[ReplicateMaintenance](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#ReplicateMaintenance) *\*] \[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#SiteId) *\*] \[-[StartOnLogon](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#StartOnLogon) *\*] \[-[VDIHostPool](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#VDIHostPool) *<*[*VDIHostPool*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/VDIHostPool.html)*>*] \[-[VDIHostPoolId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#VDIHostPoolId) *\*] \[-[VDITemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#VDITemplate) *<*[*Template*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/Template.html)*>*] \[-[VDITemplateId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#VDITemplateId) *\*] \[-[Width](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#Width) *\*] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASPubVDIDesktop.html#CommonParameters)*>*]\
### DESCRIPTION Adds a published VDI desktop to a site.\ \ In case of connecting to Any Desktop, one must specify a VDI Pool Id or Object.\
### PARAMETERS \ -**Persistent \**\ Specifies whether the connection is persistent or not.\
``` Required? false ``` ``` Position? named ``` ``` Default value True ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ConnectTo <**[**VDIMatchingMode**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/VDIMatchingMode.html)**>**\ Specifies the 'Matching Mode' option to connect with.\ \ Acceptable values: AnyGuest. Default: AnyGuest.\ \ Possible values: AnyGuest\
``` Required? false ``` ``` Position? named ``` ``` Default value AnyGuest ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VDIHostPoolId \**\ Specifies the VDI Host Pool ID from which to publish a desktop.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VDIHostPool <**[**VDIHostPool**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/VDIHostPool.html)**>**\ Specifies the VDI Host Pool from which to publish a desktop.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VDITemplateId \**\ Specifies the VDI Template ID from which to publish an application.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**VDITemplate <**[**Template**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/Template.html)**>**\ Specifies the RAS Template from which to publish a desktop.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**StartOnLogon \**\ Enable or disable the 'Start automatically when user logs on' option.\
``` Required? false ``` ``` Position? named ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Width \**\ Specifies a custom desktop width.\
``` Required? false ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Height \**\ Specifies a custom desktop height.\
``` Required? false ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**DesktopSize <**[**DesktopSize**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/DesktopSize.html)**>**\ Desktop Size. Possible values are: 0 (Use available area), 1 (Full screen), Custom = 25.\ \ Acceptable values: 640x480, 800x600, 854x480, 1024x576, 1024x768, 1152x864, 1280x720,\ \ 1280x768, 1280x800, 1280x960, 1280x1024, 1360x768, 1366x768,\ \ 1400x1050, 1440x900, 1600x900, 1600x1024, 1600x1200, 1680x1050,\ \ 1920x1440, 1920x1080, 1920x1200, 2048x1152\ \ Possible values: UseAvailableArea, FullScreen, W640xH480, W800xH600, W854xH480, W1024xH576, W1024xH768, W1152xH864, W1280xH720, W1280xH768, W1280xH800, W1280xH960, W1280xH1024, W1360xH768, W1366xH768, W1400xH1050, W1440xH900, W1600xH900, W1600xH1024, W1600xH1200, W1680xH1050, W1920xH1080, W1920xH1200, W1920xH1440, W2048xH1152, Custom\
``` Required? false ``` ``` Position? named ``` ``` Default value FullScreen ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**AllowMultiMonitor <**[**AllowMultiMonitor**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/AllowMultiMonitor.html)**>**\ Specifies the "Multi-monitor" option.\ \ Acceptable values: Enabled, Disabled, UseClientSettings.\ \ Possible values: Enabled, Disabled, UseClientSettings\
``` Required? false ``` ``` Position? named ``` ``` Default value UseClientSettings ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Name \**\ Published resource name.\
``` Required? true ``` ``` Position? 0 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ParentFolder <**[**PubFolder**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PubFolder.html)**>**\ Parent publishing folder.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? true (ByValue, ByPropertyName) ``` ``` Accept wildcard characters? false ``` \ -**ParentId \**\ Parent publishing folder ID.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PreviousItem <**[**PubItem**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PubItem.html)**>**\ Previous published item.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PreviousId \**\ Previous published ID.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Icon \**\ An icon to use for a publishing resource.\ \ This 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 \**\ 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 \**\ Replicate Maintenance.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**InheritMaintenance \**\ Inherit Maintenance.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Enabled \**\ Enable or disable a published resource.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnabledMode <**[**PubResourceEnabledMode**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PubResourceEnabledMode.html)**>**\ 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 \**\ 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 \**\ 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 \**\ 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 \**\ 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 \**\ 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 \**\ Maintenance message for the published resource in Portuguese.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**MaintenanceMessage\_de\_DE \**\ Maintenance message for the published resource in German.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**MaintenanceMessage\_nl\_NL \**\ Maintenance message for the published resource in Dutch.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**MaintenanceMessage\_zh\_TW \**\ 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 \**\ 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 \**\ Maintenance message for the published resource in Korean.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Description \**\ Published resource description.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PublishToSite <**[**Site\[\]**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/Site.html)**>**\ 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 \**\ An array of Sites IDs to which to publish a resource.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SiteId \**\ Site ID.\
``` Required? false ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ \ ``` This cmdlet supports the common parameters: Verbose, Debug, ``` ``` ErrorAction, ErrorVariable, WarningAction, WarningVariable, ``` ``` OutBuffer, PipelineVariable, and OutVariable. For more information, see ``` ``` about_CommonParameters . ```
### INPUTS [PubFolder](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PubFolder.html) ### OUTPUTS [PubVDIDesktop](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PubVDIDesktop.html) ### EXAMPLES \ \&#xNAN;**---------- EXAMPLE 1 ----------**\ \ New-RASPubVDIDesktop "My VDI Desktop"\ \ Adds a published desktop and gives it the specified name.