New-RdsRemoteApp

Reference

Modul:: WindowsVirtualDesktopPowershell

Přidá do skupiny aplikací program RemoteApp.

Syntax

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

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

Přidá program RemoteApp do skupiny aplikací RemoteApp. Výsledkem je publikování aplikace. Tento příkaz se nezdaří, pokud se pokusíte publikovat RemoteApp do skupiny desktopových aplikací.

Příklady

Příklad 1: Publikování RemoteAppu poskytnutím aliasu aplikace

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

Tento příkaz publikuje RemoteApp do skupiny aplikací se všemi vlastnostmi přidruženými k zadanému aliasu aplikace. Tento příkaz se dá použít pro aplikace, které jsou uvedené při spuštění rutiny Get-RdsStartMenuApp.

Příklad 2: Publikování RemoteAppu ručním poskytnutím informací

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

Tento příkaz publikuje RemoteApp do skupiny aplikací se zadanými vlastnostmi, včetně výchozích hodnot vlastností CommandLineSettings a ShowInWebFeed. Tento příkaz lze použít pro všechny aplikace a je upřednostňovaným způsobem publikování RemoteApps, pokud konkrétní aplikace není uvedená při spuštění rutiny Get-RdsStartMenuApp.

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í. Přítomnost tohoto parametru určuje sadu parametrů AppAlias.

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 RemoteApp pro pomoc 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ů. Přítomnost tohoto parametru určuje sadu parametrů FilePath.

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 RemoteAppu, který musí být ve skupině aplikací jedinečný. Alias: RemoteAppName.

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