Поделиться через

New-RdsRemoteApp

Модуль:
Microsoft.RDInfra.RDPowershell

Добавляет программу RemoteApp в группу приложений.

Синтаксис

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

Описание

Добавляет программу RemoteApp в группу приложений RemoteApp. В результате приложение будет опубликовано. Эта команда завершится ошибкой, если вы попытаетесь опубликовать RemoteApp в группе классических приложений.

Примеры

Пример 1: Опубликуйте приложение RemoteApp, указав псевдоним приложения

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

Эта команда публикует RemoteApp в группе приложений со всеми свойствами, связанными с указанным псевдонимом приложения. Эту команду можно использовать для приложений, перечисленных при выполнении командлета Get-RdsStartMenuApp.

Пример 2: Публикация RemoteApp путем ручного предоставления информации

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

Эта команда публикует RemoteApp в группе приложений с предоставленными свойствами, включая значения по умолчанию для свойств CommandLineSettings и ShowInWebFeed. Эту команду можно использовать для любых приложений, и она является предпочтительным способом публикации RemoteApps, если конкретное приложение не указано в списке при выполнении командлета Get-RdsStartMenuApp.

Параметры

-AppAlias

Уникальная строка, созданная главным агентом удаленных рабочих столов для каждого приложения меню "Пуск", прежде чем она будет возвращена главным агентом. AppAlias возвращается командлетом Get-RdsStartMenuApp и может использоваться для идентификации приложения для публикации. Наличие этого параметра определяет набор параметров AppAlias.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AppGroupName

Имя группы приложений.

Тип:String
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-CommandLineSetting

Указывает, принимает ли программа RemoteApp аргументы командной строки от клиента во время подключения. Допустимые значения для этого параметра:

  • Allow: Принимает аргументы командной строки.
  • DoNotAllow: не принимает аргументы командной строки.
  • Require: Разрешает только аргументы командной строки, указанные в параметре RequiredCommandLine.
Тип:CommandLineSetting
Допустимые значения:Allow, DoNotAllow, Require
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Строка из 512 символов, описывающая RemoteApp в помощь администраторам. Разрешен любой символ.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FilePath

Указывает путь к исполняемому файлу для приложения. Он может включать в себя любые переменные окружения. Этот путь должен быть допустимым локальным путем на всех узлах сеансов в пуле узлов. Наличие этого параметра определяет набор параметров FilePath.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FileVirtualPath

Путь к исполняемому файлу для приложения. Этот путь должен быть согласованным для всех узлов сеансов в пуле узлов и допускать переменные среды.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FolderName

Замечание

Пока такая возможность не поддерживается.

Имя папки, в которую будет сгруппировано приложение в клиентах удаленного рабочего стола.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FriendlyName

256 символьная строка, предназначенная для отображения конечным пользователям. Разрешен любой символ.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-HostPoolName

Имя пула узлов.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-IconIndex

Индекс значка из исполняемого файла, определенный параметром IconPath.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IconPath

Указывает путь к приложению или файлу ico для отображения для приложения. Он может не включать в себя переменные среды. Этот путь должен быть допустимым локальным путем на всех узлах сеансов в пуле узлов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Имя RemoteApp, которое должно быть уникальным в группе приложений. Псевдоним: RemoteAppName.

Тип:String
Aliases:RemoteAppName
Position:3
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RequiredCommandLine

Указывает строку, содержащую аргументы командной строки, которые клиент может использовать во время подключения к программе RemoteApp. Если вы укажете этот параметр, параметр CommandLineSetting должен иметь значение Require.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ShowInWebFeed

Замечание

Пока такая возможность не поддерживается.

Указывает, следует ли отображать программу RemoteApp в веб-канале. По умолчанию отображаются все RemoteApps. Примечание: Это позволяет администратору временно выключить приложение, а затем снова включить его без удаления и повторного создания пользовательской информации о приложении.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TenantName

Имя клиента.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

System.String

Выходные данные

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp