Set-RdsRemoteApp

Modul:

Microsoft.RDInfra.RDPowershell Module

Anger egenskaperna för en RemoteApp.

Syntax

RA1 (Standard)

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

Cmdleten Set-RdsRemoteApp anger egenskaperna för en RemoteApp som publicerats 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ärrskrivbordsklienterna 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ärrskrivbordsklienterna.

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 så att de alltid startar "https://webapp.contoso.com".

Parametrar

-AppAlias

En unik sträng som genereras av värdagenten för fjärrskrivbord för varje app på startmenyn 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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

RA2

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-AppGroupName

Namnet på appgruppen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	2
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-CommandLineSetting

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

Parameteregenskaper

Typ:	CommandLineSetting
Standardvärde:	None
Godkända värden:	Allow, DoNotAllow, Require
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Description

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

RA1

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	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.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FolderName

Anmärkning

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

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FriendlyName

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-HostPoolName

Namnet på värdpoolen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	1
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-IconIndex

Indexet för ikonen från den körbara filen, enligt definitionen i parametern IconPath.

Parameteregenskaper

Typ:	Int32
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-IconPath

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Name

Namnet på RemoteApp.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	RemoteAppName (på engelska)

Parameteruppsättningar

(All)

Position:	3
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-RequiredCommandLine

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

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ShowInWebFeed

Anmärkning

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

Anger om RemoteApp-programmet ska visas i webbfeeden. Som standard visas alla RemoteApps. Detta gör att administratören kan stänga av ett program tillfälligt och sedan aktivera det igen utan att ta bort och återskapa den anpassade appinformationen.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-TenantName

Namnet på hyresgästen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	0
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

System.String

Utdata

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp