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