Partilhar via

Set-RdsRemoteApp

  • Referência
Módulo:
WindowsVirtualDesktopPowershell

Define as propriedades para um RemoteApp.

Sintaxe

Set-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>]
Set-RdsRemoteApp
   [-TenantName] <String>
   [-HostPoolName] <String>
   [-AppGroupName] <String>
   [-Name] <String>
   [-CommandLineSetting <CommandLineSetting>]
   [-Description <String>]
   [-FileVirtualPath <String>]
   [-FolderName <String>]
   [-FriendlyName <String>]
   [-IconIndex <Int32>]
   [-IconPath <String>]
   [-RequiredCommandLine <String>]
   [-ShowInWebFeed]
   [-AppAlias <String>]
   [<CommonParameters>]

Description

O Set-RdsRemoteApp cmdlet define as propriedades de um RemoteApp publicado no grupo de aplicações especificado. Com este comando, pode alterar o ícone que aparece para o RemoteApp, o nome amigável do RemoteApp que aparece nos clientes Remote Desktop e a execução inicial do RemoteApp (através de parâmetros da linha de comando).

Exemplos

Exemplo 1: Alterar o nome amigável do RemoteApp

PS C:\> Set-RdsRemoteApp -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -FriendlyName "Contoso Web App v2"

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 v2
IconIndex           : 0
IconPath            : C:\Program Files\internet explorer\iexplore.exe
RequiredCommandLine :
ShowInWebFeed       : True

Este comando altera o nome amigável do RemoteApp para "Contoso Web App v2" que aparecerá para os utilizadores finais nos clientes Remote Desktop.

Exemplo 2: Alterar as propriedades da linha de comando do RemoteApp

PS C:\> Set-RdsRemoteApp -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -CommandLineSetting Require -RequiredCommandLine "https://webapp.contoso.com"

TenantGroupName     : Default Tenant Group
TenantName          : contoso
HostPoolName        : contosoHostPool
AppGroupName        : webApps
RemoteAppName       : internetExplorerContosoWebApp
FilePath            : C:\Program Files\internet explorer\iexplore.exe
AppAlias            :
CommandLineSetting  : Require
Description         :
FriendlyName        : Contoso Web App v2
IconIndex           : 0
IconPath            : C:\Program Files\internet explorer\iexplore.exe
RequiredCommandLine : https://webapp.contoso.com
ShowInWebFeed       : True

Este comando altera os argumentos da linha de comando do Internet Explorer para sempre lançar "https://webapp.contoso.com".

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.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppGroupName

O nome do grupo de aplicações.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.
Tipo:CommandLineSetting
Valores aceites:Allow, DoNotAllow, Require
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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ã.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FolderName

Nota

Esta funcionalidade ainda não está suportada.

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FriendlyName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HostPoolName

O nome da piscina anfitriã.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-IconIndex

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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ã.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

O nome do RemoteApp.

Tipo:String
Aliases:RemoteAppName
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TenantName

O nome do inquilino.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

System.String

Saídas

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp