For the complete documentation index, see llms.txt. This page is also available as Markdown.

New-RASPubVDIDesktop

SYNOPSIS

Adds a published VDI desktop to a site.

SYNTAX

New-RASPubVDIDesktop [-Name] <string> [-AllowMultiMonitor {Enabled | Disabled | UseClientSettings}]
 [-ConnectTo {AnyGuest}] [-Description <string>]
 [-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}]
 [-EnabledMode {Disabled | Enabled | Maintenance}] [-EnableStaticAssignmentToHost <bool>]
 [-Height <uint>] [-Icon <string>] [-IconIndex <uint>] [-InheritMaintenance <bool>]
 [-MaintenanceMessage_de_DE <string>] [-MaintenanceMessage_en_US <string>]
 [-MaintenanceMessage_es_ES <string>] [-MaintenanceMessage_fr_FR <string>]
 [-MaintenanceMessage_it_IT <string>] [-MaintenanceMessage_ja_JP <string>]
 [-MaintenanceMessage_ko_KR <string>] [-MaintenanceMessage_nl_NL <string>]
 [-MaintenanceMessage_pt_BR <string>] [-MaintenanceMessage_zh_CN <string>]
 [-MaintenanceMessage_zh_TW <string>] [-ParentFolder <PubFolder>] [-ParentId <uint>]
 [-PreviousId <uint>] [-PreviousItem <PubItem>] [-PublishToSite <Site[]>]
 [-PublishToSiteIds <uint[]>] [-ReplicateMaintenance <bool>] [-SiteId <uint>]
 [-StartOnLogon <SwitchParameter>] [-VDIHostPool <VDIHostPool>] [-VDIHostPoolId <uint>]
 [-VDITemplate <Template>] [-VDITemplateId <uint>] [-Width <uint>] [<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.

EXAMPLES

Example 1

Adds a published desktop and gives it the specified name.

PARAMETERS

-EnableStaticAssignmentToHost

Specifies whether the static assignment to host is enabled or not.

-ConnectTo

Specifies the 'Matching Mode' option to connect with.

Acceptable values: AnyGuest. Default: AnyGuest.

Possible values: AnyGuest

Type reference: VDIMatchingMode

-VDIHostPoolId

Specifies the VDI Host Pool ID from which to publish a desktop.

-VDIHostPool

Specifies the VDI Host Pool from which to publish a desktop.

Type reference: VDIHostPool

-VDITemplateId

Specifies the VDI Template ID from which to publish an application.

-VDITemplate

Specifies the RAS Template from which to publish a desktop.

Type reference: Template

-StartOnLogon

Enable or disable the 'Start automatically when user logs on' option.

-Width

Specifies a custom desktop width.

-Height

Specifies a custom desktop height.

-DesktopSize

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

Type reference: DesktopSize

-AllowMultiMonitor

Specifies the "Multi-monitor" option.

Acceptable values: Enabled, Disabled, UseClientSettings.

Possible values: Enabled, Disabled, UseClientSettings

Type reference: AllowMultiMonitor

-Name

Published resource name.

-ParentFolder

Parent publishing folder.

Type reference: PubFolder

-ParentId

Parent publishing folder ID.

-PreviousItem

Previous published item.

Type reference: PubItem

-PreviousId

Previous published ID.

-Icon

An icon to use for a publishing resource.

This can be an executable (.exe), a .dll or a .ico file.

-IconIndex

Specifies the index of the icon that will be loaded from the binary specified in the Icon property.

-ReplicateMaintenance

Whether the option 'Replicate Maintenance' is enabled or not.

-InheritMaintenance

Whether to inherit default Maintenance settings.

-EnabledMode

Changes the availability status of the published resource.

Possible values: Disabled, Enabled, Maintenance

Type reference: PubResourceEnabledMode

-MaintenanceMessage_en_US

Maintenance message for the published resource in English.

-MaintenanceMessage_ja_JP

Maintenance message for the published resource in Japanese.

-MaintenanceMessage_fr_FR

Maintenance message for the published resource in French.

-MaintenanceMessage_es_ES

Maintenance message for the published resource in Spanish.

-MaintenanceMessage_it_IT

Maintenance message for the published resource in Italian.

-MaintenanceMessage_pt_BR

Maintenance message for the published resource in Portuguese.

-MaintenanceMessage_de_DE

Maintenance message for the published resource in German.

-MaintenanceMessage_nl_NL

Maintenance message for the published resource in Dutch.

-MaintenanceMessage_zh_TW

Maintenance message for the published resource in Chinese (Traditional).

-MaintenanceMessage_zh_CN

Maintenance message for the published resource in Chinese (Simplified).

-MaintenanceMessage_ko_KR

Maintenance message for the published resource in Korean.

-Description

Published resource description.

-PublishToSite

An array of sites to which to publish a resource.

Type reference: Site[]

-PublishToSiteIds

An array of Sites IDs to which to publish a resource.

-SiteId

Site ID in which to publish the specified Item.

If the parameter is omitted, the site ID of the Licensing Server will be used.

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

PubFolder

OUTPUTS

PubVDIDesktop

Last updated