New-RdsRemoteApp

Odwołanie

Moduł:: WindowsVirtualDesktopPowershell

Dodaje program RemoteApp do grupy aplikacji.

Składnia

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

Opis

Dodaje program RemoteApp do grupy aplikacji RemoteApp. Spowoduje to opublikowanie aplikacji. To polecenie zakończy się niepowodzeniem, jeśli spróbujesz opublikować usługę RemoteApp w grupie aplikacji klasycznych.

Przykłady

Przykład 1: Publikowanie usługi RemoteApp przez podanie aliasu aplikacji

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

To polecenie publikuje usługę RemoteApp w grupie aplikacji ze wszystkimi właściwościami skojarzonymi z określonym aliasem aplikacji. Tego polecenia można użyć w przypadku aplikacji wymienionych podczas uruchamiania polecenia cmdlet Get-RdsStartMenuApp.

Przykład 2: Publikowanie usługi RemoteApp przez ręczne podawanie informacji

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

To polecenie publikuje usługę RemoteApp w grupie aplikacji z podanymi właściwościami, w tym wartościami domyślnymi właściwości CommandLineSettings i ShowInWebFeed. To polecenie może być używane dla dowolnych aplikacji i jest preferowanym sposobem publikowania usługi RemoteApps, jeśli określona aplikacja nie jest wymieniona podczas uruchamiania polecenia cmdlet Get-RdsStartMenuApp.

Parametry

-AppAlias

Unikatowy ciąg generowany 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. Obecność tego parametru określa zestaw parametrów AppAlias.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppGroupName

Nazwa grupy aplikacji.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CommandLineSetting

Określa, czy program RemoteApp akceptuje argumenty wiersza polecenia z klienta w czasie połączenia. Dopuszczalne wartości dla 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.

Type:	CommandLineSetting
Accepted values:	Allow, DoNotAllow, Require
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Ciąg znaków 512, który opisuje usługę RemoteApp, aby pomóc administratorom. Dowolny znak jest dozwolony.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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. Obecność tego parametru określa zestaw parametrów FilePath.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FolderName

Uwaga

Ta funkcja nie jest jeszcze obsługiwana.

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FriendlyName

Ciąg 256 znaków przeznaczony do wyświetlania użytkownikom końcowym. Dowolny znak jest dozwolony.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostPoolName

Nazwa puli hostów.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IconIndex

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nazwa usługi RemoteApp, która musi być unikatowa w grupie aplikacji. Alias: RemoteAppName.

Type:	String
Aliases:	RemoteAppName
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShowInWebFeed