New-RdsRemoteApp

Modul:

Microsoft.RDInfra.RDPowershell Module

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

Syntax

RA1 (Standard)

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>]

RA2

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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

RA2

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-AppGroupName

Namnet på appgruppen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	2
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	CommandLineSetting
Standardvärde:	None
Godkända värden:	Allow, DoNotAllow, Require
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Description

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

RA1

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FolderName

Anmärkning

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

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FriendlyName

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-HostPoolName

Namnet på värdpoolen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	1
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-IconIndex

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

Parameteregenskaper

Typ:	Int32
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Name

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	RemoteAppName (på engelska)

Parameteruppsättningar

(All)

Position:	3
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ShowInWebFeed

Anmärkning

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

Anger om RemoteApp-programmet ska visas i webbfeeden. Som standard visas alla RemoteApps. Detta gör att administratören kan stänga av ett program tillfälligt och sedan aktivera det igen utan att ta bort och återskapa den anpassade appinformationen.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-TenantName

Namnet på hyresgästen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	0
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

System.String

Utdata

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp