PowerShell Logo Small

New-RDRemoteApp



This is the built-in help made by Microsoft for the command 'New-RDRemoteApp', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 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

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.