Set-RASPubLocalApp.md

NAME

Set-RASPubLocalApp

SYNOPSIS

Modifies properties of a published application.

SYNTAX

Set-RASPubLocalApp [Id] (uint) [AndroidEnabled (bool)] [CreateShortcutInStartFolder (bool)] [CreateShortcutInStartUpFolder (bool)] [CreateShortcutOnDesktop (bool)] [Description (string)] [-EnabledMode {Disabled | Enabled | Maintenance}] [ExcludePrelaunch (bool)] [Icon (string)] [IconIndex (uint)] [InheritShortcutDefaultSettings (bool)] [iOSEnabled (bool)] [LinuxEnabled (bool)] [MacEnabled (bool)] [Name (string)] [PreferredRoutingEnabled (bool)] [-PublishToSite (Site[])] [-PublishToSiteIds (uint[])] [ReplicateLocalAppSettings (bool)] [ReplicateShortcutSettings (bool)] [SiteId (uint)] [StartOnLogon (bool)] [StartPath (string)] [URL (string)] [UserPortalEnabled (bool)] [WindowsEnabled (bool)] [WindowsParameters (string)] [WindowsStartIn (string)] [WindowsTarget (string)] [WindowsUseIfAvailable (bool)] [-WindowsWinType {Normal | Maximized | Minimized}] [(CommonParameters)]

**Set-RASPubLocalApp [-InputObject] (PubItem) [AndroidEnabled (bool)] [CreateShortcutInStartFolder (bool)] [CreateShortcutInStartUpFolder (bool)] [CreateShortcutOnDesktop (bool)] [Description (string)] [-EnabledMode {Disabled | Enabled | Maintenance}] [ExcludePrelaunch (bool)] [Icon (string)] [IconIndex (uint)] [InheritShortcutDefaultSettings (bool)] [iOSEnabled (bool)] [LinuxEnabled (bool)] [MacEnabled (bool)] [Name (string)] [PreferredRoutingEnabled (bool)] [-PublishToSite (Site[])] [-PublishToSiteIds (uint[])] [ReplicateLocalAppSettings (bool)] [ReplicateShortcutSettings (bool)] [SiteId (uint)] [StartOnLogon (bool)] [StartPath (string)] [URL (string)] [UserPortalEnabled (bool)] [WindowsEnabled (bool)] [WindowsParameters (string)] [WindowsStartIn (string)] [WindowsTarget (string)] [WindowsUseIfAvailable (bool)] [-WindowsWinType {Normal | Maximized | Minimized}] [(CommonParameters)]

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 (e.g. Set-RASPubItemClientFilter).

PARAMETERS

URL (string)

URL.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

WindowsEnabled (bool)

Windows: Whether the application is enabled for the operating system or not.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

WindowsUseIfAvailable (bool)

Windows: Use the following application if available on local device.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

WindowsStartIn (string)

Windows: Application working directory.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

WindowsTarget (string)

Windows: Application target file. (i.e. calc.exe, file.txt, etc.).

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

WindowsParameters (string)

Windows: Application parameters.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

WindowsWinType (WindowType)

Windows: Window Type: 0=Normal, 1=Maximized, 2=Minimized.

Possible values: Normal, Maximized, Minimized

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

MacEnabled (bool)

Mac: Whether the application is enabled for the operating system or not.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

LinuxEnabled (bool)

Linux: Whether the application is enabled for the operating system or not.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

iOSEnabled (bool)

iOS: Whether the application is enabled for the operating system or not.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

AndroidEnabled (bool)

Android: Whether the application is enabled for the operating system or not.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

UserPortalEnabled (bool)

UserPortal: Whether the application is enabled for the operating system or not.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

ReplicateLocalAppSettings (bool)

Whether to replicate local application settings or not.

        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

EnabledMode

(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

Description (string)

Published resource description.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

PublishToSite (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)

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

OUTPUTS

-none-

EXAMPLES

**---------- EXAMPLE 1 ----------

Set-RASPubLocalApp -Id 1 -Enabled $false

Disables a published application specified by ID. **---------- EXAMPLE 2 ----------

Get-RASPubLocalApp -Id 1 | Set-RASPubLocalApp -Enabled $false

Disables a published application specified by an object obtained from the pipeline output. **---------- EXAMPLE 3 ----------

Set-RASPubLocalApp -Id 56 -URL "mock/example/url"

Modify the URL parameter (application properties) according to passed string.

RELATED LINKS

• Get-RASPubLocalApp

• Remove-RASPubLocalApp

• Set-RASRule

• Set-RASCriteria

• Set-RASPubDefaultSettings