Set-RdsRemoteApp

Reference

Modul:: WindowsVirtualDesktopPowershell

Nastaví vlastnosti pro 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

Rutina Set-RdsRemoteApp nastaví vlastnosti aplikace RemoteApp publikované do zadané skupiny aplikací. Pomocí tohoto příkazu můžete změnit ikonu, která se zobrazí pro RemoteApp, popisný název RemoteAppu, který se zobrazuje v klientech Vzdálené plochy, a spuštění RemoteAppu při spuštění (prostřednictvím parametrů příkazového řádku).

Příklady

Příklad 1: Změna popisného názvu RemoteAppu

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

Tento příkaz změní popisný název RemoteAppu na Contoso Web App v2, který se zobrazí koncovým uživatelům v klientech Vzdálené plochy.

Příklad 2: Změna vlastností příkazového řádku remoteappu

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

Tento příkaz změní argumenty příkazového řádku aplikace Internet Explorer tak, aby vždy spouštět "https://webapp.contoso.com".

Parametry

-AppAlias

Jedinečný řetězec vygenerovaný agentem hostitele VP pro každou aplikaci nabídky Start před tím, než ho vrátí agent hostitele. AppAlias je vrácen rutinou Get-RdsStartMenuApp a dá se použít k identifikaci aplikace pro publikování.

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

-AppGroupName

Název skupiny aplikací.

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

-CommandLineSetting

Určuje, jestli aplikace RemoteApp přijímá argumenty příkazového řádku z klienta v době připojení. Tento parametr přijímá tyto hodnoty:

Povolit: Přijímá argumenty příkazového řádku.
DoNotAllow: Nepřijímá argumenty příkazového řádku.
Vyžadovat: Povoluje pouze argumenty příkazového řádku zadané v parametru RequiredCommandLine.

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

-Description

Řetězec o délce 512 znaků, který popisuje tenanta, který pomáhá správcům. Je povolen libovolný znak.

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

-FilePath

Určuje cestu ke spustitelnému souboru aplikace. Může obsahovat jakékoli proměnné prostředí. Tato cesta musí být platná místní cesta na všech hostitelích relací ve fondu hostitelů.

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

-FileVirtualPath

Cesta k souboru spustitelného souboru aplikace. Tato cesta musí být konzistentní napříč všemi hostiteli relací ve fondu hostitelů a umožňuje proměnné prostředí.

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

-FolderName

Poznámka

Tato funkce zatím není podporovaná.

Název složky, ve které bude aplikace seskupena v klientech Vzdálené plochy.

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

-FriendlyName

Řetězec o délce 256 znaků, který je určen pro zobrazení koncovým uživatelům. Je povolen libovolný znak.

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

-HostPoolName

Název fondu hostitelů.

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

-IconIndex

Index ikony ze spustitelného souboru definovaný parametrem IconPath.

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

-IconPath

Určuje cestu k souboru aplikace nebo souboru ICO, který se má zobrazit pro aplikaci. Nesmí obsahovat žádné proměnné prostředí. Tato cesta musí být platná místní cesta na všech hostitelích relací ve fondu hostitelů.

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

-Name

Název vzdálené aplikace RemoteApp.

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

-RequiredCommandLine

Určuje řetězec obsahující argumenty příkazového řádku, které klient může použít při připojení k aplikaci RemoteApp. Pokud zadáte tento parametr, musí mít parametr CommandLineSetting hodnotu Require.

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

-ShowInWebFeed