Set-RdsRemoteApp

Referens

Modul:: WindowsVirtualDesktopPowershell

Anger egenskaperna för en RemoteApp.

Syntax

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

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

Description

Cmdleten Set-RdsRemoteApp anger egenskaperna för en RemoteApp som publiceras till den angivna appgruppen. Med det här kommandot kan du ändra ikonen som visas för RemoteApp, det egna namnet på RemoteApp som visas i fjärrskrivbordsklienter och startkörningen av RemoteApp (via kommandoradsparametrar).

Exempel

Exempel 1: Ändra det egna namnet på RemoteApp

PS C:\> Set-RdsRemoteApp -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -FriendlyName "Contoso Web App v2"

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 v2
IconIndex           : 0
IconPath            : C:\Program Files\internet explorer\iexplore.exe
RequiredCommandLine :
ShowInWebFeed       : True

Det här kommandot ändrar det egna namnet på RemoteApp till "Contoso Web App v2" som visas för slutanvändare i fjärrskrivbordsklienter.

Exempel 2: Ändra kommandoradsegenskaperna för RemoteApp

PS C:\> Set-RdsRemoteApp -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -CommandLineSetting Require -RequiredCommandLine "https://webapp.contoso.com"

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

Det här kommandot ändrar kommandoradsargumenten i Internet Explorer för att alltid starta "https://webapp.contoso.com".

Parametrar

-AppAlias

En unik sträng som genereras av fjärrskrivbordsvärdagenten för varje startmenyapp 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppGroupName

Namnet på appgruppen.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CommandLineSetting

Anger om RemoteApp-programmet accepterar kommandoradsargument från klienten vid anslutningstiden. De acceptabla 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.

Type:	CommandLineSetting
Accepted values:	Allow, DoNotAllow, Require
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FolderName

Anteckning

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FriendlyName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostPoolName

Namnet på värdpoolen.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IconIndex

Index för ikonen från den körbara filen enligt definitionen av parametern IconPath.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IconPath

Anger en sökväg till ett program eller en ico-fil som ska visas för programmet. Det får inte innehålla 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Namnet på RemoteApp.

Type:	String
Aliases:	RemoteAppName
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RequiredCommandLine

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShowInWebFeed