PowerShell Logo Small

New-RDRemoteApp



This is the built-in help made by Microsoft for the command 'New-RDRemoteApp', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Publishes a RemoteApp program to a Remote Desktop deployment.

SYNTAX


New-RDRemoteApp [-CollectionName] <String> [-Alias <String>] [-CommandLineSetting <CommandLineSettingValue>] [-ConnectionBroker <String>] [-FileVirtualPath <String>]
[-FolderName <String>] [-IconIndex <String>] [-IconPath <String>] [-RequiredCommandLine <String>] [-ShowInWebAccess <Boolean>] [-UserGroups <String[]>] -DisplayName <String>
-FilePath <String> [<CommonParameters>]
New-RDRemoteApp [-CollectionName] <String> [-Alias <String>] [-CommandLineSetting <CommandLineSettingValue>] [-ConnectionBroker <String>] [-FileVirtualPath <String>]
[-FolderName <String>] [-IconIndex <String>] [-IconPath <String>] [-RequiredCommandLine <String>] [-ShowInWebAccess <Boolean>] [-UserGroups <String[]>] -DisplayName <String>
-FilePath <String> -VirtualDesktopName <String> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-RDRemoteApp cmdlet publishes a Windows Server 2012 RemoteApp program to a Remote Desktop deployment, making it available to users.


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.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294239
Get-RDRemoteApp
Remove-RDRemoteApp
Set-RDRemoteApp

REMARKS

<

Examples


Example 1: Publish a RemoteApp program

PS C:\> New-RDRemoteApp -CollectionName "Session Collection" -DisplayName "Notepad" -FilePath "C:\Windows\System32\Notepad.exe"



This command creates a new RemoteApp program in the collection named Session Collection. The command specifies the display name Notepad and uses the .exe file at the
specified file path.




Example 2: Publish a RemoteApp program with a required argument

PS C:\> New-RDRemoteApp -CollectionName "Virtual Desktop Collection" -DisplayName "Bing" -FilePath "C:\Program Files\Internet Explorer\iexplore.exe" -VirtualDesktopName
"RDS-WKS-A27" -CommandLineSetting Require -RequiredCommandLine "https://www.bing.com"



This command publishes a RemoteApp to the collection named Virtual Desktop Collection. The command specifies the display name Bing and uses the .exe file at the specified
file path. The command specifies the virtual desktop name RDS-WKS-A27. This command uses a required command line argument. This RemoteApp opens the specified browser to go
to the specified URL.