New-RdsRemoteApp

参考

模块:: WindowsVirtualDesktopPowershell

将 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 参数集。

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

-AppGroupName

应用组的名称。

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

-CommandLineSetting

指定 RemoteApp 程序是否在连接时接受来自客户端的命令行参数。此参数的可接受值为：

允许：接受命令行参数。
DoNotAllow：不接受命令行参数。
需要：仅允许在 RequiredCommandLine 参数中指定的命令行参数。

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

-Description

描述 RemoteApp 以帮助管理员的 512 字符串。允许任何字符。

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

-FilePath

指定应用程序的可执行文件的路径。它可能包含任何环境变量。此路径必须是主机池中所有会话主机上的有效本地路径。此参数的存在决定了 FilePath 参数集。

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

-FileVirtualPath

应用程序的可执行文件的文件路径。此路径必须在主机池中的所有会话主机之间保持一致，并且允许环境变量。

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

-FolderName

注意

尚不支持此功能。

应用程序将在远程桌面客户端中分组的文件夹的名称。

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

-FriendlyName

一个 256 字符的字符串，用于显示给最终用户。允许任何字符。

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

-HostPoolName

主机池的名称。

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

-IconIndex

可执行文件中图标的索引，由 IconPath 参数定义。

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

-IconPath

指定要为应用程序显示的应用程序或 ico 文件的路径。它可能不包含任何环境变量。此路径必须是主机池中所有会话主机上的有效本地路径。

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

-Name

RemoteApp 的名称，该名称在应用组中必须是唯一的。别名：RemoteAppName。

Type:	String
Aliases:	RemoteAppName
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RequiredCommandLine

指定一个字符串，该字符串包含客户端可以在与 RemoteApp 程序连接时使用的命令行参数。如果指定此参数，CommandLineSetting 参数的值必须为 Require。

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

-ShowInWebFeed

注意