NAME
Set-RASPubRDSApp
SYNOPSIS
Modifies properties of a published application.
SYNTAX
Set-RASPubRDSApp [(uint) **
[-(uint) ]
[(bool) ]
[(bool) ]
[(bool) ] [(string) ]
[(bool) ] [-(bool) ]
[(bool) ] [(string) ] [(string) ]
[(uint) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ] [(string) ]
[(bool) ] [(string) ]
[(string) ]
[(string) ]
[(bool) ] [-( ) ]
[-(uint[]) ]
[-( ) ]
[-(uint[]) ] [-( ) ]
[-(uint[]) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ] [(uint) ]
[(uint) ]
[(bool) ]
[(string) ]
[(bool) ]
[(bool) ]
[(string) ]
[(string) ]
[(bool) ]
[(uint) ] [-( ) ]
Set-RASPubRDSApp
[-( )
[-(uint) ]
[(bool) ]
[(bool) ]
[(bool) ] [(string) ]
[(bool) ] [-(bool) ]
[(bool) ] [(string) ] [(string) ]
[(uint) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ]
[-(string) ] [(string) ]
[(bool) ] [(string) ]
[(string) ]
[(string) ]
[(bool) ] [-( ) ]
[-(uint[]) ]
[-( ) ]
[-(uint[]) ] [-( ) ]
[-(uint[]) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ]
[(bool) ] [(uint) ]
[(uint) ]
[(bool) ]
[(string) ]
[(bool) ]
[(bool) ]
[(string) ]
[(string) ]
[(bool) ]
[(uint) ] [-( ) ]
DESCRIPTION
Modifies properties of a published application.
Use only the parameters (application properties) that you want to
modify.
To set filtering options, use the Pub Filtering cmdlets.
PARAMETERS
Specifies the 'Publish from' option.
Acceptable values: All (All Hosts in Site), HostPool (Host Pools), Host
(Individual Hosts).
Possible values: All, HostPool, Group, Host, Server
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false One or multiple server group from which to publish the application.
The PublishFrom parameter must be set to 1 (HostPool).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false PublishFromHostPoolIds (uint[])
Specifies one or multiple host pool Ids from which to publish the
application.
The PublishFrom parameter must specify 1 (HostPool).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false One or multiple RDS Host servers from which to publish the
application.
The PublishFrom parameter must be set to 2 (Host).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false PublishFromServerIds (uint[])
One or multiple RDS Host server Ids from which to publish the
application.
The PublishFrom parameter must specify 2 (Host).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ReplicateDisplaySettings (bool)
Enable or disable the 'Replicate settings' option (replicates display
settings to all sites).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false StartMaximized (bool)
Enable or disable the 'Start the application as maximized when using
mobile clients" option.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false StartFullscreen (bool)
Enable or disable the 'Start in fullscreen mode for WYSE ThinOS clients"
option.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false WaitForPrinters (bool)
Enable or disable the 'Wait until all RAS universal printers are
redirected before showing the application" option.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false WaitForPrintersTimeout (uint)
Printer redirection timeout (in seconds). Set this option when enabling
the WaitForPrinters option.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false Specifies the display color depth setting.
Possible values are: Colors8Bit, Colors15Bit, Colors16Bit, Colors24Bit,
Colors32Bit, ClientSpecified
Possible values: Colors8Bit, Colors15Bit, Colors16Bit, Colors24Bit,
Colors32Bit, ClientSpecified
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false InheritDisplayDefaultSettings (bool)
Enable or disable the 'Inherit default settings" option for display
properties.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ReplicateLicenseSettings (bool)
Enable or disable the 'Replicate licensing settings" (settings are
replicated to all sites).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false DisableSessionSharing (bool)
Enable or disable the 'Disable session sharing' option (licenses).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false OneInstancePerUser (bool)
Enable or disable the 'Allow users to start only one instance of the
application' option.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ConCurrentLicenses (uint)
Specifies the 'Concurrent licenses' option (the number of concurrent
licenses).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false Specifies the "If license limit is exceeded' option.
Acceptable values: WarnUserAndNoStart, WarnUserAndStart,
NotifyAdminAndStart, NotifyUserAdminAndStart,
NotifyUserAdminAndNoStart
Possible values: WarnUserAndNoStart, WarnUserAndStart,
NotifyAdminAndStart, NotifyUserAdminAndStart,
NotifyUserAdminAndNoStart
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false InheritLicenseDefaultSettings (bool)
Enable or disable the 'Inherit default license settings' option.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false EnableFileExtensions (bool)
Enable or disable the 'Enable File Extensions' option.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ReplicateFileExtensionSettings (bool)
Enable or disable the 'Replicate settings' option (replicates extension
settings to all sites).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ReplicateDefaultServerSettings (bool)
Enable or disable the 'Replicate settings' option (replicates default
server settings to all sites).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false FileExtensions (string)
List of file extensions to be added to the current list, if doesn't
exist(comma separated values).
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ServerId (uint)
Copy 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.
Copy 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.
Copy 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.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false Package (string)
The MSIX Package.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false PackagedApp (string)
The application within the MSIX package.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false Published application window type. Acceptable values: Normal, Maximized,
Minimized.
Possible values: Normal, Maximized, Minimized
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ReplicateShortcutSettings (bool)
Replicate shortcut settings to all sites.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false CreateShortcutOnDesktop (bool)
Create a shortcut on a client's desktop.
CreateShortcutInStartFolder (bool)
Create a shortcut in the client's Start folder.
Copy 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.
Copy 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.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false InheritShortcutDefaultSettings (bool)
Inherit default shortcut settings.
Copy 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.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ExcludePrelaunch (bool)
Exclude application from prelaunch.
Copy 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.
Copy 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.
Copy 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
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false ReplicateMaintenance (bool)
Replicate Maintenance
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false InheritMaintenance (bool)
Inherit Maintenance
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false EnabledMode
Possible values: Disabled, Enabled, Maintenance
Copy 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.
Copy 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.
Copy 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.
Copy 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.
Copy 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.
Copy 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.
Copy 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.
Copy 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.
Copy 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).
Copy 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).
Copy 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.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false Description (string)
Published resource description.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false An array of sites to which to publish a resource.
Copy 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.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false PreferredRoutingEnabled (bool)
Enable or disable Preferred Routing.
Copy Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false Id (uint)
Published resource ID.
Copy Required? true
Position? 0
Default value 0
Accept pipeline input? false
Accept wildcard characters? false An object specifying the published resource.
To obtain the object, use the Get-PubItem cmdlet.
Copy Required? true
Position? 0
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false SiteId (uint)
Site ID.
Copy Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false (CommonParameters)
Copy This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters documentation. OUTPUTS
-none-
EXAMPLES
**---------- EXAMPLE 1 ----------
Set-RASPubRDSApp -Id 1 -Enabled $false
Disables a published application specified by ID.
**---------- EXAMPLE 2 ----------
Set-RASPubRDSApp $PubRDSApp -Enabled $false
Disables a published application specified by the $PubRDSApp object.
**---------- EXAMPLE 3 ----------
Get-RASPubRDSApp -Id 1 | Set-RASPubRDSApp -Enabled $false
Disables a published application specified by an object obtained from
the pipeline output.
**---------- EXAMPLE 4 ----------
Set-RASPubRDSApp -Id 1 -Package "AppPackage2" -PackagedApp "TestApp2"
Modifies the package and application package details of the published
application specified by ID.
