New-RdsRemoteApp

Modul:: Microsoft.RDInfra.RDPowershell

Lägger till ett RemoteApp-program i en appgrupp.

Syntax

New-RdsRemoteApp
   [-TenantName] <String>
   [-HostPoolName] <String>
   [-AppGroupName] <String>
   [-Name] <String>
   [-FilePath <String>]
   [-CommandLineSetting <CommandLineSetting>]
   [-Description <String>]
   [-FileVirtualPath <String>]
   [-FolderName <String>]
   [-FriendlyName <String>]
   [-IconIndex <Int32>]
   [-IconPath <String>]
   [-RequiredCommandLine <String>]
   [-ShowInWebFeed]
   [<CommonParameters>]

New-RdsRemoteApp
   [-TenantName] <String>
   [-HostPoolName] <String>
   [-AppGroupName] <String>
   [-Name] <String>
   [-AppAlias <String>]
   [-CommandLineSetting <CommandLineSetting>]
   [-Description <String>]
   [-FileVirtualPath <String>]
   [-FolderName <String>]
   [-FriendlyName <String>]
   [-IconIndex <Int32>]
   [-IconPath <String>]
   [-RequiredCommandLine <String>]
   [-ShowInWebFeed]
   [<CommonParameters>]

Description

Lägger till ett RemoteApp-program i en RemoteApp-appgrupp. Detta resulterar i att appen publiceras. Det här kommandot misslyckas om du försöker publicera en RemoteApp till en skrivbordsappgrupp.

Exempel

Exempel 1: Publicera en RemoteApp genom att ange appaliaset

PS C:\> New-RdsRemoteApp -TenantName "contoso" -HostPoolname "contosoHostPool" -AppGroupName "officeApps" -Name "Excel" -AppAlias "excel"

TenantGroupName     : Default Tenant Group
TenantName          : contoso
HostPoolName        : contosoHostPool
AppGroupName        : officeApps
RemoteAppName       : Excel
FilePath            : C:\Program Files\Microsoft Office\root\Office16\EXCEL.EXE
AppAlias            :
CommandLineSetting  : DoNotAllow
Description         :
FriendlyName        : Excel
IconIndex           : 0
IconPath            : C:\Program Files\Microsoft
                      Office\Root\VFS\Windows\Installer\{90160000-000F-0000-1000-0000000FF1CE}\xlicons.exe
RequiredCommandLine :
ShowInWebFeed       : True

Det här kommandot publicerar en RemoteApp till appgruppen med alla egenskaper som är associerade med det angivna appaliaset. Det här kommandot kan användas för program som visas när du kör cmdleten Get-RdsStartMenuApp.

Exempel 2: Publicera en RemoteApp genom att manuellt ange information

PS C:\> New-RdsRemoteApp -TenantName "contoso" -HostPoolname "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -FilePath "C:\Program Files\internet explorer\iexplore.exe" -FriendlyName "Contoso Web App" -IconPath "C:\Program Files\internet explorer\iexplore.exe"

TenantGroupName     : Default Tenant Group
TenantName          : contoso
HostPoolName        : contosoHostPool
AppGroupName        : webApps
RemoteAppName       : internetExplorerContosoWebApp
FilePath            : C:\Program Files\internet explorer\iexplore.exe
AppAlias            :
CommandLineSetting  : DoNotAllow
Description         :
FriendlyName        : Contoso Web App
IconIndex           : 0
IconPath            : C:\Program Files\internet explorer\iexplore.exe
RequiredCommandLine :
ShowInWebFeed       : True

Det här kommandot publicerar en RemoteApp till appgruppen med de angivna egenskaperna, inklusive standardvärden för egenskaperna CommandLineSettings och ShowInWebFeed. Det här kommandot kan användas för alla program och är det bästa sättet att publicera RemoteApps om det specifika programmet inte finns med i listan när du kör cmdleten Get-RdsStartMenuApp.

Parametrar

-AppAlias

En unik sträng som genereras av värdagenten för fjärrskrivbord för varje app på startmenyn innan den returneras av värdagenten. AppAlias returneras av cmdleten Get-RdsStartMenuApp och kan användas för att identifiera en app för publicering. Förekomsten av den här parametern avgör parameteruppsättningen AppAlias.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AppGroupName

Namnet på appgruppen.

Typ:	String
Position:	2
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-CommandLineSetting

Anger om RemoteApp-programmet accepterar kommandoradsargument från klienten vid anslutningen. De godtagbara värdena för den här parametern är:

Tillåt: Accepterar kommandoradsargument.
DoNotAllow: Accepterar inte kommandoradsargument.
Kräv: Tillåter endast kommandoradsargument som anges i parametern RequiredCommandLine.

Typ:	CommandLineSetting
Godkända värden:	Allow, DoNotAllow, Require
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Description

En sträng på 512 tecken som beskriver RemoteApp för att hjälpa administratörer. Alla tecken tillåts.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FilePath

Anger en sökväg för den körbara filen för programmet. Den kan innehålla alla miljövariabler. Den här sökvägen måste vara en giltig lokal sökväg på alla sessionsvärdar i värdpoolen. Förekomsten av den här parametern avgör parameteruppsättningen FilePath.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FileVirtualPath

Filsökvägen till den körbara filen för programmet. Den här sökvägen måste vara konsekvent för alla sessionsvärdar i värdpoolen och tillåter miljövariabler.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FolderName

Anmärkning

Den här funktionen stöds inte ännu.

Namnet på mappen där programmet ska grupperas i fjärrskrivbordsklienterna.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FriendlyName

En sträng på 256 tecken som är avsedd att visas för slutanvändare. Alla tecken tillåts.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-HostPoolName

Namnet på värdpoolen.

Typ:	String
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-IconIndex

Indexet för ikonen från den körbara filen, enligt definitionen i parametern IconPath.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-IconPath

Anger en sökväg till ett program eller en ico-fil som ska visas för programmet. Den kanske inte innehåller några miljövariabler. Den här sökvägen måste vara en giltig lokal sökväg på alla sessionsvärdar i värdpoolen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Namnet på RemoteApp, som måste vara unikt i appgruppen. Alias: RemoteAppName.

Typ:	String
Alias:	RemoteAppName
Position:	3
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-RequiredCommandLine

Anger en sträng som innehåller kommandoradsargument som klienten kan använda vid anslutning till RemoteApp-programmet. Om du anger den här parametern CommandLineSetting måste parametern ha värdet Require.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ShowInWebFeed