Sdílet prostřednictvím


Set-RdsRemoteApp

Nastaví vlastnosti RemoteAppu.

Syntaxe

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 RemoteAppu 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 zobrazí v klientech Vzdálené plochy, a spuštění RemoteAppu (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 se vždy spustily "https://webapp.contoso.com".

Parametry

-AppAlias

Jedinečný řetězec vygenerovaný agentem hostitele VP pro jednotlivé aplikace nabídky Start, než ho vrátí agent hostitele. Rutina Get-RdsStartMenuApp vrátí AppAlias a dá se použít k identifikaci aplikace pro publikování.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AppGroupName

Název skupiny aplikací

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-CommandLineSetting

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

  • Povolit: Přijímá argumenty příkazového řádku.
  • DoNotAllow: Nepřijímá argumenty příkazového řádku.
  • Vyžadovat: Povolí pouze argumenty příkazového řádku zadané v parametru RequiredCommandLine.
Typ:CommandLineSetting
Přípustné hodnoty:Allow, DoNotAllow, Require
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FilePath

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FileVirtualPath

Cesta k spustitelnému souboru aplikace. Tato cesta musí být konzistentní pro všechny hostitele relací ve fondu hostitelů a povoluje proměnné prostředí.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FolderName

Poznámka

Tato funkce se zatím nepodporuje.

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FriendlyName

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HostPoolName

Název fondu hostitelů.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IconIndex

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

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IconPath

Určuje cestu k souboru aplikace nebo souboru ico, který se má pro aplikaci zobrazit. 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ů.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název RemoteAppu.

Typ:String
Aliasy:RemoteAppName
Position:3
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RequiredCommandLine

Určuje řetězec, který obsahuje argumenty příkazového řádku, které může klient použít v době připojení s programem RemoteApp. Pokud tento parametr zadáte, musí mít parametr CommandLineSetting hodnotu Require.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ShowInWebFeed

Poznámka

Tato funkce se zatím nepodporuje.

Určuje, jestli se má program RemoteApp zobrazit ve webovém informačním kanálu. Ve výchozím nastavení se zobrazí všechny RemoteApps. Poznámka: To umožňuje správci dočasně vypnout aplikaci a pak ji znovu zapnout, aniž by odstranil a znovu vytvořil informace o vlastní aplikaci.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TenantName

Název tenanta.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

System.String

Výstupy

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp