New-RdsRemoteApp

Módulo:
Microsoft.RDInfra.RDPowershell Module

Agrega un programa RemoteApp a un grupo de aplicaciones.

Sintaxis

RA1 (Es el valor predeterminado). 

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

RA2 

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

Agrega un programa RemoteApp a un grupo de aplicaciones RemoteApp. Esto da como resultado la publicación de la aplicación. Se producirá un error en este comando si intenta publicar una RemoteApp en un grupo de aplicaciones de escritorio.

Ejemplos

Ejemplo 1: Publicación de una RemoteApp proporcionando el alias de la aplicación

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 un RemoteApp en el grupo de aplicaciones con todas las propiedades asociadas al alias de aplicación especificado. Este comando se puede usar para las aplicaciones que se enumeran al ejecutar el cmdlet Get-RdsStartMenuApp.

Ejemplo 2: Publicación de una RemoteApp proporcionando información manualmente

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 un RemoteApp en el grupo de aplicaciones con las propiedades proporcionadas, incluidos los valores predeterminados para las propiedades CommandLineSettings y ShowInWebFeed. Este comando se puede usar para cualquier aplicación y es la manera preferida de publicar RemoteApps si la aplicación específica no aparece en la lista al ejecutar el cmdlet Get-RdsStartMenuApp.

Parámetros

-AppAlias

Una cadena única generada por el agente de host de Escritorio remoto para cada aplicación del menú de inicio antes de que el agente de host la devuelva. El cmdlet Get-RdsStartMenuApp devuelve AppAlias y se puede usar para identificar una aplicación para su publicación. La presencia de este parámetro determina el conjunto de parámetros AppAlias.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RA2
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AppGroupName

Nombre del grupo de aplicaciones.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-CommandLineSetting

Especifica si el programa RemoteApp acepta argumentos de línea de comandos del cliente en el momento de la conexión. Los valores aceptables para este parámetro son:

  • Permitir: acepta argumentos de línea de comandos.
  • DoNotAllow: no acepta argumentos de línea de comandos.
  • Require: solo permite los argumentos de la línea de comandos especificados en el parámetro RequiredCommandLine.

Propiedades del parámetro

Tipo:CommandLineSetting
Valor predeterminado:None
Valores aceptados:Allow, DoNotAllow, Require
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

Una cadena de 512 caracteres que describe RemoteApp para ayudar a los administradores. Se permite cualquier carácter.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FilePath

Especifica una ruta de acceso para el archivo ejecutable de la aplicación. Puede incluir cualquier variable de entorno. Esta ruta de acceso debe ser una ruta de acceso local válida en todos los hosts de sesión del grupo de hosts. La presencia de este parámetro determina el conjunto de parámetros FilePath.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RA1
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FileVirtualPath

Ruta de acceso del archivo al archivo ejecutable de la aplicación. Esta ruta debe ser coherente en todos los hosts de sesión del grupo de hosts y permite variables de entorno.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FolderName

Nota:

El motivo es que aún no se admite.

Nombre de la carpeta en la que se agrupará la aplicación en los clientes de Escritorio remoto.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FriendlyName

Cadena de 256 caracteres diseñada para mostrar a los usuarios finales. Se permite cualquier carácter.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HostPoolName

Nombre del grupo de hosts.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IconIndex

Índice del icono del archivo ejecutable, tal como se define en el parámetro IconPath.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IconPath

Especifica una ruta de acceso a una aplicación o archivo ico que se va a mostrar para la aplicación. No puede incluir ninguna variable de entorno. Esta ruta de acceso debe ser una ruta de acceso local válida en todos los hosts de sesión del grupo de hosts.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

El nombre de RemoteApp, que debe ser único en el grupo de aplicaciones. Alias: RemoteAppName.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:RemoteAppName

Conjuntos de parámetros

(All)
Posición:3
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-RequiredCommandLine

Especifica una cadena que contiene argumentos de línea de comandos que el cliente puede usar en tiempo de conexión con el programa RemoteApp. Si especifica este parámetro, el parámetro CommandLineSetting debe tener un valor de Require.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShowInWebFeed

Nota:

El motivo es que aún no se admite.

Especifica si se muestra el programa RemoteApp en la fuente web. De forma predeterminada, se muestran todas las RemoteApps. Nota: Esto permite al administrador desactivar una aplicación temporalmente y luego volver a activarla sin eliminar y volver a crear la información personalizada de la aplicación.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TenantName

El nombre del inquilino.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

System.String

Salidas

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp