Set-RdsRemoteApp

Modul:

Microsoft.RDInfra.RDPowershell Module

Nastaví vlastnosti aplikace RemoteApp.

Syntaxe

RA1 (Výchozí)

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

RA2

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é v určené skupině aplikací. Pomocí tohoto příkazu můžete změnit ikonu, která se zobrazí pro aplikaci RemoteApp, popisný název aplikace RemoteApp, který se zobrazí v klientech vzdálené plochy, a spuštění aplikace RemoteApp při spuštění (pomocí parametrů příkazového řádku).

Příklady

Příklad 1: Změna popisného názvu aplikace 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

Tento příkaz změní popisný název aplikace RemoteApp 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 aplikace 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

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

Parametry

-AppAlias

Jedinečný řetězec vygenerovaný agentem hostitele VP pro každou aplikaci nabídky Start před jeho vrácením agentem hostitele. Rutina Get-RdsStartMenuApp vrací AppAlias a lze ji použít k identifikaci aplikace pro publikování.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

RA2

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AppGroupName

Název skupiny aplikací.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	2
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-CommandLineSetting

Určuje, zda aplikace RemoteApp přijímá argumenty příkazového řádku od klienta v době připojení. Přijatelné hodnoty pro tento parametr jsou:

• Allow: Přijímá argumenty příkazového řádku.
• DoNotAllow: Nepřijímá argumenty příkazového řádku.
• Require: Povoluje pouze argumenty příkazového řádku zadané v parametru RequiredCommandLine.

Vlastnosti parametru

Typ:	CommandLineSetting
Default value:	None
Přípustné hodnoty:	Allow, DoNotAllow, Require
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Description

Řetězec 512 znaků, který popisuje tenanta, který pomáhá správcům. Libovolný znak je povolený.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FilePath

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

RA1

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FileVirtualPath

Cesta k souboru ke spustitelnému souboru aplikace. Tato cesta musí být konzistentní u všech hostitelů relací ve fondu hostitelů a umožňuje proměnné prostředí.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FolderName

Poznámka:

Tato funkce se zatím nepodporuje.

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FriendlyName

Řetězec s 256 znaky, který je určený pro zobrazení koncovým uživatelům. Libovolný znak je povolený.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-HostPoolName

Název fondu hostitelů.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-IconIndex

Index ikony ze spustitelného souboru, jak je definován parametrem IconPath.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IconPath

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Název aplikace RemoteApp.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Název vzdálené aplikace

Sady parametrů

(All)

Position:	3
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RequiredCommandLine

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ShowInWebFeed

Poznámka:

Tato funkce se zatím nepodporuje.

Určuje, zda se má aplikace RemoteApp zobrazit ve webovém kanálu. Ve výchozím nastavení se zobrazují všechny aplikace RemoteApp. Poznámka: To umožňuje správci dočasně vypnout aplikaci a poté ji znovu zapnout, aniž by došlo k odstranění a opětovnému vytvoření vlastních informací o aplikaci.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-TenantName

Název tenanta.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

System.String

Výstupy

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp