New-RdsRemoteApp
将 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 cmdlet 时列出的应用程序。
示例 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
此命令使用提供的属性(包括 CommandLineSettings 和 ShowInWebFeed 属性的默认值)将 RemoteApp 发布到应用组。 此命令可用于任何应用程序,如果运行 Get-RdsStartMenuApp cmdlet 时未列出特定应用程序,则此命令是发布 RemoteApps 的首选方法。
参数
-AppAlias
RD 主机代理在主机代理返回之前为每个开始菜单应用生成的唯一字符串。 AppAlias 由 Get-RdsStartMenuApp cmdlet 返回,可用于标识要发布的应用。 此参数的存在决定了 AppAlias 参数集。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AppGroupName
应用组的名称。
类型: | String |
Position: | 2 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-CommandLineSetting
指定 RemoteApp 程序是否在连接时接受来自客户端的命令行参数。 此参数的可接受值为:
- 允许:接受命令行参数。
- DoNotAllow:不接受命令行参数。
- 需要:仅允许在 RequiredCommandLine 参数中指定的命令行参数。
类型: | CommandLineSetting |
接受的值: | Allow, DoNotAllow, Require |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
描述 RemoteApp 以帮助管理员的 512 字符串。 允许任何字符。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FilePath
指定应用程序的可执行文件的路径。 它可能包含任何环境变量。 此路径必须是主机池中所有会话主机上的有效本地路径。 此参数的存在决定了 FilePath 参数集。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FileVirtualPath
应用程序的可执行文件的文件路径。 此路径必须在主机池中的所有会话主机之间保持一致,并且允许环境变量。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FolderName
注意
尚不支持此功能。
应用程序将在远程桌面客户端中分组的文件夹的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FriendlyName
一个 256 字符的字符串,用于显示给最终用户。 允许任何字符。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-HostPoolName
主机池的名称。
类型: | String |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-IconIndex
可执行文件中图标的索引,由 IconPath 参数定义。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-IconPath
指定要为应用程序显示的应用程序或 ico 文件的路径。 它可能不包含任何环境变量。 此路径必须是主机池中所有会话主机上的有效本地路径。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
RemoteApp 的名称,该名称在应用组中必须是唯一的。 别名:RemoteAppName。
类型: | String |
别名: | RemoteAppName |
Position: | 3 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-RequiredCommandLine
指定一个字符串,该字符串包含客户端可以在与 RemoteApp 程序连接时使用的命令行参数。 如果指定此参数,CommandLineSetting 参数的值必须为 Require。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ShowInWebFeed
注意
尚不支持此功能。
指定是否在 Web 源中显示 RemoteApp 程序。 默认情况下,将显示所有 RemoteApp。 注意:这允许管理员暂时关闭应用程序,然后重新打开它,而无需删除并重新创建自定义应用信息。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TenantName
租户的名称。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
输入
System.String
输出
Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp