Edit

Share via


Get-RDRemoteApp

Gets RemoteApp programs in a Remote Desktop deployment.

Syntax

Default (Default)

Get-RDRemoteApp
    [[-CollectionName] <String>]
    [[-Alias] <String>]
    [-DisplayName <String[]>]
    [-ConnectionBroker <String>]
    [<CommonParameters>]

Description

The Get-RDRemoteApp cmdlet gets Windows Server 2012 RemoteApp programs in a Remote Desktop deployment. You can specify a collection name, an alias, or one or more display names.

RemoteApp allows Remote Desktop Services (RDS) to run a program remotely that appears as if it runs locally on a client computer. A RemoteApp program runs in its own resizable window and has its own entry on the taskbar.

Examples

Example 1: Get RemoteApp programs for a collection

PS C:\> Get-RDRemoteApp -CollectionName "Session Collection"

This command gets RemoteApp programs for the collection named Session Collection, as specified by the CollectionName parameter.

Example 2: Get RemoteApp programs by using a display name

PS C:\> Get-RDRemoteApp -DisplayName Note*

This command gets RemoteApp programs that begin with the string Note.

Parameters

-Alias

Specifies an alias for a RemoteApp program.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CollectionName

Specifies the name of a personal virtual desktop collection or session collection.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-ConnectionBroker

Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for a Remote Desktop deployment. If you do not specify a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisplayName

Specifies an array of names to display to users for RemoteApp programs. You can use a wildcard character.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

Microsoft.RemoteDesktopServices.Management.RemoteApp