Set-RdsRemoteApp

Moduł:

Microsoft.RDInfra.RDPowershell Module

Ustawia właściwości aplikacji RemoteApp.

Składnia

RA1 (Domyślna)

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

Opis

Polecenie cmdlet Set-RdsRemoteApp ustawia właściwości funkcji RemoteApp opublikowanej w określonej grupie aplikacji. Za pomocą tego polecenia można zmienić ikonę wyświetlaną dla aplikacji RemoteApp, przyjazną nazwę aplikacji RemoteApp, która pojawia się w klientach pulpitu zdalnego, oraz uruchamianie wykonywania usługi RemoteApp (za pomocą parametrów wiersza polecenia).

Przykłady

Przykład 1: Zmienianie przyjaznej nazwy usługi 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

To polecenie zmienia przyjazną nazwę aplikacji RemoteApp na "Contoso Web App v2", która będzie wyświetlana użytkownikom końcowym w klientach pulpitu zdalnego.

Przykład 2: Zmienianie właściwości wiersza polecenia usługi 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

To polecenie zmienia argumenty wiersza polecenia programu Internet Explorer tak, aby zawsze uruchamiały "https://webapp.contoso.com".

Parametry

-AppAlias

Unikatowy ciąg generowany przez agenta hosta usług pulpitu zdalnego dla każdej aplikacji menu Start przed jego zwróceniem przez agenta hosta. Parametr AppAlias jest zwracany przez polecenie cmdlet Get-RdsStartMenuApp i może służyć do identyfikowania aplikacji do publikowania.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

RA2

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-AppGroupName

Nazwa grupy aplikacji.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	2
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-CommandLineSetting

Określa, czy program RemoteApp akceptuje argumenty wiersza polecenia od klienta w czasie połączenia. Dopuszczalne wartości tego parametru to:

• Zezwalaj: akceptuje argumenty wiersza polecenia.
• DoNotAllow: nie akceptuje argumentów wiersza polecenia.
• Require: zezwala tylko na argumenty wiersza polecenia określone w parametrze RequiredCommandLine.

Właściwości parametru

Typ:	CommandLineSetting
Domyślna wartość:	None
Dopuszczalne wartości:	Allow, DoNotAllow, Require
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Description

Ciąg znaków 512, który opisuje dzierżawę, aby pomóc administratorom. Dowolny znak jest dozwolony.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-FilePath

Określa ścieżkę pliku wykonywalnego dla aplikacji. Może zawierać dowolne zmienne środowiskowe. Ta ścieżka musi być prawidłową ścieżką lokalną na wszystkich hostach sesji w puli hostów.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

RA1

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-FileVirtualPath

Ścieżka do pliku wykonywalnego aplikacji. Ta ścieżka musi być spójna na wszystkich hostach sesji w puli hostów i zezwala na zmienne środowiskowe.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-FolderName

Uwaga / Notatka

Ta funkcja nie jest jeszcze obsługiwana.

Nazwa folderu, w którym aplikacja zostanie zgrupowana w klientach pulpitu zdalnego.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-FriendlyName

256-znakowy ciąg przeznaczony do wyświetlania użytkownikom końcowym. Dowolny znak jest dozwolony.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-HostPoolName

Nazwa puli hostów.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	1
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-IconIndex

Indeks ikony z pliku wykonywalnego, zgodnie z definicją parametru IconPath.

Właściwości parametru

Typ:	Int32
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-IconPath

Określa ścieżkę do aplikacji lub pliku ico, który ma być wyświetlany dla aplikacji. Nie może zawierać żadnych zmiennych środowiskowych. Ta ścieżka musi być prawidłową ścieżką lokalną na wszystkich hostach sesji w puli hostów.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Name

Nazwa aplikacji RemoteApp.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	RemoteAppName

Zestawy parametrów

(All)

Position:	3
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-RequiredCommandLine

Określa ciąg zawierający argumenty wiersza polecenia, których klient może używać w czasie nawiązywania połączenia z programem RemoteApp. Jeśli określisz ten parametr, parametr CommandLineSetting musi mieć wartość Require.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-ShowInWebFeed

Uwaga / Notatka

Ta funkcja nie jest jeszcze obsługiwana.

Określa, czy program RemoteApp ma być wyświetlany w kanale informacyjnym sieci Web. Domyślnie wyświetlane są wszystkie usługi RemoteApps. Uwaga: Dzięki temu administrator może tymczasowo wyłączyć aplikację, a następnie włączyć ją ponownie bez usuwania i ponownego tworzenia niestandardowych informacji o aplikacji.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-TenantName

Nazwa dzierżawy.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	0
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

System.String

Dane wyjściowe

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp