Udostępnij za pośrednictwem


Set-RdsRemoteApp

Ustawia właściwości usługi RemoteApp.

Składnia

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

Opis

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

Przykłady

Przykład 1. Zmiana 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ę usługi RemoteApp na "Contoso Web App v2", która będzie widoczna dla użytkowników końcowych na 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, aby zawsze uruchamiać polecenie "https://webapp.contoso.com".

Parametry

-AppAlias

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AppGroupName

Nazwa grupy aplikacji.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.
  • Wymagaj: zezwala tylko na argumenty wiersza polecenia określone w parametrze RequiredCommandLine.
Typ:CommandLineSetting
Dopuszczalne wartości:Allow, DoNotAllow, Require
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FileVirtualPath

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FolderName

Nuta

Ta funkcja nie jest jeszcze obsługiwana.

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FriendlyName

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HostPoolName

Nazwa puli hostów.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-IconIndex

Indeks ikony z pliku wykonywalnego zdefiniowany przez parametr IconPath.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IconPath

Określa ścieżkę do aplikacji lub pliku ico do wyświetlenia dla aplikacji. Może nie zawierać żadnych zmiennych środowiskowych. Ta ścieżka musi być prawidłową ścieżką lokalną na wszystkich hostach sesji w puli hostów.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa usługi RemoteApp.

Typ:String
Aliasy:RemoteAppName
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RequiredCommandLine

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ShowInWebFeed

Nuta

Ta funkcja nie jest jeszcze obsługiwana.

Określa, czy program RemoteApp ma być wyświetlany w internetowym kanale informacyjnym. Domyślnie są wyświetlane 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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TenantName

Nazwa dzierżawy.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

System.String

Dane wyjściowe

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp