Partilhar via


New-RdsRemoteApp

Adiciona um programa RemoteApp a um grupo de aplicações.

Syntax

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

Description

Adiciona um programa RemoteApp a um grupo de aplicações RemoteApp. Isto resulta na publicação da app. Este comando falhará se tentar publicar um RemoteApp num grupo de aplicações de desktop.

Exemplos

Exemplo 1: Publicar um RemoteApp fornecendo o pseudónimo da app

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

Este comando publica um RemoteApp para o grupo de aplicações com todas as propriedades associadas ao pseudónimo da aplicação especificada. Este comando pode ser utilizado para aplicações listadas ao executar o Get-RdsStartMenuApp cmdlet.

Exemplo 2: Publicar um RemoteApp fornecendo manualmente informações

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

Este comando publica um RemoteApp para o grupo de aplicações com as propriedades fornecidas, incluindo valores predefinidos para propriedades CommandLineSettings e ShowInWebFeed. Este comando pode ser utilizado para qualquer aplicação e é a forma preferida de publicar RemoteApps se a aplicação específica não estiver listada na execução do Get-RdsStartMenuApp cmdlet.

Parâmetros

-AppAlias

Uma cadeia única gerada pelo agente anfitrião RD para cada aplicação de menu inicial antes de ser devolvida pelo agente anfitrião. As AppAlias são devolvidas pelo Get-RdsStartMenuApp cmdlet e podem ser usadas para identificar uma aplicação para publicação. A presença deste parâmetro determina o conjunto de parâmetros AppAlias.

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

-AppGroupName

O nome do grupo de aplicações.

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

-CommandLineSetting

Especifica se o programa RemoteApp aceita argumentos de linha de comando do cliente na hora da ligação. Os valores aceitáveis para este parâmetro são:

  • Permitir: Aceita argumentos de linha de comando.
  • DoNotAllow: Não aceita argumentos de linha de comando.
  • Exigir: Permite apenas argumentos de linha de comando especificados no parâmetro RequiredCommandLine.
Type:CommandLineSetting
Accepted values:Allow, DoNotAllow, Require
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Uma cadeia de caracteres 512 que descreve o RemoteApp para ajudar os administradores. Qualquer personagem é permitido.

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

-FilePath

Especifica um caminho para o ficheiro executável para o pedido. Pode incluir quaisquer variáveis ambientais. Este caminho deve ser um caminho local válido em todos os anfitriões da sessão na piscina anfitriã. A presença deste parâmetro determina o conjunto de parâmetros FilePath.

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

-FileVirtualPath

O caminho do ficheiro para o ficheiro executável para o pedido. Este caminho deve ser consistente em todos os anfitriões de sessão na piscina anfitriã e permite variáveis ambientais.

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

-FolderName

Nota

Esta funcionalidade ainda não está suportada.

O nome da pasta onde a aplicação será agrupada nos clientes remote desktop.

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

-FriendlyName

Uma cadeia de caracteres de 256 caracteres destinada a ser exibida aos utilizadores finais. Qualquer personagem é permitido.

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

-HostPoolName

O nome da piscina anfitriã.

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

-IconIndex

O índice do ícone a partir do ficheiro executável, tal como definido pelo parâmetro IconPath.

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

-IconPath

Especifica um caminho para um ficheiro de aplicação ou ico para visualizar para a aplicação. Pode não incluir variáveis ambientais. Este caminho deve ser um caminho local válido em todos os anfitriões da sessão na piscina anfitriã.

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

-Name

O nome do RemoteApp, que deve ser único no grupo de aplicações. Pseudónimo: RemoteAppName.

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

-RequiredCommandLine

Especifica uma cadeia que contém argumentos de linha de comando que o cliente pode usar na hora da ligação com o programa RemoteApp. Se especificar este parâmetro, o parâmetro CommandLineSetting deve ter um valor de Requerimento.

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

-ShowInWebFeed

Nota

Esta funcionalidade ainda não está suportada.

Especifica se deve mostrar o programa RemoteApp no feed da web. Por predefinição, todos os RemoteApps são apresentados. Nota: Isto permite ao administrador desligar uma aplicação temporariamente e depois ligá-la novamente sem eliminar e recriar as informações personalizadas da aplicação.

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

-TenantName

O nome do inquilino.

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

Entradas

System.String

Saídas

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp